Async Card Recurring Charges

Async Card Recurring Charges is a Chile-exclusive service that registers a customer's card for recurring charges through Transbank's Webpay portal. The customer is redirected to Webpay to authenticate and authorize the card registration — after that, you can charge the registered card on a schedule or on demand using the standard One-Click endpoints.

Chile only 🇨🇱

This service is available exclusively in Chile. It requires an active Transbank/Webpay integration enabled on your Kushki account.

How it works

Request an async recurring charge token

Call POST /subscriptions/v1/card-async/tokens with the currency, email, and the URL to return the customer to after registration.

{
  "currency": "CLP",
  "email": "user@example.com",
  "callbackUrl": "https://yoursite.com/subscription/return"
}

Returns a one-time token valid for 30 minutes.

⚠️ PCI note: You may optionally include cardNumber directly in this request, but only if your backend is PCI DSS compliant.

Init the async recurring charge

Call POST /subscriptions/v1/card-async/init with the token, plan details, amount, and billing start date. The response returns a redirectUrl and subscriptionId.

{
  "token": "AbCDef123456Z7Ghi8901234jkLMNopQ",
  "planName": "Plan Mensual",
  "periodicity": "monthly",
  "startDate": "2026-06-01",
  "amount": {
    "subtotalIva": 0,
    "subtotalIva0": 10000,
    "iva": 0,
    "ice": 0,
    "currency": "CLP"
  },
  "contactDetails": {
    "documentType": "RUT",
    "documentNumber": "12345678-9",
    "firstName": "Catalina",
    "lastName": "Fuentes",
    "email": "user@example.com",
    "phoneNumber": "+56912345678"
  },
  "language": "es",
  "fullResponse": "v2"
}

Response:

{
  "subscriptionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "redirectUrl": "https://webpay.transbank.cl/..."
}

💡 Store the subscriptionId — you need it for all future charges, authorizations, and management operations.

Customer authenticates on Webpay

Redirect the customer to the redirectUrl. They authenticate and authorize the card registration on Transbank's portal, then are redirected back to your callbackUrl.

Subscription is active — charge the card

Once the customer returns, the subscription is active. Use the standard One-Click endpoints to manage and charge it:

POST /subscriptions/v1/card/{subscriptionId} — on-demand charge

GET /subscriptions/v1/card/search/{subscriptionId} — get subscription info

PATCH /subscriptions/v1/card/{subscriptionId} — update plan

DELETE /subscriptions/v1/card/{subscriptionId} — cancel

Scheduled recurring charges are processed automatically according to periodicity and startDate.

Reserve funds before capture

For flows where you want to reserve funds before committing to a charge on an existing subscription.

7-day capture limit

There is a maximum of 7 calendar days to capture after an authorization. After that, Transbank automatically releases the reserved funds.

Authorize

POST /subscriptions/v1/card/{subscriptionId}/authorize — Reserves funds on the registered card. No Webpay redirect needed — the card is already on file.

{
  "amount": {
    "subtotalIva": 0,
    "subtotalIva0": 10000,
    "iva": 0,
    "ice": 0,
    "currency": "CLP"
  },
  "name": "Catalina",
  "lastName": "Fuentes",
  "email": "user@example.com",
  "fullResponse": "v2"
}

Returns a ticketNumber.

Capture

POST /subscriptions/v1/card/{subscriptionId}/capture — Capture the reserved amount within 7 days.

{
  "ticketNumber": "319228478889680318",
  "amount": {
    "subtotalIva": 0,
    "subtotalIva0": 10000,
    "iva": 0,
    "ice": 0,
    "currency": "CLP"
  },
  "fullResponse": "v2"
}

Currency

Currency	Code	Notes
Chilean Peso	`CLP`	Integer amounts only — no decimal places
Unidad de Fomento	`UF`	Indexed currency unit

Periodicity options

Value	Description
`daily`	Every 1 day
`weekly`	Every 7 days
`biweekly`	Every 15 days
`monthly`	Every 30 days
`threefortnights`	Every six weeks (42 days)
`bimonthly`	Every 60 days
`quarterly`	Every 90 days
`fourmonths`	Every 120 days
`halfYearly`	Every 180 days
`yearly`	Every 360 days
`custom`	Custom recurring interval

Retry logic

If a scheduled charge is rejected, Kushki retries automatically. Default: 3 retries over 3 consecutive days. Configure with retryConfiguration:

{
  "retryConfiguration": {
    "retryType": "fixed",
    "value": [5, 15, 25]
  }
}

`retryType`	Behavior
`scheduled`	Retries every N days for the entire billing period
`fixed`	Retries only on specific days of the month

Difference from standard One-Click

	Async Card Recurring	Standard One-Click
Registration	Customer redirected to Transbank/Webpay	Token-based, no redirect
Processor	Transbank (Webpay)	Direct card network
Authorize/Capture	No redirect — uses saved card	No redirect — uses saved card
Chile only	✅ Yes	✅ Yes (via Webpay integration)

Authentication

Using the API

🟢 Production

🧪 Sandbox (UAT)

https://api.kushkipagos.com/

Available Endpoints

Request Async Recurring Charge Token

Request a token to start the card registration flow. Valid for 30 minutes.

Init Async Recurring Charge

Initialize the subscription. Returns a Webpay redirect URL and a subscriptionId.

Authorize payments

Reserve funds on an already-registered card — no Webpay redirect needed.

Capture an authorized payment

Capture a previously authorized amount on the subscription.

Got a suggestion on this documentation? Contact us.

How it works#

Reserve funds before capture#

Currency#

Periodicity options#

Retry logic#

Difference from standard One-Click#

Authentication#

Using the API#

Available Endpoints#

How it works

Reserve funds before capture

Currency

Periodicity options

Retry logic

Difference from standard One-Click

Authentication

Using the API

Available Endpoints