OXXO Pay
Genera un voucher de OXXO Pay, cuánto dura y cómo sabes que se pagó.
Acepta pagos en efectivo en las tiendas OXXO de México. OXXO es la cadena de conveniencia más grande del país, ideal para clientes que prefieren pagar en efectivo o no tienen cuenta bancaria.
Cuándo usar OXXO
- Clientes sin cuenta bancaria ni tarjeta.
- Clientes de e-commerce que prefieren efectivo.
- Zonas con alta densidad de tiendas OXXO.
Paso 1: crea la petición
curl -X POST https://stage.tonder.io/api/v1/process/ \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"operation_type": "payment",
"amount": 250.00,
"currency": "MXN",
"customer": { "name": "María Isabel Fernández", "email": "maria.fernandez@email.com" },
"payment_method": { "type": "oxxopay" },
"client_reference": "ORD-001"
}'Paso 2: maneja la respuesta
Los pagos OXXO empiezan en pending e incluyen las instrucciones de pago:
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"operation_type": "payment",
"status": "pending",
"amount": 250.00,
"currency": "MXN",
"payment_instructions": {
"reference_code": "99900012345678",
"barcode": "||99900012345678||",
"store_name": "oxxopay",
"expiration_date": "2024-07-29T23:59:59Z",
"instructions": [
"Acude a cualquier tienda OXXO",
"Presenta este código de barras en caja",
"Paga exactamente $250.00 MXN en efectivo"
]
},
"voucher_pdf": "https://api.tonder.io/vouchers/abc123.pdf",
"created_at": "2024-07-26T10:30:00Z"
}| Campo | Descripción |
|---|---|
id | Identificador único de la transacción —guárdalo para verificar el estado. |
status | Estado del pago —inicialmente pending. |
payment_instructions.reference_code | Código de referencia OXXO Pay. |
payment_instructions.barcode | Código de barras a mostrar al cliente. |
payment_instructions.expiration_date | Fecha de expiración del voucher. |
voucher_pdf | URL para descargar el voucher en PDF. |
La confirmación suele llegar en minutos tras pagar en tienda. Sin embargo, el sistema de OXXO puede
mantener un pago en pending hasta 3 horas mientras verifica fallas internas o posibles reembolsos.
Es comportamiento esperado. Si sigue pending más de 3 horas, contacta a soporte.
Paso 3: muestra las instrucciones
Presenta el barcode de forma que el cliente pueda mostrarlo en caja.
Muestra el reference_code como respaldo si no se puede escanear el código de barras.
Usa el arreglo instructions para guiar al cliente.
Indica cuándo expira el voucher y ofrece descargar el voucher_pdf.
Límites
OXXO Pay tiene un mínimo de $10 MXN y un máximo de $10,000 MXN por transacción. Consulta la tabla completa en Límites.