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

Campo	Tipo	Obrigatório	Descrição
`type`	string	Sim	`"BANK_DEPOSIT"`
`accountNumber`	string	Sim	Número da conta bancária (6–20 dígitos)
`routingNumber`	string	Sim	Número de roteamento ABA (9 dígitos)
`accountType`	string	Sim	Tipo de conta (veja abaixo)

Tipos de Conta

Valor	Descrição
`CHECKING`	Conta corrente pessoal
`SAVINGS`	Conta poupança pessoal
`BUSINESS_CHECKING`	Conta corrente empresarial
`BUSINESS_SAVINGS`	Conta poupança empresarial

Resposta

Pagamentos ACH são processados de forma assíncrona. Um 200 com status: "PENDING" significa que o gateway aceitou o pagamento, não que os fundos foram liquidados. Consulte GET /v2/payment/{externalId} ou aguarde o webhook para obter o resultado final — approved: false em um pagamento PENDING não é uma recusa:

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

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

Recurso	Cartão	ACH
Tokenização obrigatória	Sim Sim	Não Não
Pré-autorização	Sim Suportada	Não Não suportada
Ciclo de captura/cancelamento (void)	Sim Ciclo completo	Não Capturado automaticamente
3D Secure	Sim Possível	Não Não aplicável
Reembolso	Sim Suportado	Sim Suportado
Velocidade de liquidação	Mesmo dia – 2 dias	1–3 dias úteis