Create the first alternative payment order, then set how stored credentials are used later. Method support for each payment_type is in the tables below.

API Init payment API v1 endpoint initiates a payment using an alternative payment method, creates the order, and prepares the transaction so the customer can proceed with the payment process.

Init future payment

Billing logic defines who initiates a payment and whether the customer is present.

Billing logic payment_type
One-time one-time 1-click recurring unscheduled
1-click one-time 1-click recurring unscheduled
Recurring one-time 1-click recurring unscheduled
Unscheduled one-time 1-click recurring unscheduled

Payment type is the API value in future_usage.payment_type . The value can differ from the billing-logic label. unscheduled is a superset of Unscheduled, Recurring, and 1-click when the provider does not restrict token use. When a method supports both a native type and unscheduled , send the native type.

Method payment_type
Alipay alipay one-time 1-click recurring unscheduled
Bizum bizum one-time 1-click recurring unscheduled
BLIK One-time blik one-time 1-click recurring unscheduled
BLIK Pay Later blik-bnpl one-time 1-click recurring unscheduled
BLIK Recurring blik one-time 1-click recurring unscheduled
Cash App Pay cashapp one-time 1-click recurring unscheduled
GCash gcash one-time 1-click recurring unscheduled
Klarna klarna-network one-time 1-click recurring unscheduled
MB WAY mbway one-time 1-click recurring unscheduled
MobilePay mobilepay one-time 1-click recurring unscheduled
Multibanco multibanco one-time 1-click recurring unscheduled
Pix Automático pix-automatico one-time 1-click recurring unscheduled
UPI Collect upi one-time 1-click recurring unscheduled
UPI Intent upi one-time 1-click recurring unscheduled
WeChat wechatpay one-time 1-click recurring unscheduled
API Init payment API v1 , create page API v1 , create link API v1 or init payment form Guide with future_usage object
Use this flow to define intent for subsequent use of the customer's payment credentials, token-based future charges.
It ensures compliance with scheme rules, reduces declines on future payments, and improves success rates. future_usage object Required

Description

Defines the usage of stored payment credentials.

Should be provided either future_usage or product_id.

Example

{
  "future_usage": {
    "payment_type": "recurring"
  }
}
payment_type string Required

Description

Type of the token usage scenario.

  • one-time no token created, for one-off use. Maps only to One-time billing logic.
  • 1-click token for future customer-initiated payments without re-entering details. Maps only to 1-click billing logic.
  • recurring token for fixed scheduled merchant-initiated charges, for subscriptions. Maps only to Recurring billing logic.
  • unscheduled token for unscheduled or variable merchant-initiated charges, for auto-top-up. Maps to Unscheduled, Recurring, and 1-click when the provider does not restrict token use.

Init future payment calculation

Send at least payment_type or product_id. If only product_id is sent, the intent is the product type. Compatible requests use payment_type when it is present.

These requests succeed.

payment_type Product Intent
— one-time one-time
— recurring recurring
one-time No product one-time
one-time one-time one-time
1-click No product 1-click
1-click one-time 1-click
recurring No product recurring
recurring recurring recurring
unscheduled No product unscheduled
unscheduled one-time unscheduled
unscheduled recurring unscheduled

These requests are declined.

payment_type Product Intent
— No product DECLINED
one-time recurring DECLINED
1-click recurring DECLINED
recurring one-time DECLINED