Conceptos de checkout
Entiende el recorrido del comprador, los resultados de pago y el seguimiento después del checkout.
El checkout permite al comprador revisar una oferta, completar sus datos de facturación y realizar o iniciar un pago. Puede crear una factura, un pago y una suscripción cuando la oferta es recurrente.
Propósito
Elige Enlaces de pago para compartir una oferta reutilizable. Elige Cart Checkout cuando tu backend prepara un carrito específico.
Un enlace de pago crea o reanuda una Checkout Session cuando el comprador inicia el flujo interactivo. Una integración por API crea la sesión directamente, con precios del catálogo o inline. Ambos usan el mismo checkout alojado y flujo de cobro.
Qué hace el checkout
- Muestra oferta, cantidades e importes a pagar ahora y después.
- Recopila los datos del cliente y de facturación.
- Muestra métodos disponibles para el carrito, país, moneda y conexiones habilitadas.
- Inicia el pago y crea los registros comerciales correspondientes.
- Muestra resultado, instrucciones o siguiente acción requerida.
Resultados principales
| Resultado | Qué significa | Seguimiento |
|---|---|---|
| Completado | El comprador terminó el checkout; el pago pudo completarse o no requerir un cargo inmediato. | Consulta el estado del pago y el evento correspondiente. |
| Pendiente | El flujo se envió, pero falta confirmación o una acción para completar el pago. | Sigue las instrucciones y espera el resultado final. |
| Fallido | El pago no pudo completarse por un rechazo, datos inválidos u otro error de procesamiento. | Revisa la causa antes de reintentar o elegir otro método. |
El status de la Checkout Session describe el flujo del comprador; paymentStatus describe el pago. Una redirección o página completada no demuestra un cobro. Tu integración debe verificar y deduplicar el evento firmado invoice.paid antes de entregar una compra pagada.
Tipos de oferta
- Pago único: cobra un importe una vez; una oferta con importe cero no requiere cargo.
- Suscripción: puede cobrar la primera factura, iniciar una prueba o usar cobro posterior por factura, según la configuración.
- Carrito mixto: puede combinar un cargo de alta, suscripciones y pruebas con importes a pagar de inmediato. Revisa qué se paga ahora y qué se factura después.
Datos del cliente
Según la oferta, el checkout puede solicitar nombre, email, dirección de facturación, país, código postal y campos personalizados. Estos datos identifican al cliente, permiten facturar y dirigir el pago y ayudan al seguimiento.
Métodos de pago
Los métodos disponibles dependen del país y moneda seleccionados, pasarelas configuradas y familias de métodos habilitadas. Un método disponible para una oferta o vía puede no estarlo para otra.
País y monedas disponibles
Una moneda debe ser compatible con todo el carrito y con una vía de pago habilitada para el país seleccionado. Si un producto no admite USD, el carrito no puede ofrecer USD para esa compra.
El checkout puede elegir la vía inicial según el país estimado del comprador, como ARS en Argentina o BRL en Brasil. Eso no demuestra que otras monedas estén deshabilitadas.
Usa el selector de país del pie de página para cambiar la vía. Si un país tiene varias monedas válidas, elige la opción correspondiente, como Argentina (ARS) o Argentina (USD).
Si falta una moneda, revisa los precios de todos los productos y la vía de la cuenta para ese país y moneda antes de pedir otro intento al comprador.
Precios, descuentos y totales
Revisa precios, cantidades, descuentos de producto, promociones, cupones, total a pagar ahora e importes recurrentes futuros. Una prueba puede posponer algunos cargos mientras otros ítems se pagan de inmediato. Los beneficios configurados dependen de elegibilidad; la cotización final determina cuáles aplican.
Checkout y facturas
Una factura registra el importe adeudado. Los pagos describen el cobro y una suscripción registra la relación comercial recurrente. Una factura puede pagarse de inmediato, después o mediante un seguimiento de cobro.
Creación de suscripciones
El estado inicial depende de la oferta: una prueba puede comenzar como trialing; el primer cobro automático fallido puede dejarla incomplete; un pago establecido puede activarla; el cobro por factura puede iniciar una suscripción active sujeta a vencimientos. Consulta Suscripciones.
Qué puede ver el comprador
Puede ver confirmación inmediata, una prueba sin cargo hoy, pago posterior o instrucciones adicionales para un pago pendiente. Métodos con redirección, transferencias y pagos en efectivo o con cupón pueden terminar después de abandonar el checkout.
Seguimiento operativo
Comprueba por separado envío del checkout, pago completado, creación de suscripción y saldo de factura. Una compra gratuita o de prueba no demuestra que se cobró dinero. Usa Seguimiento de cobros para investigar pagos pendientes o fallidos.
Después del checkout
Confirma factura, resultado del pago y suscripción por separado. Para una integración, usa webhooks verificados en lugar del resultado del navegador para confirmar una compra pagada.