Cargo único
Esta modalidad de Pago único con Efectivo te permitirá crear órdenes que tus clientes podrán pagar directamente en un punto de venta autorizado por Conekta de manera física, generando referencias con un monto y vigencia determinadas.
Conekta cuenta con dos redes de puntos de venta que se habilitan de forma automática teniendo en cuenta el giro de tu negocio:
- OXXO con más de 20,000 puntos de venta.
- Red Alterna con más de 10,000 puntos de venta (7 eleven, Farmacias del Ahorro, Tiendas Extra, Círculo K, Farmacia Benavides, Soriana, Waldo´s, Eleczion, Grupo RFP, Super Kiosko, Farmacias Bazar, Wolworth y del Sol, Yepas y Al super).
NOTA
Tu negocio podrá operar con nuestras redes de efectivo de acuerdo a la información que proporcionaste en el proceso de onboarding.
Características
- No es necesario registrar/almacenar un cliente en Conekta.
- La referencia tendrá una expiración definida por el merchant o dada por default por Conekta en 30 días.
- Cada vez que un cliente quiera realizar un pago en tu negocio, se generará una referencia distinta.
- Se enviarán notificaciones del pago en un máximo de 10 minutos a través de Webhooks y vía mail al usuario final.
Flujo de pago
Pasos para integrar
Generar autenticación de API
Para configurar los headers de tus peticiones, sigue las instrucciones de la sección “Primeros Pasos”.
Crear orden de pago
La orden requiere de cierta información que obtiene ya sea de algún servicio interno del negocio, o directamente del FrontEnd al solicitarla al usuario/cliente final. Los datos principales traducidos a atributos del request son:
- ¿Quién está pagando? -> Customer
- ¿Qué está pagando? -> Line_items
- ¿Cuánto está pagando? -> Unit_pice multiplicado por Quantity
- ¿Cuál es el método de pago? -> Payment_method
- ¿Cuál es la expiración de la referencia? -> Expires_at
- ¿Información extra requerida por el negocio? -> Metadata
Para más detalle consulta nuestra Referencia API.
NOTA
La expiración puede ser desde segundos (para poder realizar tus pruebas) hasta 365 días.
Request
-H "Accept: application/vnd.conekta-v2.0.0+json" \
-H "Content-type: application/json" \
-u key_YOUR_PRIVATE_API_KEY: \
-X POST -d '{
"line_items": [{
"name": "Nombre del Producto o Servicio",
"unit_price": 23000,
"quantity": 1
}],
"currency": "MXN",
"customer_info": {
"name": "Jorge Martínez",
"email": "[email protected]",
"phone": "+5218181818181"
},
"metadata":{
"datos_extra": "1234"
},
"charges":[{
"payment_method": {
"type": "cash",
"expires_at": 1678300709
}
}]
}’https://api.conekta.io/orders
{
"livemode": false,
"amount": 23000,
"currency": "MXN",
"payment_status": "pending_payment",
"amount_refunded": 0,
"customer_info": {**
"email": "[email protected]",**
"phone": "+5218181818181",**
"name": "Jorge Martínez",**
"object": "customer_info"
},
"object": "order",
"id": "ord_2tV2HyVSTfdrsXqqV",
"metadata": {
"datos_extra": "1234"
},
"is_refundable": false,
"created_at": 1678214375,
"updated_at": 1678214375,
"line_items": {**
"object": "list",
"has_more": false,
"total": 1,
"data": [
{
"name": "Nombre del Producto o Servicio",**
"unit_price": 23000,**
"quantity": 1,**
"object": "line_item",
"id": "line_item_2tV2HyVSTfdrsXqqT",
"parent_id": "ord_2tV2HyVSTfdrsXqqV",
"metadata": {},
"antifraud_info": {}
}
]
},
"charges": {
"object": "list",
"has_more": false,
"total": 1,
"data": [
{
"id": "640784e7a8a54c00178ea732",
"livemode": false,
"created_at": 1678214375,
"currency": "MXN",
"payment_method": {
"service_name": "OxxoPay",
"barcode_url": "https://barcodes.conekta.com/sandbox_reference.png",**
"object": "cash_payment",
"type": "oxxo",
"expires_at": 1678300709,**
"store_name": "OXXO",**
"reference": "98000014505724"**
},
"object": "charge",
"description": "Payment from order",
"status": "pending_payment",**
"amount": 23000,**
"fee": 1041,**
"customer_id": "",
"order_id": "ord_2tV2HyVSTfdrsXqqV"**
}
]
}
}
"livemode": false,
"amount": 23000,
"currency": "MXN",
"payment_status": "pending_payment",
"amount_refunded": 0,
"customer_info": {**
"email": "[email protected]",**
"phone": "+5218181818181",**
"name": "Jorge Martínez",**
"object": "customer_info"
},
"object": "order",
"id": "ord_2tbtp8ubDPjNbrRDZ",
"metadata": {
"datos_extra": "1234"
},
"is_refundable": false,
"created_at": 1680030285,
"updated_at": 1680030285,
"line_items": {
"object": "list",
"has_more": false,
"total": 1,
"data": [
{
line_item_2tbtp8ubDPjNbrRDX",
"parent_id": "ord_2tbtp8ubDPjNbrRDZ",
"metadata": {},
"antifraud_info": {}
}
]
},
"charges": {
"object": "list",
"has_more": false,
"total": 1,
"data": [
{
"id": "64233a4dd2d40c0018b967a6",
"livemode": false,
"created_at": 1680030285,
"currency": "MXN",
"payment_method": {
"service_name": "Cash",
"barcode_url": "https://barcodes.conekta.com/sandbox_reference.png",**
"object": "cash_payment",
"type": "cash",**
"expires_at": 1680138259,**
"store_names": [**
"7 Eleven",
"Farmacias del Ahorro",
"CIRCLE K",
"Tiendas Extra",
"Farmacia Benavides"
"Soriana"
"WALDO'S",
"ELECZION",
"Super Kiosko"
"Farmacias Bazar"
"Wolworth",
"Del Sol",
"Yepas",
"Farmacias De Dios",
"Farmacias Nosarco",
"Farmacias Santa Cruz",
"Farmacentro",
"Farmacias GyM",
"Farmacias San Francisco de Asis",
"Farmacias Union",
"Farmacias Zapotlan",
"Farmatodo",
"Al Super"
],
"store_name": "[\"7 Eleven\",\"Farmacias del Ahorro\",\"CIRCLE K\",\"Tiendas Extra\",\"Farmacia Benavides\",\"Soriana\",\"WALDO'S\",\"ELECZION\",\"Wolworth\",\"Del Sol\",\"Yepas\",\"Farmacias De Dios\",\"Farmacias Nosarco\",\"Farmacias Santa Cruz\",\"Farmacentro\",\"Farmacias GyM\",\"Farmacias San Francisco de Asis\",\"Farmacias Union\",\"Farmacias Zapotlan\",\"Farmatodo\",\"Super Kiosko\",\"Farmacias Bazar\",\"Al Super\"]",
"reference": "7647156830217265"
},
"object": "charge",
"description": "Payment from order",
"status": "pending_payment",**
"amount": 23000,**
"fee": 987,**
"customer_id": "",
"order_id": "ord_2tbtp8ubDPjNbrRDZ"
}
]
}
}
Nota
El mapeo de la respuesta es importante para que puedas realizar la conciliación automática de tu negocio, es decir, cuando recibas un pago puedas registrarlo en tu sistema y ejecutar los procesos requeridos como: actualización de balances, activación de servicio o entrega de producto.
Puedes utilizar el response del request para creación de orden tomando en cuenta los datos principales (marcados con **) y demás información que consideres necesaria para los procesos mencionados anteriormente.
Presentar la ficha de pago
La siguiente ficha, es una forma sugerida para mostrar a tus clientes la referencia de pago en efectivo con la información más relevante, además de presentar los pasos necesarios para completar el proceso en el punto de venta elegido.
Recomendamos que la incluyas en tu Checkout o enviarla por algún medio de comunicación para mejorar la experiencia con tu cliente.
- Ficha de pago para Red OXXO
- Ficha de pago para Red Alterna
Servicio de Notificaciones
Conekta dispone de un servicio de notificaciones a usuario final que se activarán por default enviando mails a la dirección de correo del customer del cargo asociado de pago en efectivo.
*Notificaciones que se envían: **
| Notificación | Descripción | Vía |
|---|---|---|
| Generación de la referencia | Cuando se genera la referencia de cobro para que el usuario final acuda a una tienda de conveniencia a pagar | |
| Pago | Cuando el usuario final ha pagado la referencia en cualquier tienda de conveniencia del país | |
| Expiración | Cuando la referencia y el código de barras ya no son válidos para pagar | |
| Cancelación | Cuando la referencia es cancelada por el comercio, se le envía una notificación al usuario final para informar que no tendrá validez la referencia indicada. |
Ejemplo de ficha con referencia de pago en Efectivo en Tiendas OXXO, enviada vía mail.
Ejemplo de ficha con referencia de pago en Efectivo en otros puntos de venta, enviada vía mail.
En este link puedes descargar los logos de nuestra Red de Efectivo.
Notificaciones vía webhook
Esta modalidad de pago a través de Efectivo tiene comunicación directa vía API para cada uno de los momentos de la transacción. Lo que significa que a cada request hay un response exitoso o fallido inmediato con el que puedes conciliar automáticamente.
Sin embargo, todos los eventos que ocurran antes, durante y después de una transacción pueden ser notificados a través de webhooks, justo en el momento en que ocurren. Te enlistamos todos los eventos que intervienen en esta modalidad, accediendo al siguiente enlace para revisar el detalle del payload correspondiente a cada uno de ellos, y mapearlos para llevar a cabo los procesos internos de tu negocio requeridos.
Te recomendamos capturar los siguientes eventos:
| Evento | Descripción |
|---|---|
| order.created | Enviado cuando se crea una referencia de pago en efectivo |
| order.paid | Enviado cuando el cliente completa un pago de forma exitosa |
| order.pending_payment | Enviado cuando una orden es creada pero está pendiente de pago |
Updated over 1 year ago
Puedes probar la funcionalidad con tu API Key Privada de pruebas, lo único que necesitas hacer es crear una orden de pago (por la cantidad que desees) y en automático se pagará. Los eventos que se mencionan arriba en las "Notificaciones vía webhook" se generarán en ese momento.