ACH (Conta Bancária)

Pagamentos ACH captam fundos diretamente de uma conta bancária dos EUA usando o número da conta e o número de roteamento. Diferentemente dos pagamentos com cartão, o ACH não exige tokenização — os dados bancários são incluídos diretamente na requisição da API.

Nota: pagamentos ACH são sempre capturados imediatamente. Pré-autorização não é suportada para ACH.

Exemplo de Requisição

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 do Método de Pagamento

Tipos de Conta

Resposta

Pagamentos ACH retornam a mesma estrutura de resposta dos pagamentos com cartão. Como capture é true, o status será CAPTURED em caso de sucesso:

{
  "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"
  }
}

Principais Diferenças em Relação aos Pagamentos com Cartão