Cash vouchers
Efectivo en más de 25 cadenas en México y en Caja Vecina y BancoEstado Express en 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 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), en efectivo — channel: "WP". bank_ids
acepta más de una entrada; el ejemplo de abajo ofrece las dos redes.
Efectivo (safetypayCash, p. ej. Caja Vecina o BancoEstado Express):
{
"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": "8241" }, { "id": "8242" }]
}
},
"client_reference": "ORD-001",
"return_url": "https://tu-sitio.com/return"
}Efectivo (channel: "WP"):
| Bank ID | Puntos de pago |
|---|---|
8241 | Caja Vecina |
8242 | BancoEstado Express |
Paso 2: maneja la respuesta
El pago empieza en Pending. La respuesta no trae el voucher ni las instrucciones de pago —
esos viven en la página alojada de SafetyPay, a la que apunta la respuesta vía
next_action.redirect_to_url:
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"operation_type": "payment",
"status": "Pending",
"amount": 180.00,
"currency": "MXN",
"client_reference": "ORD-001",
"metadata": {},
"provider": "tonder",
"created_at": "2026-08-11T10:00:00.000000Z",
"status_code": 201,
"next_action": {
"redirect_to_url": {
"url": "https://sandbox-gateway.safetypay.com/Express4/Checkout/index?TokenID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx&CountryID=MEX&ChannelID=ONLINE",
"verify_transaction_status_url": "/transactions/3fa85f64-5717-4562-b3fc-2c963f66afa6/"
}
}
}Paso 3: redirige al cliente
Envía al cliente a next_action.redirect_to_url.url — la página de SafetyPay, donde obtiene la
referencia y las instrucciones de pago (efectivo) o completa la transferencia en línea.
El pago permanece en Pending hasta que se paga. Confirma el estado final del lado del servidor —
por webhook o consultando la transacción en
verify_transaction_status_url — antes de liberar el pedido.
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.