Crear un cargo recurrente
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
POST
/subscriptions/v1/card
Esta funcionalidad está disponible para los siguientes modelos:
☑ Adquirencia
☑ Agregador
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 por día, para un total de 9 intentos de pago.Personaliza la lógica de reintentos
retryConfiguration de esta 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 por 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 y 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 cargo fue declinado, podemos enviarte una notificación por WebHook para avisarte. En esos 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 One-click payment solo por una vez. Kushki seguirá 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 arrancan los reintentos, cualquier actualización de los reintentos se aplicará hasta el siguiente periodo de la suscripción (semanal, mensual o anual).
Periodicidad
periodicity:Uso de fullResponse: v3
"fullResponse": "v3" devuelve una respuesta ampliada en la que el objeto details incluye campos adicionales frente a v2. Uno de esos campos es validationTicketNumber, que contiene el número de ticket del cargo de validación ejecutado al crear la suscripción.Estabilidad de la respuesta v3
La respuesta v3puede incluir campos nuevos o deprecados sin aviso previo. No construyas lógica que dependa del conjunto exacto de campos devueltos endetails. Maneja siempre de forma tolerante los campos inesperados o ausentes.
¿Tienes una sugerencia sobre esta documentación? Contáctanos.
¿Tienes tu propio motor de autenticación 3DS?
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": "CE",
"documentNumber": "1009283738",
"email": "user@example.com",
"firstName": "John",
"lastName": "Doe",
"phoneNumber": "+51912345678"
},
"amount": {
"subtotalIva": 1,
"subtotalIva0": 0,
"ice": 0,
"iva": 0.14,
"currency": "PEN"
},
"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:53:30