v1

latestOpenAPI 3.0.12026-07-264182324.3 KB
Payment Methods

This endpoint can be used to verify an ACH payment method to confirm the bank account is valid and belongs to the consumer. To verify a bank account is valid, pass the following parameters into the request:<ul><li><code>ach_aba_pii</code></li><li><code>ach_account_pii</code></li></ul> If successful, the response will include a <code>verification_response</code> and an <code>account_response_code</code> combination that indicates the level of risk. For more information on these combinations, see ACH Verification Services.

post/validate_ach_payment_method

Request body

site_identifierstring

Identifies your client site.

timestampstring

The Unix Epoch time of the call

versionstring

The version of the API. This version must match the version associated with your API key pair.

signaturestring

The HMAC signature that is calculated by running your API Secret Key and the alphabetized, concatenated parameters of the request payload through the SHA256 message digest algorithm.

ach_aba_piistring

The 9-digit ABA/routing number to verify.

ach_account_piistring

The account number of the bank account.

Example request

{
  "ach_aba_pii": "122105278",
  "ach_account_pii": "0000000016"
}

Response

Payment Method Valid

status'ok'

The status of the validation request.

Example response

{
  "giact": {
    "verification_response": "6",
    "account_response_code": "12"
  }
}