Cash vouchers

Cash at 25+ chains in Mexico and at Caja Vecina and BancoEstado Express in Chile, with the bank IDs for each network.

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 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), as cash — channel: "WP". bank_ids accepts more than one entry; the example below offers both networks.

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

Cash (channel: "WP"):

Bank ID	Collection points
`8241`	Caja Vecina
`8242`	BancoEstado Express

Step 2: handle the response

The payment starts in Pending. The response does not carry the voucher or payment instructions — those live on SafetyPay's hosted page, which the response points to via 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/"
    }
  }
}

Step 3: redirect the customer

Send the customer to next_action.redirect_to_url.url — SafetyPay's page, where they get the reference and payment instructions (cash) or complete the transfer online.

The payment stays Pending until it's paid. Confirm the final status server-side — by webhook or by polling the transaction at verify_transaction_status_url — before releasing goods.

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: redirect the customer

Limits by store type

Next steps

APM payments in API Direct

APM test cases

On this page