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:
☑ Acquirer
☑ Aggregator
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:Uso de fullResponse: v3
"fullResponse": "v3" recibes una respuesta ampliada en la que el objeto details incluye campos adicionales respecto a v2. Uno de esos campos es validationTicketNumber, que contiene el número de ticket del cargo de validación que se ejecuta al crear la suscripción.Estabilidad de la respuesta v3
La respuesta v3puede incluir campos nuevos o deprecados sin previo aviso. No construyas lógica que dependa del conjunto exacto de campos que devuelvedetails. Maneja siempre de forma tolerante los campos inesperados o ausentes.
¿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
curl --location '/subscriptions/v1/card' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
"token": "gV3ox6100000sAxClU033646vnnJsT83",
"planName": "Premium",
"periodicity": "monthly",
"contactDetails": {
"documentType": "RUT",
"documentNumber": "12345678-9",
"email": "user@example.com",
"firstName": "Catalina",
"lastName": "Fuentes",
"phoneNumber": "+56912345678"
},
"amount": {
"subtotalIva": 0,
"subtotalIva0": 10000,
"ice": 0,
"iva": 0,
"currency": "CLP"
},
"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:08:50