Actualiza los datos de un cargo calendarizado, aplica descuentos o cancela los cobros automáticosEsta funcionalidad se encuentra disponible para los siguientes modelos:
☑ Adquirente
☑ AgregadorPara que se reflejen los cambios, asegúrate de actualizar el cobro calendarizado al menos 24 horas antes de la fecha especificada para el siguiente cobro.
Obtén los datos de un cobro calendarizado#
Puedes consultar los datos disponibles de un cargo calendarizado que ya fue creado para que luego los muestres en pantalla a tus clientes. La información que devolvemos también la puedes guardar en tus bases de datos; no tendrás problemas, ya que no te daremos datos sensibles de la tarjeta.De acuerdo con la respuesta, muestra en pantalla la información que necesites o guárdala en tus bases de datos.Cuando tienes un cambio en el plan recurrente de tus clientes, puedes actualizar la información del cargo calendarizado que ya está creado sin necesidad de pedir nuevamente los datos de la tarjeta.Los datos que puedes actualizar son:Recurrencia con la que se ejecutan los cobros (periodicity)
Fecha en la que se cobra (startDate)
Fecha de finalización de los cargos calendarizados (endDate)
Lógica de reintentos de cobro
Recuerda que para manejar información sensible de una transacción, tu comercio debe contar con la certificación PCI correspondiente.
Integración Kushki.js (front end)#
Si estás obteniendo el token desde tu front end con la biblioteca de Kushki.js, sigue los pasos detallados a continuación:Consume el método requestSubscriptionToken()#
En tu implementación de Kushki.js, es necesario que consumas el método requestSubscriptionToken() disponible en la biblioteca, enviando los parámetros requeridos.Si la solicitud ha sido correcta, recibirás una respuesta con el token como se muestra a continuación{
"token": "90a9f2d93ba508c38971890454897fd4"
}
Actualiza datos de la tarjeta en un cargo recurrente#
Si la generación del token ha sido correcta, debes de consumir el endpoint actualiza datos de la tarjeta en un cargo recurrente enviando el token obtenido en el paso anterior y el subscriptionId con el id de la suscripción a actualizar.Integración API (back end)#
En tu implementación mediante API, es necesario que consumas el endpoint solicitar un token de cargo recurrente, enviando los datos de la tarjeta.Actualiza datos de la tarjeta en un cargo recurrente#
Si la generación del token ha sido correcta, debes de consumir el endpoint actualiza datos de la tarjeta en un cargo recurrente enviando el token obtenido en el paso anterior y el subscriptionId con el id de la suscripción a actualizar.Aplica un descuento temporal#
Kushki te permite ofrecer períodos con descuentos a tus clientes. Una vez que se cumpla el período que especificas, automáticamente cobraremos a la tarjeta el valor original con el que se creó el cargo calendarizado.El valor que especifiques será el monto que Kushki cobrará a la tarjeta durante el número de períodos indicado. Por ejemplo, tu cliente inscribió su tarjeta y autorizó un cargo de 30 USD mensuales; para que Kushki cobre 20 USD durante dos meses, envía el monto y el número 2 en la cantidad de períodos.De acuerdo con la respuesta, redirecciona al usuario a una página de éxito o fracaso para informar al cliente si el descuento se aplicó correctamente o si hubo un error.Cancela los cobros recurrentes#
Cuando tu cliente decida cancelar el cargo recurrente, asegúrate de cancelarla también con Kushki para que los cobros calendarizados ya no se ejecuten. Esta acción es inmediata; una vez que la ejecutes, la suscripción quedará automáticamente cancelada.Ten en cuenta que esta acción es irreversible.
