Órdenes de pago

Realiza cobros a tus clientes con PagoEfectivo, billeteras móviles y Cuotéalo

Las ó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.
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.

Flujo de transaccion

Integraciones

En cada etapa del flujo de integración tenemos una herramienta que puede ayudarte a reducir tiempo en desarrollo.

Recuerda que para usar cualquiera de estos métodos necesitas tener tu llave pública (test o live) de integración.

Frontend Comercio

En el frontend tenemos diferentes mecanismos de integración que puedes utilizar:

  • Culqi Checkout - integración low code
  • Culqi API - integración full code
Recuerda que la orden debe ser creada usando el parámetro Confirm con el valor “false”.

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:

Culqi Checkout

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í

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).

Recuerda que para recibir la actualización de las órdenes debes configurar tu Webhook con el evento (order.status.changed).

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.