Documentation Index
Fetch the complete documentation index at: https://docs.zendfi.tech/llms.txt
Use this file to discover all available pages before exploring further.
These commands cover two advanced features: the two-phase payment intent flow and international pricing with Purchasing Power Parity.
Payment Intents
Payment intents give you a two-phase payment flow — create an intent, then confirm it separately. This is useful for AI agent transactions, cart-based checkouts, and any flow where the payment amount is known before the customer’s wallet is available.
intents create
Create a new payment intent.
zendfi intents create [options]
Options
| Flag | Description | Default |
|---|
--amount <amount> | Amount in USD | Interactive prompt |
--currency <currency> | Currency code | USD |
--description <text> | Payment description | Interactive prompt |
--capture <method> | automatic or manual | Interactive prompt |
Capture Methods
| Method | Behavior |
|---|
automatic | Captures the payment immediately when confirmed |
manual | Authorizes only; you capture later via the API |
Example
$ zendfi intents create --amount 99.99
Create Payment Intent
? Description (optional): Annual subscription
? Capture method: Automatic - Capture immediately on confirm
✓ Payment intent created!
Intent Details:
ID: pi_test_abc123
Amount: $99.99
Status: REQUIRES PAYMENT
Capture: automatic
Expires: 12/16/2024, 2:30:00 PM
Client Secret (for frontend):
pi_test_abc123_secret_xyz789
Confirm with:
zendfi intents confirm pi_test_abc123 --wallet <customer_wallet>
intents list
List all payment intents for your account.
Displays each intent with its ID, amount, status, and creation date in a formatted table.
intents get
Get detailed information about a specific payment intent.
zendfi intents get <intent-id>
Arguments
| Argument | Description | Required |
|---|
intent-id | The payment intent ID (e.g., pi_test_abc123) | Yes |
intents confirm
Confirm a payment intent with a customer’s wallet address.
zendfi intents confirm <intent-id> [options]
Arguments
| Argument | Description | Required |
|---|
intent-id | The payment intent ID to confirm | Yes |
Options
| Flag | Description | Default |
|---|
--wallet <address> | Customer’s Solana wallet address | Interactive prompt |
--client-secret <secret> | Client secret for verification | Interactive prompt |
Example
$ zendfi intents confirm pi_test_abc123 --wallet 7xKX...9mRq
✓ Payment intent confirmed!
Status: PROCESSING
Payment ID: pay_test_def456
intents cancel
Cancel a payment intent that has not yet been confirmed.
zendfi intents cancel <intent-id>
Arguments
| Argument | Description | Required |
|---|
intent-id | The payment intent ID to cancel | Yes |
$ zendfi intents cancel pi_test_abc123
✓ Payment intent canceled
Intent Lifecycle
PPP Pricing
Purchasing Power Parity (PPP) lets you offer fair, localized pricing based on a customer’s country. The CLI provides tools to look up PPP factors, list all supported countries, and calculate adjusted prices.
ppp check
Look up the PPP factor for a specific country.
zendfi ppp check <country> [options]
Arguments
| Argument | Description | Required |
|---|
country | 2-letter ISO country code (e.g., BR, IN, NG) | Yes |
Options
| Flag | Description | Default |
|---|
--price <price> | Calculate the localized price for this amount | — |
Example
$ zendfi ppp check BR --price 99.99
PPP Factor Lookup
✓ PPP factor loaded!
Brazil (BR)
PPP Factor: 0.35
Discount: 65%
Local Currency: BRL
Price Calculation:
Original: $99.99
Localized: $35.00
Savings: $64.99
--price, the command shows the factor and an example calculation for $100.
ppp factors
List PPP factors for all supported countries.
zendfi ppp factors [options]
Options
| Flag | Description | Default |
|---|
--sort <sort> | Sort by discount or country | country (alphabetical) |
Example
$ zendfi ppp factors --sort discount
PPP Factors - All Countries
✓ Loaded 45 countries
Country Factor Discount $100 →
─────────────────────────────────────────────────
Egypt 0.15 85% $15
Pakistan 0.22 78% $22
India 0.25 75% $25
Nigeria 0.28 72% $28
Vietnam 0.30 70% $30
...
ppp calculate
Calculate a localized price for a specific country.
zendfi ppp calculate --price <price> --country <country>
--price and --country are required.
Options
| Flag | Description | Required |
|---|
--price <price> | Original price in USD | Yes |
--country <country> | 2-letter ISO country code | Yes |
Example
$ zendfi ppp calculate --price 49.99 --country IN
PPP Price Calculator
✓ Price calculated!
India
┌─────────────────────────────────────┐
│ Original Price: $49.99 │
│ PPP Factor: 0.25 │
│─────────────────────────────────────│
│ Localized Price: $12.50 │
│ Customer Saves: $37.49 │
└─────────────────────────────────────┘
Discount: 75% off for India customers
Supported Countries
The PPP system covers 45+ countries across all major regions. Some notable flags:
| Code | Country | Typical Discount Range |
|---|
| AR | Argentina | 60-70% |
| BR | Brazil | 60-65% |
| EG | Egypt | 80-85% |
| IN | India | 70-75% |
| MX | Mexico | 40-50% |
| NG | Nigeria | 70-75% |
| PK | Pakistan | 75-80% |
| PH | Philippines | 55-65% |
| TR | Turkey | 55-65% |
| VN | Vietnam | 65-70% |
zendfi ppp factors for the complete, up-to-date list.
Use Cases
SaaS pricing pages: Run zendfi ppp check for your target markets during planning to set tier-specific pricing.
Dynamic checkout: Use the PPP API endpoint server-side to adjust prices at checkout based on the customer’s IP-derived country code.
Market analysis: Run zendfi ppp factors --sort discount to identify markets where aggressive pricing could drive adoption.
