Cash vouchers

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.

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"
}

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"):

Efectivo + En línea (channel: "WP" o "OL"):

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:

Consulta la tabla completa en Límites.

Otros países

Chile

Cash vouchers en Chile (CLP) —efectivo en Caja Vecina o BancoEstado Express, o transferencia en línea— tiene su propia página: Cash vouchers en Chile (CLP).

Colombia

Cash vouchers en Colombia (COP) —efectivo en Efecty, SuRed, MovilRed o Acciones y Valores, o transferencia en línea desde 44 bancos y billeteras— tiene su propia página: Cash vouchers en Colombia (COP).

Siguientes pasos