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 reintenta 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 así:1.
retryType:"schedule". Si eliges schedule, puedes especificar en el campo value cada cuántos días se reintenta el cobro.En el siguiente ejemplo, el cobro se reintenta 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 quieres reintentar. Ej. 10, 20, 30.En el siguiente ejemplo, el cargo solo se reintenta 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 cargo fue declinado, puede que te enviemos una notificación por WebHook para avisarte. En estos casos, te recomendamos contactar al dueño 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 Pago One-click por una sola vez. Kushki sigue ejecutando los cargos 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 aplica a partir del siguiente periodo de la suscripción (semanal, mensual, anual).
Periodicidad
periodicity:¿Tienes tu propio motor de autenticación 3DS?
threeDomainSecure en tu petición.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": "CURP",
"documentNumber": "1009283738",
"email": "user@example.com",
"firstName": "John",
"lastName": "Doe",
"phoneNumber": "+52 912345678"
},
"amount": {
"subtotalIva": 1,
"subtotalIva0": 0,
"ice": 0,
"iva": 16,
"currency": "MXN"
},
"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 14:57:28