Cash vouchers en Colombia (COP)

Cash vouchers (antes SafetyPay) cobra en Colombia en pesos colombianos (COP): en efectivo en 4 redes de puntos de pago, o por transferencia en línea desde 44 bancos y billeteras. La petición es la misma que en México: solo cambian currency, apm_config.country y los IDs de banco.

Paso 1: crea la petición

Envía country: "Colombia" y usa channel: "WP" para efectivo y channel: "OL" para transferencia en línea. Cada pago lleva un solo type; dentro de ese tipo, bank_ids acepta más de una entrada. bank_ids es opcional: sin él, la página de SafetyPay muestra todos los bancos de Colombia del canal que enviaste y el cliente elige.

Efectivo (safetypayCash, p. ej. Efecty o SuRed):

{
  "operation_type": "payment",
  "amount": 50000.00,
  "currency": "COP",
  "customer": { "name": "John Doe", "email": "doe@testuser.com" },
  "payment_method": {
    "type": "safetypayCash",
    "apm_config": {
      "country": "Colombia",
      "channel": "WP",
      "bank_ids": [{ "id": "8224" }, { "id": "8323" }]
    }
  },
  "client_reference": "ORD-001",
  "return_url": "https://tu-sitio.com/return"
}

Efectivo (channel: "WP"):

El cliente recibe una referencia en la página de SafetyPay, también por correo, y la paga en un punto de pago de la red.

Transferencia (safetypayTransfer, p. ej. Bancolombia o Nequi):

{
  "operation_type": "payment",
  "amount": 50000.00,
  "currency": "COP",
  "customer": { "name": "John Doe", "email": "doe@testuser.com" },
  "payment_method": {
    "type": "safetypayTransfer",
    "apm_config": {
      "country": "Colombia",
      "channel": "OL",
      "bank_ids": [{ "id": "4099" }, { "id": "8276" }]
    }
  },
  "client_reference": "ORD-001",
  "return_url": "https://tu-sitio.com/return"
}

En línea / Transferencia (channel: "OL"):

1105 (Nequi QR) y 1107 (Nequi PUSH) no filtran por banco: si incluyes cualquiera de los dos en bank_ids, la página de SafetyPay muestra todas las opciones de transferencia, incluido el QR de Nequi, y el cliente elige ahí.

Paso 2: redirige al cliente

El pago empieza en Pending. La respuesta no trae el voucher: apunta a la página de SafetyPay en next_action.redirect_to_url.url, donde el cliente obtiene la referencia y las instrucciones de pago (efectivo) o completa la transferencia en línea. Confirma el estado final del lado del servidor —por webhook o en verify_transaction_status_url— antes de liberar la mercancía. La respuesta completa está en Cash vouchers › Paso 2.

En Colombia, el cliente tiene 3 días para pagar; después, la referencia vence y el pago pasa a Expired.

Límites

Los mínimos y máximos por banco para Colombia están en Límites y reglas de negocio.

Siguientes pasos