APICobertura
Países, monedas y rieles disponibles, y lo que puedes hacer en cada uno.
Esta página dice dónde opera la API. Lo que tu empresa tiene habilitado hoy está en GET /v1/limits, en rails.
Pagos por riel
El riel sale del beneficiario. Cada riel paga en su moneda: otra responde 422 currency_not_supported.
| Riel | País | Moneda | Datos de la cuenta | Guía |
|---|---|---|---|---|
mxn_spei | México | MXN | CLABE | Pago SPEI |
usd_ach | Estados Unidos | USD | Número de ruta, cuenta y domicilio | Pago ACH |
usd_wire | Estados Unidos | USD | Número de ruta, cuenta y domicilio | Pago wire |
eur_sepa | Zona euro | EUR | IBAN y BIC | Pago SEPA |
gbp_fps | Reino Unido | GBP | Número de cuenta y sort code | Pago FPS |
cop | Colombia | COP | Llave Bre-B | Pago Bre-B |
pix | Brasil | BRL | Llave PIX | Pago PIX |
latam | Ver Países del riel latam | La del país | Cuenta local, según el país | Pago LatAm |
Un riel habilitado puede no estar disponible por un momento: esa respuesta es 422 rail_unavailable y se repite más tarde. Las capacidades activas para tu empresa están en GET /v1/status.
Qué puedes hacer en cada riel
| Operación | Rieles |
|---|---|
| Registrar beneficiarios y pagar | Todos |
| Cotizar antes de pagar | Todos |
| Cancelar un pago que aún espera fondos | Todos, salvo latam |
| Cobrar | Según el método: ver Cobros |
Países del riel latam
| País | country | currency | account_number | entity | account_type | document_type |
|---|---|---|---|---|---|---|
| Argentina | AR | ARS | CBU o CVU, 22 dígitos | No | No | DNI, CUIL, CUIT |
| Bolivia | BO | BOB | De 5 a 20 dígitos | Obligatorio | Opcional | CED_CIU, NIT |
| Chile | CL | CLP | De 5 a 20 dígitos | Obligatorio | Opcional | RUT, PP |
| Perú | PE | PEN | CCI, 20 dígitos | No | Obligatorio | DNI, RUC, CED_EXT |
La tabla orienta. GET /v1/latam/countries manda: sólo trae los países de tu empresa, con la configuración vigente, y available dice si alguno está restringido por ahora.
Los bancos de cada país están en GET /v1/latam/countries/{country}/entities, y el alta paso a paso en Pago LatAm.
Cobros
Los métodos dependen de tu empresa y cambian con el tiempo. Por eso no se listan aquí: GET /v1/collection-methods da cada método con su país, moneda, mínimo, máximo y lo que pide de quien paga. Ver Cobros.
Redes y tokens
Una dirección de depósito recibe un solo token por una sola red:
chain | currency | Devolución automática |
|---|---|---|
arbitrum | USDC | Sí |
avalanche | USDC | Sí |
base | EURC | Sí |
base | USDC | Sí |
celo | USDC | Sí |
ethereum | EURC | Sí |
ethereum | PYUSD | Sí |
ethereum | USDC | Sí |
ethereum | USDT | Sí |
linea | USDC | No |
optimism | USDC | Sí |
polygon | USDC | Sí |
polygon | USDT | Sí |
solana | EURC | No |
solana | PYUSD | No |
solana | USDC | No |
solana | USDT | No |
tempo | USDC | No |
tempo | USDT | No |
tron | USDT | No |
xdc | USDC | No |
Otra combinación responde 422 pair_not_supported. Al pedirla, chain y currency no distinguen mayúsculas; la respuesta trae chain en minúsculas y currency en mayúsculas. USDT por polygon puede responder 422 pair_not_supported mientras no esté activo. En una red sin devolución automática, un depósito rechazado no regresa solo. Ver Direcciones de depósito.
Cuenta de prueba
Sólo simula SPEI en MXN. Otro riel responde 403 rail_not_enabled, y GET /sandbox/v1/latam/countries da países ficticios con available: false. Ver Qué se simula.
Errores comunes
- Dar por hecho que un riel de esta lista está en tu empresa. Consulta
GET /v1/limits. - Enviar decimales en una moneda que no los lleva. Ver Montos y fechas.