Órdenes de pago
Realiza cobros a tus clientes con PagoEfectivo, billeteras móviles y CuotéaloLas órdenes de pago son usadas para habilitar formas de pago alternativo como Pago efectivo, billeteras móviles y Cuotéalo.
Para poder integrar órdenes en los flujos de pago, es necesario utilizar el API de Culqi como parte del flujo de pago.
Dado la naturaleza asincrónica de las órdenes, donde tus clientes pueden pagar la orden muchas horas después, es obligatorio el uso de Webhooks para recibir la confirmación de pago por parte del sistema.
Existen diferentes opciones de integración que dependen del nivel de control y personalización que se desees:
| Plugins CMS | Si tienes un CMS, la forma más simple de integrar es mediante nuestros plugins. Estos integran de manera automática las órdenes. |
| Culqi Checkout | Los checkouts multipago incluyen pagos con órdenes. La última versión del checkout incluye pagos con Yape y Cuotéalo. |
| CulqiJS | Ideal para cuando quieres tener control total de la interfaz de tu checkout utiliza CulqiJS para comunicarte con nuestra API. La integración del backend se hace usando nuestras librerías o a mano. |
| Culqi API | Perfecta para cuando deseas tener el control total de la interfaz y el backend. Integra directamente los endpoints del API a tu gusto. |
Flujo de una transacción
En el siguiente gráfico puedes ver el flujo para realizar una orden independiente del mecanismo de integración.
Integraciones
En cada etapa del flujo de integración tenemos una herramienta que puede ayudarte a reducir tiempo en desarrollo.
Frontend Comercio
En el frontend tenemos diferentes mecanismos de integración que puedes utilizar:
- Culqi Checkout - integración low code
- CulqiJS - integración low code
- Culqi API - integración full code
Culqi Checkout
Integrarte usando el botón de pago Culqi Checkout, pasándole como parámetro la orden de pago previamente generada.
Esto hará que aparezcan las opciones de PagoEfectivo, billeteras móviles y Cuotéalo al hacer click sobre el botón de pago:
Aquí tu cliente debe seleccionar un medio de pago (Tarjeta, PagoEfectivo, Billeteras móviles, Cuotéalo) e ingresar la información solicitada.
En caso quieras utilizar este mecanismo de integración, sigue las instrucciones aquí
CulqiJS
En caso desees tener un formulario de pago personalizado con validaciones propias, intégrate usando nuestra librería de CulqiJS.
Usando APIs
Para tener control total sobre tu integración, utiliza la API para generación de órdenes y sigue el flujo del diagrama antes mostrado.
Backend Comercio
Una vez que el cliente realice el pago con cualquiera de los métodos de pagos del frontend de la tienda. PagoEfectivo le notificará a Culqi, luego Culqi te notificará mediante un Webhook el estado de la orden (pagada o expirada).
Usando Librerías
Culqi tiene una serie de librerías (PHP, Ruby, Python, Java, .Net, etc) que te sirven para agilizar tu integración, agrégalas a tu paquetería y úsalas para abstraer la conexión a nuestra API.
Usando API
En caso desees integrarte directamente a nuestras APIs para tener control total de tu integración backend puedes hacer uso de nuestra variedad de servicios Rest.