ACH (Cuenta Bancaria)

Los pagos ACH extraen fondos directamente de una cuenta bancaria de EE. UU. usando el número de cuenta y el número de ruta. A diferencia de los pagos con tarjeta, ACH no requiere tokenización — los datos bancarios se incluyen directamente en la solicitud a la API.

Nota: Los pagos ACH siempre se capturan inmediatamente. La preautorización no está soportada para ACH.

Ejemplo de Solicitud

curl -X POST https://{FQDN}/v2/payment \
  -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIs...' \
  -H 'Content-Type: application/json' \
  -d '{
    "externalPaymentId": "b7e4c2a1-9f3d-4e8a-a5c6-2d1f0e9b8a73",
    "ipAddress": "203.0.113.42",
    "paymentType": "PULL",
    "capture": true,
    "amount": {
      "total": 201.99,
      "currency": "USD"
    },
    "sender": {
      "firstName": "John",
      "lastName": "Smith",
      "address": {
        "countryCode": "USA",
        "stateCode": "NY",
        "city": "New York",
        "line1": "123 Main Street",
        "zipCode": "10001"
      },
      "paymentMethod": {
        "type": "BANK_DEPOSIT",
        "countryCode": "USA",
        "bankCode": "*****0021",
        "accountNumber": "*************6789",
        "routingNumber": "*****0021",
        "accountType": "CHECKING",
        "accountTokenId": "f2a6d8c4-1e3b-4a59-b7d0-5c8e9f1a2b34"
      }
    }
  }'

Campos del Método de Pago

Campo	Tipo	Requerido	Descripción
`type`	string	Sí	`"BANK_DEPOSIT"`
`accountNumber`	string	Sí	Número de cuenta bancaria (6–20 dígitos)
`routingNumber`	string	Sí	Número de ruta ABA (9 dígitos)
`accountType`	string	Sí	Tipo de cuenta (ver abajo)

Tipos de Cuenta

Valor	Descripción
`CHECKING`	Cuenta corriente personal
`SAVINGS`	Cuenta de ahorros personal
`BUSINESS_CHECKING`	Cuenta corriente empresarial
`BUSINESS_SAVINGS`	Cuenta de ahorros empresarial

Respuesta

Los pagos ACH se procesan de forma asíncrona. Un 200 con status: "PENDING" significa que el gateway aceptó el pago, no que los fondos se hayan liquidado. Consulte GET /v2/payment/{externalId} o espere el webhook para obtener el resultado final — approved: false en un pago PENDING no es un rechazo:

{
  "amount": 201.99,
  "status": "PENDING",
  "created": "2026-10-11 02:52:20",
  "message": "Payment Pending",
  "approved": false,
  "currency": "USD",
  "paymentId": "3c9a1e57-6b2d-4f80-9e14-a7d5c3b2f601",
  "responseCode": "01",
  "parentPaymentId": "3c9a1e57-6b2d-4f80-9e14-a7d5c3b2f601",
  "externalPaymentId": "b7e4c2a1-9f3d-4e8a-a5c6-2d1f0e9b8a73"
}

Diferencias Clave con los Pagos con Tarjeta

Característica	Tarjeta	ACH
Requiere tokenización	Sí Sí	No No
Preautorización	Sí Soportada	No No soportada
Ciclo de captura/anulación (void)	Sí Ciclo completo	No Captura automática
3D Secure	Sí Posible	No No aplicable
Reembolso	Sí Soportado	Sí Soportado
Velocidad de liquidación	Mismo día – 2 días	1–3 días hábiles