Cash vouchers
Efectivo en más de 25 cadenas en México y Chile, con los IDs de banco de cada red.
Cash vouchers (antes SafetyPay) es un método de pago en efectivo que opera en América Latina. Es ideal para regiones sin cobertura de OXXO o para ofrecer opciones de efectivo adicionales.
Cuándo usar Cash vouchers
- Clientes en regiones sin cobertura de OXXO.
- Ampliar las opciones de pago en efectivo más allá de las tiendas de conveniencia.
- Mercados donde la red de Cash vouchers tiene puntos de pago establecidos.
Esta guía documenta México y Chile. Cash vouchers (SafetyPay) también opera en otros países de América Latina; consulta Cobertura por país o contacta a tu gerente de integración para confirmar disponibilidad y proveedores locales en tu mercado.
Paso 1: crea la petición
Cash vouchers admite dos tipos: efectivo (safetypayCash) y transferencia (safetypayTransfer).
Ambos requieren un objeto apm_config con channel y bank_ids (channel: "WP" para efectivo,
channel: "OL" para transferencia en línea).
Efectivo (safetypayCash):
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": 180.00,
"currency": "MXN",
"customer": { "name": "Patricia Morales Vega", "email": "patricia.morales@email.com" },
"payment_method": {
"type": "safetypayCash",
"apm_config": {
"country": "Mexico",
"channel": "WP",
"bank_ids": [{ "id": "8178" }]
}
},
"client_reference": "ORD-001",
"return_url": "https://tu-sitio.com/return"
}'Transferencia (safetypayTransfer):
{
"operation_type": "payment",
"amount": 180.00,
"currency": "MXN",
"customer": { "name": "Patricia Morales Vega", "email": "patricia.morales@email.com" },
"payment_method": {
"type": "safetypayTransfer",
"apm_config": {
"country": "Mexico",
"channel": "OL",
"bank_ids": [{ "id": "1020" }]
}
},
"client_reference": "ORD-001",
"return_url": "https://tu-sitio.com/return"
}El identificador del método en la API sigue siendo SAFETYPAY (y los canales safetypayCash /
safetypayTransfer). Solo cambió el nombre visible a Cash vouchers.
Bank IDs disponibles — México
Usa channel: "WP" para efectivo y channel: "OL" para transferencia en línea. Los bancos en la
sección Efectivo + En línea admiten ambos canales.
Solo efectivo (channel: "WP"):
| Bank ID | Puntos de pago |
|---|---|
8178 | Bodega Aurrera, Circle K, OpenPay, Super Farmacia Guadalajara, 7-Eleven, Farmacias del Ahorro, Sam's Club, Walmart, Extra, Waldo's, GestoPago, Kiosko, Pago Rápido |
8419 | Calimax, Super Farmacia Santa María, Farmacia La Más Barata, Roma, PayCash, Soriana |
Efectivo + En línea (channel: "WP" o "OL"):
| Bank ID | Banco |
|---|---|
8186 | Banco Azteca |
8395 | Santander |
1020 | BBVA Bancomer |
1007 | Scotiabank |
Chile
Cash vouchers también opera en Chile (moneda CLP). Usa channel: "WP" para efectivo y
channel: "OL" para transferencia en línea.
Efectivo (safetypayCash, p. ej. Walmart, Líder, Express de Líder, Acuenta):
{
"operation_type": "payment",
"amount": 200.00,
"currency": "CLP",
"customer": { "name": "John Doe", "email": "doe@testuser.com" },
"payment_method": {
"type": "safetypayCash",
"apm_config": {
"country": "Chile",
"channel": "WP",
"bank_ids": [{ "id": "8198" }]
}
},
"client_reference": "ORD-001",
"return_url": "https://tu-sitio.com/return"
}Transferencia (safetypayTransfer, p. ej. Banco BCI):
{
"operation_type": "payment",
"amount": 200.00,
"currency": "CLP",
"customer": { "name": "John Doe", "email": "doe@testuser.com" },
"payment_method": {
"type": "safetypayTransfer",
"apm_config": {
"country": "Chile",
"channel": "OL",
"bank_ids": [{ "id": "8296" }]
}
},
"client_reference": "ORD-001",
"return_url": "https://tu-sitio.com/return"
}Solo efectivo (channel: "WP"):
| Bank ID | Puntos de pago |
|---|---|
8198 | Walmart, Líder, Express de Líder, Acuenta |
En línea / Transferencia (channel: "OL"):
| Bank ID | Banco |
|---|---|
8296 | Banco BCI |
8416 | Machpay |
8488 | Khipu |
8490 | Khipu — Banco de Chile |
8494 | Khipu — Itaú |
8491 | Khipu — Santander |
Paso 2: maneja la respuesta
Los pagos con Cash vouchers empiezan en pending e incluyen el voucher y las instrucciones:
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"operation_type": "payment",
"status": "pending",
"amount": 180.00,
"currency": "MXN",
"payment_instructions": {
"reference_code": "SP180456789",
"payment_locations": [
"Tiendas de conveniencia autorizadas",
"Farmacias participantes",
"Supermercados afiliados"
],
"expiration_date": "2024-07-29T23:59:59Z",
"instructions": [
"Acude a un punto de pago autorizado",
"Presenta el código de referencia",
"Paga exactamente $180.00 MXN en efectivo"
]
},
"voucher_url": "https://api.safetypay.com/vouchers/abc123",
"store_locator": "https://safetypay.com/locator?ref=SP180456789",
"created_at": "2024-07-26T10:30:00Z"
}Paso 3: muestra las instrucciones
Presenta el reference_code que el cliente usará en los puntos de pago.
Muestra los tipos de ubicaciones de payment_locations.
Agrega el enlace store_locator para encontrar puntos cercanos.
Muestra claramente cuándo expira el voucher.
Límites por tipo de tienda
Cash vouchers tiene un mínimo de $10 MXN; el máximo depende del tipo de tienda:
| Tienda | Máximo (MXN) |
|---|---|
| 7-Eleven / Circle K | $5,000 |
| Walmart / Sam's / Bodega | $20,000 |
| Soriana / Calimax | $10,000 |
Consulta la tabla completa en Límites.