Crear un cargo recurrente

Esta funcionalidad está disponible para los siguientes modelos:
☑ Adquirencia
☑ Agregador

Crea un cargo recurrente con un token entregado por Kushki que representa la tarjeta de crédito del cliente.

Ejecución del pago

Kushki procesa los cargos recurrentes a la tarjeta registrada de forma automática. Los pagos se ejecutan y se repiten según el monto y el periodo indicados en la suscripción.

La lógica de facturación empieza a ejecutarse todos los días a partir de las 6am GMT-5. Asegúrate de que la suscripción se cree antes de esa hora si quieres que el primer pago se ejecute el mismo día del registro. También tu cliente puede registrar su tarjeta algunos días antes de que Kushki ejecute el primer cargo. Al crear una suscripción, debes indicar la fecha de inicio startDate.

Reintentos

Si un pago es rechazado, Kushki tiene una lógica de reintentos para intentar recuperar el cargo. Por defecto, hay 3 reintentos durante 3 días seguidos a partir del día de pago definido originalmente en 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.

Puedes modificar los días de reintento de una suscripción y también definir días de cobro específicos.

Si el último intento de cargo fue declinado, podemos enviarte una notificación vía WebHook para informártelo. En esos casos, te recomendamos contactar al dueño de la tarjeta y ofrecerle un conjunto de alternativas para pagar la cuota que no se pudo cobrar; por ejemplo, cambiar la tarjeta de crédito registrada y generar un cargo on demand por una sola vez. Kushki seguirá ejecutando los cargos automáticos en los periodos siguientes.

Personaliza la lógica de reintentos

Puedes personalizar la lógica de reintentos de cobro enviando el objeto retryConfiguration así:

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]
   }
}

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 retryType como fixed si no quieres reintentar el cobro durante todo el mes.
Si el último intento de cargo fue declinado, podemos enviarte una notificación vía WebHook para informártelo. En esos casos, te recomendamos contactar al dueño de la tarjeta y ofrecerle un conjunto de 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 por una sola 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 comienzan los reintentos, cualquier actualización de los reintentos se aplicará hasta el siguiente periodo de la suscripción (weekly, monthly, yearly).

Periodicidad

Puedes elegir la frecuencia de los cargos recurrentes enviando cualquiera de estos valores en el campo obligatorio periodicity:

daily: cada 1 día.

weekly: cada 7 días.

biweekly: cada 15 días.

monthly: cada 30 días.

threefortnights: cada seis semanas o 42 días.

bimonthly: cada 60 días.

quarterly: cada 90 días.

fourmonths: cada 120 días.

halfyearly: cada 180 días

yearly: cada 360 días.

custom: para one click payments.

¿Tienes tu propio motor de autenticación 3DS?

Asegúrate de incluir el objeto threeDomainSecure en tu solicitud.

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": "CC", "documentNumber": "1009283738", "email": "user@example.com", "firstName": "John", "lastName": "Doe", "phoneNumber": "+57 912345678" }, "amount": { "subtotalIva": 1, "subtotalIva0": 0, "ice": 0, "iva": 0.14, "currency": "COP" }, "startDate": "2022-05-25", "metadata": { "plan": { "fitness": { "cardio": "include", "rumba": "include", "pool": "include" } } } }'

Esta funcionalidad está disponible para los siguientes modelos:

Ejecución del pago

Reintentos

Personaliza la lógica de reintentos

¡Importante!

Periodicidad

¿Tienes tu propio motor de autenticación 3DS?

Request

Responses

Crear un cargo recurrente

Esta funcionalidad está disponible para los siguientes modelos:#

Ejecución del pago#

Reintentos#

Personaliza la lógica de reintentos#

¡Importante!#

Periodicidad#

¿Tienes tu propio motor de autenticación 3DS?#

Request

Responses

Esta funcionalidad está disponible para los siguientes modelos:

Ejecución del pago

Reintentos

Personaliza la lógica de reintentos

¡Importante!

Periodicidad

¿Tienes tu propio motor de autenticación 3DS?