Modelo Buy Now, Pay Later (Compra ahora, Paga Después)
Un Pago en Cuotas representa la intención de realizar un cargo utilizando el modelo Buy Now, Pay Later (Compra Ahora, Paga Después), el que permite que tus clientes paguen en cuotas, aunque tu como comercio recibas el pago total de la venta en un único abono.
El flujo normal de un Pago en Cuotas tiene 2 pasos relevantes: la aprobación del pago por parte de VentiPay y la autorización y captura del mismo por parte tuya.
En el primer paso VentiPay solicitará al cliente registrarse en nuestro servicio para luego ofrecerle uno o más planes de pagos en cuotas por el monto total de la compra, previo a una evaluación de riesgo en línea. Dependiendo del resultado de esta evaluación de riesgo, el Pago en Cuotas puede ser aprobado o rechazado.
Si el Pago en Cuotas resulta aprobado, entonces el siguiente paso consiste en la autorización de este por parte tuya. Una vez que autorices exitosamente el Pago en Cuotas, corresponderá que entregues el producto o servicio a tu cliente y dar el proceso de pago por terminado.
Autorización y Captura
El proceso de autorización de un Pago en Cuotas equivale al proceso de autorización y captura (en conjunto) de un pago tradicional con tarjetas. Esto se debe a que el método de pago de un Pago en Cuotas no siempre permite realizar el proceso de autorización y luego el de captura.
Sin embargo siempre podrás reembolsar un Pago en Cuotas previamente autorizado en caso de que así lo necesites.
Una vez que el Pago en Cuotas sea aprobado, tendrás un máximo de 1 hora para autorizarlo, de lo contrario será cancelado automáticamente.
Cada vez que un Pago en Cuotas se apruebe, autorice o rechace, podrás recibir una notificación vía Webhook para actualizar el estado de la compra, como también podrás redirigir al cliente a una URL que tu definas al momento de crearlo.
Cuando recibas una notificación de aprobación recuerda validar los datos del Pago en Cuotas antes de autorizarlo. Debes validar, al menos, que la moneda y el monto aprobado corresponda al monto total de la compra.
El objeto loan_intent
loan_intent| Atributo | Tipo | Descripción |
|---|---|---|
id | string | Identificador único del objeto. |
object | string | Indica el tipo de objeto. Valor siempre será loan_intent. |
amount | integer | Un número entero positivo que representa cuánto cobrar en la unidad monetaria más pequeña (por ejemplo, 100 centavos para cobrar USD $ 1,00 o 100 para cobrar CLP $ 100) |
authorize | boolean | Indica si el pago se autorizará inmediatamente después de la aprobación. Default es false. |
authorized_at | datetime | Fecha de autorización del pago. |
approval_session | object | Dirección IP, navegador y ubicación geográfica del cliente al momento de aprobar el pago. |
approved_at | datetime | Fecha de aprobación del pago. |
cancel_url | string | Una URL a la cual el cliente será redirigido si la autorización del pago falla. |
cancel_url_method | string | El método HTTP a utilizar al redirigir al cliente en caso de un pago fallido. Uno de post, get.Default es post. |
checkout_id | string | ID checkout relacionado. |
currency | string | Código de moneda ISO de tres letras. Corresponde a la moneda de presentación. |
customer | objectampliable | Objeto customer relacionado. |
customer_id | string | ID customer relacionado. |
description | string | Un texto arbitrario asociado al objeto. |
financing_program | string | Indica el plan de pagos elegido. |
items | array | Listado de items o productos de la venta. |
live | boolean | Indica si el pago existe en modo live o modo test. |
loan | objectampliable | Objeto loan relacionado. |
loan_id | string | ID loan relacionado. |
metadata | object | Conjunto de pares llave-valor que puedes asociar a un objeto. Esto puede resultar útil para almacenar información adicional sobre el objeto en un formato estructurado. |
original_amount | integer | Monto del pago antes de aplicarse descuentos. |
payment_method_id | string | ID payment_method relacionado. |
rejected_at | datetime | Fecha de rechazo del pago. |
source | string | Indica qué sistema o plataforma fue responsable de crear el pago. Uno de shopify, vtex, jumpseller. |
status | string | El estado del pago. Uno de open, approved, authorized, rejected, canceled. |
status_reason | string | Incluye detalles sobre un pago fallido o rechazado. |
success_url | string | Una URL a la cual el cliente será redirigido si la autorización del pago es exitosa. |
success_url_method | string | El método HTTP a utilizar al redirigir al cliente en caso de un pago exitoso. Uno de post, get. Default es post. |
url | string | Una URL utilizada para identificar de forma exclusiva el objeto. Las URL se pueden usar para compartir un pago en aplicaciones de mensajería, códigos QR y otros canales. |
created_at | datetime | Fecha de creación del objeto en formato ISO 8601. Basado en UTC. |
updated_at | datetime | Fecha de actualización del objeto en formato ISO 8601. Basado en UTC. |
Estados
| Estado | Descripción |
|---|---|
open | Estado inicial del pago. Significa que está listo para intentar ser aprobado. |
approved | El pago fue aprobado y está a la espera de ser autorizado. En este punto aun no se realizan cargos al método de pago. |
authorized | El pago fue autorizado y capturado exitosamente. |
rejected | El pago no fue aprobado. |
canceled | El pago fue cancelado y ya está no está disponible para ser aprobado ni autorizado. Solo los pagos que aun no hayan sido autorizados pueden ser cancelados. |