ACH Payments

Charging ACH Accounts

The following provides guidance for accepting Automated Clearing House (ACH) payments using the Payments API.

Unlike credit card payments, when an ACH payment is authorized, funds are withdrawn directly from his or her bank account and can take several days to settle.

In order to accept ACH or eCheck, you must collect and tokenize the customer’s bank account and routing number. It is best practice to tokenize this information using the Runner.js integrated web form.

Usage

To process an ACH payment, make a Charge request using the Payments API. In addition to the required fields, please include the following information in the parameters:

• Tokenized account and routing information (tokenized using Runner.js)
• Payment origin com_ind, which identifies the card not present transaction origin as telephone, recurring, ecomm, or mobile app.

Required Fields for ACH

The following fields are specifically required for ACH transactions (compatible with Fiserv ACH gateway). These are additional required fields beyond the standard charge request fields:

• payment_description - Short description of what the payment is for
• ach_discretionary_data - Required for WEB entry class code, Optional for TEL entry class code:
  • "S" for single transaction
  • "R" for recurring transaction
• entry_class - ACH entry class code: WEB, TEL, CCD, or PPD
• credit_or_debit - Transaction type: credit or debit

Minimum Viable ACH Transaction

The following example shows the minimum required fields for processing an ACH transaction:

1
{
2
    "mid": "5034627",
3
    "amount": "200.00",
4
    "account_token": "22292425",
5
    "payment_description": "Rent Payment",
6
    "ach_discretionary_data": "S",
7
    "entry_class": "TEL",
8
    "name": "Jim Blick",
9
    "capture": "Y",
10
    "credit_or_debit": "debit",
11
    "custom_01": "asd",
12
    "custom_02": "ddd",
13
    "custom_03": "fff",
14
    "custom_04": null,
15
    "custom_05": null
16
}

Testing ACH Authorizations

Sample ACH Payment Information

To test ACH transactions, you must use a valid ABA routing number. Below we have provided a test account and routing number that you can tokenize with Runner.js and pass in a charge request using the Payments API.

• Sample ABA Routing Number: 036001808
• Sample Account Number: 86063057

Funding

The funding endpoint provides merchant funding information and supplemental transaction and funding adjustment information. These details are provided by the host payment processing platform.

For merchants with next day funding, funding data is available between 1pm - 6pm ET on the day following settlement. For merchants without next day funding, funding data is available within 1 - 2 business days following settlement, between 1pm - 6pm ET.

A request to the funding endpoint returns all available funding data for the merchant on the date specified, including:

• Fundings
• Transactions
• Adjustments
• Chargebacks

If no available available batches are found for the specified date, the Reporting API will provide an error stating “No deposits match your request”.