APIPago ACH
Pagar en dólares a una cuenta de Estados Unidos por ACH.
Para pagar por ACH registras la cuenta con su domicilio, la apruebas en el panel y creas el pago en USD.
Requisitos
| Requisito | Valor |
|---|---|
rail | usd_ach |
| País | Estados Unidos |
| Moneda del pago | USD |
| Datos de la cuenta | Número de ruta, cuenta y domicilio |
| Disponible si | usd_ach aparece en rails de GET /v1/limits. Si no, 403 rail_not_enabled |
| Cuenta de prueba | No se simula: responde 403 rail_not_enabled |
Registra el beneficiario
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
account_number | texto | Sí | Número de cuenta, de 4 a 17 dígitos. |
account_type | texto | Sí | Tipo de cuenta. checking: Cuenta de cheques o corriente. savings: Cuenta de ahorro. |
address | objeto | Sí | Domicilio del titular. |
address.city | texto | Sí | Ciudad. Hasta 100 caracteres. |
address.country | texto | Sí | País, en código de 3 letras. 3 caracteres. |
address.postal_code | texto | Sí | Código postal. Hasta 20 caracteres. |
address.state | texto | Sí | Estado o provincia. Hasta 100 caracteres. |
address.street_line_1 | texto | Sí | Calle y número. De 4 a 35 caracteres. |
holder_name | texto | Sí | Titular de la cuenta destino. Hasta 140 caracteres. |
rail | texto | Sí | Riel de pago. Decide qué campos se piden. usd_ach: ACH, en Estados Unidos. |
routing_number | texto | Sí | Número de ruta, 9 dígitos. |
{
"rail": "usd_ach",
"holder_name": "PROVEEDOR FICTICIO LLC",
"routing_number": "999999999",
"account_number": "000123456789",
"account_type": "checking",
"address": {
"street_line_1": "100 Calle Ficticia",
"city": "Ciudad Ficticia",
"state": "TX",
"postal_code": "00000",
"country": "USA"
}
}address.street_line_1 debe incluir el número de la calle. Sin él, el alta responde 400 invalid_request en address: se valida al registrar para que un pago no falle después por ese dato.
Paga
Aprueba el beneficiario en el panel y crea el pago con POST /v1/payments, con currency en USD. Si te importa el débito, cotiza antes con POST /v1/quotes. El resto del flujo es igual al de Pago SPEI.
Errores comunes
400 invalid_request: revisadetails.fields; el caso típico esaddresssin número de calle.403 rail_not_enabled: el riel no está habilitado para tu cuenta.422 currency_not_supported: el pago no va enUSD.