ACH Direct Debit

Last updated: December 11, 2024

The Automated Clearing House (ACH) network is an electronic funds transfer system that enables customers in the United States (US) to move money between bank accounts in a fast, secure and paperless way.

Information

To enable ACH payments on your account, contact your Account Manager or [email protected].

Model	Collecting
Payment flow	Direct Debit
Payment method type	Direct
Auto-capture payment
Authorization
Capture
Refund
Partial refund
Multiple refunds
Return
Recurring payment

ACH payments follow a three-step process:

To comply with National Automated Clearing House Association (NACHA) rules, you must obtain consent from the bank account owner before you can collect ACH debit payments from their account.

The consent you present to the customer must:

clearly set out the terms of the authorization
explicitly state that you are obtaining consent to debit the customer's bank account for a specific transaction, or set of recurring transactions
explain how the customer can revoke their direct debit authorization

I authorize [your company name] ("Company") to debit the bank account indicated in this web form for the noted amount on the schedule indicated. I understand that this authorization will remain in effect until the scheduled end date, or until I cancel it in writing, whichever comes first, and I agree to notify the business in writing of any changes in my account information or termination of this authorization at least 15 days prior to the next billing date. If the above noted payment date falls on a weekend or holiday, I understand that the payment may be executed on the next business day. I understand that because this is an electronic transaction, these funds may be withdrawn from my account each period as soon as the above noted transaction date.

You must also:

include NACHA-mandated language in the terms and conditions section
enable your customer to view and print a receipt after the payment has been successfully submitted.
- If you are managing recurring payments, the receipt must have full details of the schedule (payment amount, frequency, start date, end date, and number of payments), along with a confirmation number and date for any transaction processed as part of the schedule
email a receipt to your customer, with a copy to yourself
notify your customer in advance of any change to the scheduled payment amount, payment range or payment date

To process ACH payments, you must validate your customer's bank account. For this validation, you must contract directly with one of NACHA's third-party validation service vendors listed on the Account Validation Resource Center.

For ease of integration, we recommend using Plaid Link due to our built-in support for their Balance and Auth APIs.

Plaid Link provides you with instant account validation and eliminates the need to transmit sensitive bank routing and account numbers.

To use Plaid in your account validation process:

Create a Plaid account.
Create a sandbox API key on the Keys page and make a note of your Plaid client ID.
Select Checkout.com on the Plaid Integrations page.
Call the /link/token/create endpoint to create a Link token.
Initialize Link, open a consent window, and obtain a public token.
Call the /item/public_token/exchange endpoint to obtain an access token.
Call the /processor/token/create endpoint to obtain a Checkout.com processor token. You submit this token when you request a payment using our Payments API.

If you are using other validation service, you must perform account validation on your own before processing the ACH payment.

Once the NACHA Account Validation step is complete, you can submit a payment request.

When we receive the request:

We send a payment_pending webhook before processing the request.
We run syntax validation and compliance checks on the payment data. Plaid implementations also include a balance check.
- If all checks are successful, we set the payment status to pending and send a payment_capture_pending webhook.
- If unsuccessful, we set the payment status to declined and send a payment_declined webhook, in which case the payment process is complete.
ACH payments submitted before midnight Eastern Time will progress to captured status on the following business day before 10:20 AM Eastern Time. Payments will not progress to captured on weekends or banking holidays.

When a payment progresses to captured status, we'll send a payment_captured webhook. Note that the ACH network does not provide final confirmation of payment completion. The only indicator of a successful payment is the absence of a return. To minimize exposure to a return, some businesses choose to retain assets for seven to ten calendar days following an ACH payment.

Captured payments are settled according to your standard settlement schedule and appear in your financial reconciliation reports. To expedite ACH network payments, you can request same-day settlement. For more information, see Same Day ACH.

If the recipient bank returns a successfully processed payment, we set the payment status to returned and send a payment_returned webhook. Typically, an ACH network or bank return is reported within a few business days; however, the account holder can return a payment for up to 60 days.

Checkout.com supports Same Day ACH, an accelerated ACH settlement at an increased cost. A standard ACH payment typically takes two business days to settle, but in a same-day payment, ACH settles you within one business day.

When setting up ACH payments for your account, configure your settlement service to default to either standard settlement or Same Day ACH. You can override this default setting in specific payment requests by setting processing.service_type to standard or sameday.

Same Day ACH offers no accelerated timing benefits between 4pm and 11:59:59pm ET. Payments submitted during this time window always default to standard settlement regardless of your configuration or request settings.

To comply with regulatory requirements and reduce the likelihood of bank declines or fraud, you must provide the following values within the account_holder object:

if the account_holder.type is individual, provide the account_holder.first_name and account_holder.last_name fields
if the account_holder.type is corporate, provide the account_holder.company_name field

Information

Typically, the bank account holder's name is on file within your database. Otherwise, Plaid implementations can obtain the name through the accounts.owners.names object in the response from Plaid's /identity/get endpoint.

post

https://api.checkout.com/payments


1{
2  "source": {
3    "type": "plaid",
4    "token": "<PLAID_PROCESSOR_TOKEN>",
5    "account_holder": {
6      "type": "individual",
7      "first_name": "John",
8      "last_name": "Doe"
9    }
10},
11  "amount": "6540",
12  "currency": "USD",
13  "processing_channel_id": "pc_ovo75iz4hdyudnx6tu74mum3fq"
14}


1{
2  "source": {
3    "type": "ach",
4    "account_type": "savings",
5    "country": "US",
6    "account_number": "1234567890",
7    "bank_code": "021000021",
8    "account_holder": {
9        "type": "individual",
10        "first_name": "John",
11        "last_name": "Doe"
12      }
13  },
14  "amount": "6540",
15  "currency": "USD",
16  "processing_channel_id": "pc_ovo75iz4hdyudnx6tu74mum3fq"
17}

If you receive a 202 Accepted response with a status field set to Pending, your request was successful.


1{
2  "id": "pay_itm5maobcrne5fbbafuu2mw3le",
3  "status": "Pending",
4  "_links": {
5    "self": {
6      "href": "https://api.sandbox.checkout.com/payments/pay_itm5maobcrne5fbbafuu2mw3le"
7    }
8  }
9}


1{
2  "id": "pay_ki4evicwaxyerc3ogrkdtetg6i",
3  "status": "Pending",
4  "source": {
5    "id": "src_kb2gep7wak7ublhgf4jzab2gz4",
6    "type": "ach"
7  },
8  "_links": {
9    "self": {
10      "href": "https://api.sandbox.checkout.com/payments/pay_ki4evicwaxyerc3ogrkdtetg6i"
11    }
12  }
13}

post

https://api.checkout.com/payments

Recurring payments with Plaid occasionally require the user to re-authenticate with Plaid Link's update mode.


1{
2  "source": {
3    "type": "plaid",
4    "token": "<PLAID_PROCESSOR_TOKEN>",
5    "account_holder": {
6      "type": "individual",
7      "first_name": "John",
8      "last_name": "Doe"
9    }
10  },
11  "amount": "6540",
12  "currency": "USD",
13  "processing_channel_id": "pc_ovo75iz4hdyudnx6tu74mum3fq"
14}


1{
2  "source": {
3    "type": "id",
4    "id": "src_yn62j25j3kvuthctvnnq76n4mi"
5  },
6  "amount": 2000,
7  "currency": "USD"
8}

If you receive a 202 Accepted response with a status field set to Pending, your request was successful.


1{
2  "id": "pay_itm5maobcrne5fbbafuu2mw3le",
3  "status": "Pending",
4  "_links": {
5    "self": {
6      "href": "https://api.sandbox.checkout.com/payments/pay_itm5maobcrne5fbbafuu2mw3le"
7    }
8  }
9}


1{
2  "id": "pay_gpogdbx73ppejkf7fbdodo5lra",
3  "status": "Pending",
4  "source": {
5    "id": "src_yn62j25j3kvuthctvnnq76n4mi",
6    "type": "ach"
7  },
8  "_links": {
9    "self": {
10      "href": "https://api.sandbox.checkout.com/payments/pay_gpogdbx73ppejkf7fbdodo5lra"
11    }
12  }
13}

For the full API specification, see the API reference.

get

https://api.checkout.com/payments/{payment_id}


1{
2  "id": "pay_itm5maobcrne5fbbafuu2mw3le",
3  "status": "Pending",
4  "reference": "reference_example",
5  "_links": {
6    "self": {
7      "href": "https://api.sandbox.checkout.com/payments/pay_itm5maobcrne5fbbafuu2mw3le"
8    }
9  }
10}


1{
2  "id": "pay_ki4evicwaxyerc3ogrkdtetg6i",
3  "status": "Pending",
4  "reference": "reference_example",
5  "source": {
6    "id": "src_kb2gep7wak7ublhgf4jzab2gz4",
7    "type": "ach"
8  },
9  "_links": {
10    "self": {
11      "href": "https://api.sandbox.checkout.com/payments/pay_ki4evicwaxyerc3ogrkdtetg6i"
12    }
13  }
14}

You can use our Refund API to fully or partially refund a payment. Once refunded, the payment status updates to refunded, and you receive a payment_refunded webhook notification.

After the payment status changes to captured, you can submit a request to process a full or partial refund. After receiving it, we send a payment_refund_pending webhook but do not change the payment status. If the processor token is revoked before the refund occurs, you may need to re-authenticate the user in Plaid Link's update mode. The flow and timing for refunds are the same as for payments.

After a refund request is successfully sent to the ACH network (within one to three business days), we set the payment status to refunded or partially_refunded and send a payment_refunded webhook.

If you issue a refund, you should notify your customer as soon as possible to prevent them from simultaneously canceling the payment with their bank. If your customer does get credited twice, you must contact them directly to resolve the situation.

If the refund is declined by the ACH network or bank (typically within one to three business days), the payment status is set to payment_refund_declined.

The ACH network uses Notification of Change (NOC) messages to enable financial institutions to communicate updates and corrections to bank account details. For example, changes in account or routing numbers, or incorrect account types.

The Receiving Depository Financial Institution (RDFI) sends an NOC to the Originating Depository Financial Institution (ODFI) when an ACH entry is outdated or incorrect.

After receiving an NOC, Checkout.com sends you a bank_account_updated webhook request with the necessary information for you to update your payment instruments. Updating your payment details based on the NOC ensures seamless and uninterrupted transactions.

ACH uses NOC codes to describe the specific nature of the change. Our integration supports the following NOC codes:

ACH NOC code	Description
`C01`	Incorrect bank account number
`C02`	Incorrect transit/routing number
`C03`	Incorrect transit/routing number and bank account number
`C04`	Bank account name change
`C05`	Incorrect account type
`C06`	Incorrect bank account number and transit code
`C07`	Incorrect transit/routing number, bank account number, and account type

For instructions on testing NOC codes, see the Test ACH payments section.

An ACH return indicates that your bank, also known as the Receiving Depository Financial Institution (RDFI), could not collect the funds from your customer's account. A return can happen for various reasons, for example:

the customer has insufficient funds in their bank account
the customer’s bank account is closed or frozen
the customer claims that they do not recognize the purchase and did not authorize it

See ACH returns explained for more information.

You can avoid returns caused by outdated banking information by listening to the bank_account_updated webhook.

When a return happens, you'll receive a payment_returned webhook notification.

ACH return codes identify the reason an ACH payment could not be collected from a customer's account. These codes provide additional information about the cause of the issue.

ACH code	Description	API response code
`R01`	Insufficient funds	`20051`
`R03`	No account or unable to locate account	`20083`
`R04`	Invalid account number	`20083`
`R19`	Amount field error	`30020`
`R02`	Account closed	`30046`
`R18`	Improper effective entry date	`200T2`
`R07`	Authorization revoked by customer	`20R07`
`R08`	Payment stopped or stop payment on item	`20R08`
`R09`	Uncollected funds	`20R09`
`R10`	Customer advises not authorized	`20R10`
`R11`	Customer advises entry not in accordance with the terms of the authorization	`20R11`
`R17`	File record edit criteria	`20R17`
`R21`	Invalid company identification	`20R21`
`R22`	Invalid individual ID number	`20R21`
`R24`	Duplicate entry	`20R24`
`R25`	Addenda error	`20R25`
`R26`	Mandatory field error	`20R26`
`R27`	Trace number error	`20R27`
`R29`	Corporate customer advises not authorized	`20R29`
`R31`	Permissible return entry	`20R31`
`R32`	RDFI non-settlement	`20R32`
`R33`	Return of XCK entry	`20R33`
`R35`	Return of improper debit entry	`20R35`
`R36`	Return of improper credit entry	`20R36`
`R37`	Source document presented for payment	`20R37`
`R38`	Stop payment on source document	`20R38`
`R05`	Unauthorized debit to consumer account	`30R05`
`R06`	Returned per ODFI's request	`30R06`
`R12`	Branch sold to another DFI	`30R12`
`R13`	Invalid ACH routing number	`30R13`
`R14`	Representment payee deceased or unable to continue in that capacity	`30R14`
`R15`	Beneficiary of account holder deceased	`30R15`
`R16`	Account frozen	`30R16`
`R20`	Non-transaction account	`30R20`
`R23`	Credit entry refused by receiver	`30R23`
`R28`	Routing number or check digit error	`30R28`
`R30`	RDFI not participant in check truncation program	`30R30`
`R34`	Limited participation DFI	`30R34`

When using ACH, you may receive the following webhooks.

For more details about these webhooks, see Webhook

Webhook	Description
`payment_pending`	Sent when a merchant initiates a payment request.
`payment_capture_pending`	Sent when a payment request has been successfully initiated and the payment capture is pending.
`payment_declined`	Sent when a payment request has been rejected. We send this webhook after unsuccessful real-time checks on the payment, including data validation, compliance, and balance availability (Plaid Link only). Typically, around 100 milliseconds after `payment_pending`.
`payment_captured`	Sent when a payment has been successfully captured. Typically, one to two business days after `payment_capture_pending`.
`payment_returned`	There was a failure after an initial success scenario. Money will be moved out the merchant's account. Sent if a payment is returned due to an ACH network decline, bank decline or customer dispute. ACH network and bank declines typically occur within a few business days, but customers can dispute for up to 60 days.
`payment_refund_pending`	Occurs when a refund request has successfully initiated.
`payment_refunded`	Occurs when a refund is successful. Sent once a refund is sent to the ACH network. Typically, one to three business days after `payment_refund_pending`.
`payment_refund_declined`	Occurs when a refund is declined. Typically, one to three business days after `payment_refund_pending`.
`bank_account_updated`	Sent when the customer's bank account details have changed and must be updated for future payments. This webhook sends two objects: `original_bank_account` `replacement_bank_account` Use the new bank account details returned in the `replacement_bank_account` object to update your payment instruments. View a bank account updated webhook example.

You can send test requests using the values from the following table, depending on which outcome you want to simulate:

API response code	ACH code	Payment status	Webhook	Values
`10000`	N/A	`Captured`	`payment_captured`	Corporate and personal accounts: `bank_code: 021000021` `account_number: 1234567890`
`20000`	N/A	`Declined`	`payment_declined`	Corporate accounts: `bank_code: 091000022` `company_name: Green Co` Personal accounts: `bank_code: 091000022` `first_name: Green` `last_name: Co`
`20051`	`R01`	`Returned`	`payment_returned`	Corporate accounts: `bank_code: 011075150` `company_name: Widget Inc` Personal accounts: `bank_code: 011075150` `first_name: Widget` `last_name: Inc`
`30046`	`R02`	`Returned`	`payment_returned`	Corporate and personal accounts: `account_number: 9999999999`
`30R05`	`R05`	`Returned`	`payment_returned`	Corporate and personal accounts: `bank_code: 122105155`
`20R07`	`R07`	`Returned`	`payment_returned`	Corporate and personal accounts: `bank_code: 082000549`
`20R10`	`R10`	`Returned`	`payment_returned`	Corporate and personal accounts: `bank_code: 121122676`
`20R29`	`R29`	`Returned`	`payment_returned`	Corporate and personal accounts: `bank_code: 122235821`
`10000`	`C01`	`Captured`	`bank_account_updated`	Corporate accounts: `account_number: 8888888888` `company_name: Checkout Inc` Personal accounts: `account_number: 8888888888` `first_name: Checkout` `last_name: Inc`
`10000`	`C02`	`Captured`	`bank_account_updated`	Corporate accounts: `bank_code: 011075150` `company_name: Green Co` Personal accounts: `bank_code: 011075150` `first_name: Green` `last_name: Co`
`10000`	`C03`	`Captured`	`bank_account_updated`	Corporate accounts: `bank_code: 011075150` `company_name: Yellow Co` Personal accounts: `bank_code: 011075150` `first_name: Yellow` `last_name: Co`
`10000`	`C04`	`Captured`	`bank_account_updated`	Corporate accounts: `bank_code: 011075150` `company_name: John Doe` Personal accounts: `bank_code: 011075150` `first_name`: John `last_name`: Doe
`10000`	`C05`	`Captured`	`bank_account_updated`	Corporate accounts: `bank_code: 011075150` `company_name: Gray Co` Personal accounts: `bank_code: 011075150` `first_name: Gray` `last_name: Co`
`10000`	`C06`	`Captured`	`bank_account_updated`	Corporate accounts: `bank_code: 011075150` `company_name: Amber Co` Personal accounts: `bank_code: 011075150` `first_name: Amber` `last_name: Co`
`10000`	`C07`	`Captured`	`bank_account_updated`	Corporate accounts: `bank_code: 011075150` `company_name: Orange Co` Personal accounts: `bank_code: 011075150` `first_name: Orange` `last_name: Co`

ACH Direct Debit

Information

Collect customer consent

Validate your customer account

Payment flow and timing

Same Day ACH

Request an initial payment

Information

Request examples

Response examples

Request a recurring payment

Request examples

Response examples

Get details about a payment

Response examples

Refund a payment

Refunded payment flow

Successful refund

Unsuccessful refund

Notification of change

NOC Codes

Returns

Return codes

Webhooks

Test ACH payments