Are you looking for test card numbers?

Would you like to contact support?

Payment-method icon

ACH Direct Debit Drop-in integration

Add ACH Direct Debit to an existing Drop-in integration.

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

Before you begin

This page assumes you have already:

API reference

Select which endpoint you're integrating:

This is the default with Web Drop-in 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"
  }
}'

Drop-in configuration

There is no ACH Direct Debit specific configuration for Drop-in.

Optional configuration

When creating an instance of Drop-in, 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