Create a recurring charge
POST
/subscriptions/v1/card
token provided by Kushki which represents the customer's credit card.Payment Execution
startDate.Retries
startDate. For example, for a monthly subscription with start date: 10-01-2021, with a rejection on 10-02-2021, payment will be retried until 13-02-2021, 3 times each day, for a total of 9 payment attempts.Customize retry logic
retryConfiguration object as follows:1.
retryType:"schedule". If you choose schedule, you can specify in the value field you can specify in value how often the collection will be reattempted.In the next example, the collection will be reattempted 3 times per day every 2 days for the entire month.
{
"retryConfiguration":{
"retryType":"schedule",
"value":[2]
}
}2.
retryType:"fixed". Send the specific days of the month to retry. Ex. 10th, 20th, 30th.In the following example, the charge will only be reattempted 3 times a day, on the 10th, 20th and 30th of the corresponding month.
{
"retryConfiguration":{
"retryType":"fixed",
"value":[10,20,30]
}
}Send the retryTypeasfixedif you do not want to retry collection for the entire month.
If the last charge attempt was declined, we may send you a notification via WebHook informing you about it. In these cases, we recommend you to contact the card owner and offer them a set of alternatives for paying the fee that could not be charged; for example, changing the registered credit card and generating an One-click payment only for one time. Kushki will continue executing automatic charges over the following periods.
Important!
When customizing retries it should be noted that once the first collection is initiated, if it fails and retries are initiated, any updates to retries will be applied until the next subscription period (weekly, monthly, yearly).
Periodicity
periodicity field:Do you have your own 3DS authentication engine?
Product in beta version in Ecuador 🇪🇨 🔐👨💻
We are working on our beta version. Stay tuned for its official release! You can also contact your account manager for more information.
threeDomainSecure object in your request.Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api-uat.kushkipagos.com/subscriptions/v1/card' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
"token": "gV3ox6100000sAxClU033646vnnJsT83",
"planName": "Premium",
"periodicity": "monthly",
"contactDetails": {
"documentType": "RUC",
"documentNumber": "1009283738",
"email": "user@example.com",
"firstName": "John",
"lastName": "Doe",
"phoneNumber": "+593912345678"
},
"amount": {
"subtotalIva": 1,
"subtotalIva0": 0,
"ice": 0,
"iva": 0.14,
"currency": "USD"
},
"startDate": "2022-05-25",
"metadata": {
"plan": {
"fitness": {
"cardio": "include",
"rumba": "include",
"pool": "include"
}
}
}
}'Response Response Example
201 - default
{
"subscriptionId": "1601594972296000"
}Modified at 2026-07-10 20:45:14