> ## 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. # Advanced Commands > Payment intents and Purchasing Power Parity pricing tools. 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. ```bash theme={null} zendfi intents create [options] ``` #### Options | Flag | Description | Default | | ----------------------- | ----------------------- | ------------------ | | `--amount ` | Amount in USD | Interactive prompt | | `--currency ` | Currency code | `USD` | | `--description ` | Payment description | Interactive prompt | | `--capture ` | `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 ```bash theme={null} $ 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 ``` The client secret is used on the frontend to confirm the payment without exposing your API key. Pass it to your checkout page or SDK instance. *** ### intents list List all payment intents for your account. ```bash theme={null} zendfi intents list ``` 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. ```bash theme={null} zendfi intents get ``` #### Arguments | Argument | Description | Required | | ----------- | ---------------------------------------------- | -------- | | `intent-id` | The payment intent ID (e.g., `pi_test_abc123`) | Yes | Shows the full intent details including status, amount, capture method, associated payment ID (if confirmed), and timestamps. *** ### intents confirm Confirm a payment intent with a customer's wallet address. ```bash theme={null} zendfi intents confirm [options] ``` #### Arguments | Argument | Description | Required | | ----------- | -------------------------------- | -------- | | `intent-id` | The payment intent ID to confirm | Yes | #### Options | Flag | Description | Default | | -------------------------- | -------------------------------- | ------------------ | | `--wallet
` | Customer's Solana wallet address | Interactive prompt | | `--client-secret ` | Client secret for verification | Interactive prompt | #### Example ```bash theme={null} $ 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. ```bash theme={null} zendfi intents cancel ``` #### Arguments | Argument | Description | Required | | ----------- | ------------------------------- | -------- | | `intent-id` | The payment intent ID to cancel | Yes | ```bash theme={null} $ zendfi intents cancel pi_test_abc123 ✓ Payment intent canceled ``` ### Intent Lifecycle ```mermaid theme={null} stateDiagram-v2 [*] --> requires_payment: intents create requires_payment --> processing: intents confirm requires_payment --> canceled: intents cancel processing --> succeeded: Payment completes processing --> failed: Payment fails succeeded --> [*] failed --> [*] canceled --> [*] ``` *** ## 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. ```bash theme={null} zendfi ppp check [options] ``` #### Arguments | Argument | Description | Required | | --------- | -------------------------------------------------- | -------- | | `country` | 2-letter ISO country code (e.g., `BR`, `IN`, `NG`) | Yes | #### Options | Flag | Description | Default | | ----------------- | --------------------------------------------- | ------- | | `--price ` | Calculate the localized price for this amount | -- | #### Example ```bash theme={null} $ 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 ``` Without `--price`, the command shows the factor and an example calculation for \$100. *** ### ppp factors List PPP factors for all supported countries. ```bash theme={null} zendfi ppp factors [options] ``` #### Options | Flag | Description | Default | | --------------- | ------------------------------- | ------------------------ | | `--sort ` | Sort by `discount` or `country` | `country` (alphabetical) | #### Example ```bash theme={null} $ 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. ```bash theme={null} zendfi ppp calculate --price --country ``` Both `--price` and `--country` are required. #### Options | Flag | Description | Required | | --------------------- | ------------------------- | -------- | | `--price ` | Original price in USD | Yes | | `--country ` | 2-letter ISO country code | Yes | #### Example ```bash theme={null} $ 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% | Use `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](/api-reference/overview) 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.