Skip to main content
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

FlagDescriptionDefault
--amount <amount>Amount in USDInteractive prompt
--currency <currency>Currency codeUSD
--description <text>Payment descriptionInteractive prompt
--capture <method>automatic or manualInteractive prompt

​
Capture Methods

MethodBehavior
automaticCaptures the payment immediately when confirmed
manualAuthorizes 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>
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. 
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. 
zendfi intents get <intent-id>

​
Arguments

ArgumentDescriptionRequired
intent-idThe 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. 
zendfi intents confirm <intent-id> [options]

​
Arguments

ArgumentDescriptionRequired
intent-idThe payment intent ID to confirmYes

​
Options

FlagDescriptionDefault
--wallet <address>Customer’s Solana wallet addressInteractive prompt
--client-secret <secret>Client secret for verificationInteractive 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

ArgumentDescriptionRequired
intent-idThe payment intent ID to cancelYes
$ 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

ArgumentDescriptionRequired
country2-letter ISO country code (e.g., BR, IN, NG)Yes

​
Options

FlagDescriptionDefault
--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
Without --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

FlagDescriptionDefault
--sort <sort>Sort by discount or countrycountry (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>
Both --price and --country are required.

​
Options

FlagDescriptionRequired
--price <price>Original price in USDYes
--country <country>2-letter ISO country codeYes

​
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:
CodeCountryTypical Discount Range
ARArgentina60-70%
BRBrazil60-65%
EGEgypt80-85%
INIndia70-75%
MXMexico40-50%
NGNigeria70-75%
PKPakistan75-80%
PHPhilippines55-65%
TRTurkey55-65%
VNVietnam65-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 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.