Are you looking for test card numbers?

Would you like to contact support?

Payment-method icon

ACH Direct Debit Component

Add ACH Direct Debit to an existing Components integration.

On this page, you can find additional configuration for adding ACH Direct Debit to your Components integration.

Before you begin

This page assumes you have already:

API reference

Select which endpoint you're integrating:

This is the default with Web Components v5.0.0 or later.

Parameter name Required Description
billingAddress -white_check_mark- The postal address of the shopper. Recommended to increase conversion rates.
curl https://checkout-test.adyen.com/v69/sessions \
-H "x-API-key: YOUR_X-API-KEY" \
-H "content-type: application/json" \
-d '{
  "merchantAccount": "YOUR_MERCHANT_ACCOUNT",
  "amount": {
      "value": 1000,
      "currency": "USD"
  },
  "returnUrl": "https://your-company.com/checkout?shopperOrder=12xy..",
  "reference": "YOUR_ORDER_NUMBER",
  "countryCode": "US",
  "billingAddress":{
      "city":"Amsterdam",
      "country":"US",
      "houseNumberOrName":"50",
      "postalCode":"12010",
      "stateOrProvince":"NY",
      "street":"Test Street"
  }
}'

Component configuration

Step 1: Create a DOM element

Create a DOM element on your checkout page, placing it where you want the payment method form to be rendered:

 <div id="ach-container"></div>

Step 2: Create an instance of the Component

Use the create method of your AdyenCheckout instance, in this case checkout, to create the Component:

const achDirectDebitComponent = checkout.create('ach').mount('#ach-container');

Optional configuration

When creating an instance of Components, you can optionally include the following parameters in the payment methods configuration object:

Field Description Default
enableStoreDetail
v5.24.0 or later
Set to true to show the checkbox for saving the payment details. false

Payment outcome

After we successfully received your request, it may take up to five business days to know whether the payment was authorised by the bank. If the bank authorised the payment, it will appear in the Settlement details report. If the bank failed to authorise the payment, you will receive a CHARGEBACK webhook.

Chargebacks

ACH Direct Debit payments can fail when:

  • There was a problem with settlement, for example because the account had insufficient funds, had been closed, or the account number was invalid.

  • The shopper asked their bank for a refund. This is referred to as a chargeback. Shoppers can reverse an ACH payment up to 60 days after settlement for one of the following reasons:

    • They did not formally agree to the charge, or revoked such an agreement.
    • The charge is processed earlier than the agreed date.
    • The charge is different than the agreed amount.

    This is different from credit card transactions, where a customer can initiate a chargeback by claiming that a product or service was not what they expected.

    You cannot defend ACH Direct Debit chargebacks. These will always result in the payment being reversed.

    For more information on the chargeback process, refer to Dispute management.

If an ACH Direct Debit payment fails, you will receive a CHARGEBACK webhook, and your Settlement details report will show a credit and a corresponding debit.

CHARGEBACK webhook
{
  "live": "false",
  "notificationItems": [
    {
      "NotificationRequestItem": {
        "additionalData": {
          "modificationMerchantReferences": ""
        },
        "amount": {
          "currency": "USD",
          "value": 1000
        },
        "eventCode": "CHARGEBACK",
        "eventDate": "2019-03-20T15:40:27+01:00",
        "merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
        "merchantReference": "YOUR_PAYMENT_REFERENCE",
        "originalReference": "161552590902659C",
        "paymentMethod": "ach",
        "pspReference": "181552594831625C",
        "reason": "Chargeback",
        "success": "true"
      }
    }
  ]
}

Test and go live

Before making live ACH Direct Debit payments, use the following account details to test your integration.

Account Owner's Name Bank account number Bank routing number Account Owner's Address
Any name Any correctly formatted account number. Example: 123456789 011000138 or 121000358 Any correctly formatted US address.

See also