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