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

AtributoTipoDescripción
idstringIdentificador único del objeto.
objectstringIndica el tipo de objeto. Valor siempre será loan_intent.
amountintegerUn 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)
authorizebooleanIndica si el pago se autorizará inmediatamente después de la aprobación.
Default es false.
authorized_atdatetimeFecha de autorización del pago.
approval_sessionobjectDirección IP, navegador y ubicación geográfica del cliente al momento de aprobar el pago.
approved_atdatetimeFecha de aprobación del pago.
cancel_urlstringUna URL a la cual el cliente será redirigido si la autorización del pago falla.
cancel_url_methodstringEl método HTTP a utilizar al redirigir al cliente en caso de un pago fallido.

Uno de post, get.
Default es post.
checkout_idstringID checkout relacionado.
currencystringCódigo de moneda ISO de tres letras. Corresponde a la moneda de presentación.
customerobject
ampliable
Objeto customer relacionado.
customer_idstringID customer relacionado.
descriptionstringUn texto arbitrario asociado al objeto.
financing_programstringIndica el plan de pagos elegido.
itemsarrayListado de items o productos de la venta.
livebooleanIndica si el pago existe en modo live o modo test.
loanobject
ampliable
Objeto loan relacionado.
loan_idstringID loan relacionado.
metadataobjectConjunto 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_amountintegerMonto del pago antes de aplicarse descuentos.
payment_method_idstringID payment_method relacionado.
rejected_atdatetimeFecha de rechazo del pago.
sourcestringIndica qué sistema o plataforma fue responsable de crear el pago.

Uno de shopify, vtex, jumpseller.
statusstringEl estado del pago.

Uno de open, approved, authorized, rejected, canceled.
status_reasonstringIncluye detalles sobre un pago fallido o rechazado.
success_urlstringUna URL a la cual el cliente será redirigido si la autorización del pago es exitosa.
success_url_methodstringEl método HTTP a utilizar al redirigir al cliente en caso de un pago exitoso.

Uno de post, get. Default es post.
urlstringUna 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_atdatetimeFecha de creación del objeto en formato ISO 8601. Basado en UTC.
updated_atdatetimeFecha de actualización del objeto en formato ISO 8601. Basado en UTC.

Estados

EstadoDescripción
openEstado inicial del pago. Significa que está listo para intentar ser aprobado.
approvedEl pago fue aprobado y está a la espera de ser autorizado. En este punto aun no se realizan cargos al método de pago.
authorizedEl pago fue autorizado y capturado exitosamente.
rejectedEl pago no fue aprobado.
canceledEl 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.