Crear un cargo recurrente
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
POST
/subscriptions/v1/card
token entregado por Kushki que representa la tarjeta de crédito del cliente.Ejecución del pago
startDate.Reintentos
startDate. Por ejemplo, para una suscripción mensual con fecha de inicio 10-01-2021 y un rechazo el 10-02-2021, el pago se reintentará hasta el 13-02-2021, 3 veces cada día, para un total de 9 intentos de pago.Personaliza la lógica de reintentos
retryConfiguration de la siguiente forma:1.
retryType:"schedule". Si eliges schedule, puedes especificar en el campo value cada cuánto se reintentará el cobro.En el siguiente ejemplo, el cobro se reintentará 3 veces al día cada 2 días durante todo el mes.
{
"retryConfiguration":{
"retryType":"schedule",
"value":[2]
}
}2.
retryType:"fixed". Envía los días específicos del mes en los que se debe reintentar. Ej. 10, 20, 30.En el siguiente ejemplo, el cargo solo se reintentará 3 veces al día, los días 10, 20 y 30 del mes correspondiente.
{
"retryConfiguration":{
"retryType":"fixed",
"value":[10,20,30]
}
}Envía el retryTypecomofixedsi no quieres reintentar el cobro durante todo el mes.
Si el último intento de cobro fue rechazado, podemos enviarte una notificación vía WebHook para informártelo. En estos casos, te recomendamos contactar al titular de la tarjeta y ofrecerle alternativas para pagar la cuota que no se pudo cobrar; por ejemplo, cambiar la tarjeta de crédito registrada y generar un One-click payment una sola vez. Kushki seguirá ejecutando los cobros automáticos en los periodos siguientes.
¡Importante!
Al personalizar los reintentos, ten en cuenta que una vez iniciado el primer cobro, si falla y comienzan los reintentos, cualquier actualización de los reintentos se aplicará hasta el siguiente periodo de la suscripción (semanal, mensual, anual).
Periodicidad
periodicity:¿Tienes tu propio motor de autenticación 3DS?
Producto en versión beta en Ecuador 🇪🇨 🔐👨💻
Estamos trabajando en nuestra versión beta. ¡Mantente atento a su lanzamiento oficial! También puedes contactar a tu ejecutivo de cuenta para más información.
threeDomainSecure en tu solicitud.Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/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-09-11 15:02:07