Cash vouchers

Cash vouchers (formerly SafetyPay) is a cash payment method operating across Latin America. It's ideal for regions without OXXO coverage or to offer additional cash options.

When to use Cash vouchers

Customers in regions without OXXO coverage.
Expanding cash payment options beyond convenience stores.
Markets where the Cash vouchers network has established payment points.

This guide documents Mexico and Chile. Cash vouchers (SafetyPay) also operates in other Latin American countries; see Country coverage or contact your integration manager to confirm availability and local providers in your market.

Step 1: create the request

Cash vouchers supports two types: cash (safetypayCash) and transfer (safetypayTransfer). Both require an apm_config object with channel and bank_ids (channel: "WP" for cash, channel: "OL" for online transfer).

Cash (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://your-site.com/return"
  }'

Transfer (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://your-site.com/return"
}

The API method identifier is still SAFETYPAY (and the channels safetypayCash / safetypayTransfer). Only the display name changed to Cash vouchers.

Available bank IDs — Mexico

Use channel: "WP" for cash and channel: "OL" for online transfer. Banks in the Cash + Online section support both channels.

Cash only (channel: "WP"):

Bank ID	Collection points
`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

Cash + Online (channel: "WP" or "OL"):

Bank ID	Bank
`8186`	Banco Azteca
`8395`	Santander
`1020`	BBVA Bancomer
`1007`	Scotiabank

Chile

Cash vouchers also operates in Chile (currency CLP). Use channel: "WP" for cash and channel: "OL" for online transfer.

Cash (safetypayCash, e.g. 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://your-site.com/return"
}

Transfer (safetypayTransfer, e.g. 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://your-site.com/return"
}

Cash only (channel: "WP"):

Bank ID	Collection points
`8198`	Walmart, Líder, Express de Líder, Acuenta

Online / Transfer (channel: "OL"):

Bank ID	Bank
`8296`	Banco BCI
`8416`	Machpay
`8488`	Khipu
`8490`	Khipu — Banco de Chile
`8494`	Khipu — Itaú
`8491`	Khipu — Santander

Step 2: handle the response

Cash voucher payments start in pending and include the voucher and instructions:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "operation_type": "payment",
  "status": "pending",
  "amount": 180.00,
  "currency": "MXN",
  "payment_instructions": {
    "reference_code": "SP180456789",
    "payment_locations": [
      "Authorized convenience stores",
      "Participating pharmacies",
      "Affiliated supermarkets"
    ],
    "expiration_date": "2024-07-29T23:59:59Z",
    "instructions": [
      "Go to an authorized payment point",
      "Present the reference code",
      "Pay exactly $180.00 MXN in cash"
    ]
  },
  "voucher_url": "https://api.safetypay.com/vouchers/abc123",
  "store_locator": "https://safetypay.com/locator?ref=SP180456789",
  "created_at": "2024-07-26T10:30:00Z"
}

Step 3: display the instructions

Display the reference_code the customer uses at payment locations.

Show the location types from payment_locations.

Add the store_locator link to find nearby points.

Clearly show when the voucher expires.

Limits by store type

Cash vouchers has a minimum of $10 MXN; the maximum depends on the store type:

Store	Maximum (MXN)
7-Eleven / Circle K	$5,000
Walmart / Sam's / Bodega	$20,000
Soriana / Calimax	$10,000

See the full table in Limits.

Cash vouchers

When to use Cash vouchers

Step 1: create the request

Available bank IDs — Mexico

Chile

Step 2: handle the response

Step 3: display the instructions

Limits by store type

Next steps

APM payments in API Direct

APM test cases

On this page