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": "ach-order-001",
    "ipAddress": "203.0.113.42",
    "paymentType": "PULL",
    "capture": true,
    "amount": {
      "total": 19.99,
      "currency": "USD"
    },
    "sender": {
      "firstName": "John",
      "lastName": "Smith",
      "address": {
        "countryCode": "US",
        "stateCode": "NY",
        "city": "New York",
        "line1": "123 Main Street",
        "line2": "Apt 25B",
        "zipCode": "10001"
      },
      "paymentMethod": {
        "type": "BANK_DEPOSIT",
        "accountNumber": "123456789",
        "routingNumber": "021000021",
        "accountType": "CHECKING"
      }
    }
  }'

Campos del Método de Pago

Tipos de Cuenta

Respuesta

Los pagos ACH devuelven la misma estructura de respuesta que los pagos con tarjeta. Dado que capture es true, el estado será CAPTURED en caso de éxito:

{
  "status": 200,
  "data": {
    "paymentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "parentPaymentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "externalPaymentId": "ach-order-001",
    "amount": 19.99,
    "created": "2025-03-31 10:15:30",
    "approved": true,
    "message": "Payment Approved",
    "status": "CAPTURED",
    "captured": true,
    "voided": false,
    "responseCode": "00"
  }
}

Diferencias Clave con los Pagos con Tarjeta