Skip to main content

​
Overview

Adyen’s ACH connector enables you to process ACH bank payments through Adyen’s payment platform. This connector works exclusively with Plaid for bank account linking and verification. When a customer links their bank account through Plaid Link, you can use this Adyen ACH connector to process the actual ACH transactions through Adyen’s infrastructure.

​
Setup

Please follow the common Adyen instructions to get set up with Adyen. Next, make sure to enable ACH as a payment method on your configured account.

​
Prerequisites

To use ACH via Adyen, you must have:
  1. Plaid configured - You need to set up Plaid in your Gr4vy dashboard to handle bank account linking
  2. Adyen ACH enabled - ACH must be enabled as a payment method in your Adyen account
The integration flow requires customers to first link their bank account through Plaid Link, then use the resulting public token to create a transaction that is processed through Adyen’s ACH network.

​
Usage

To create an ACH payment via Adyen, follow these steps: First, use Plaid Link to securely connect the customer’s bank account. See the Plaid integration guide for detailed instructions on implementing Plaid Link. When the customer successfully links their account, you’ll receive a publicToken and account metadata from Plaid.

​
Step 2: Create transaction with Adyen

Use the publicToken from Plaid to create a transaction that is processed through Adyen’s ACH connector.
POST /transactions
{
    "amount": 1299,
    "currency": "USD",
    "country": "US",
    "intent": "capture",
    "payment_method": {
        "method": "plaid",
        "token": "public-sandbox-xxxxx",
        "account_id": "account-id-from-metadata"
    },
    "buyer": {
        "billing_address": {
            "first_name": "John",
            "last_name": "Doe"
        }
    },
    "payment_service_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
Key parameters:
  • method - Set to plaid to indicate a Plaid-linked bank account
  • token - The public token received from Plaid Link
  • account_id - Optional. The specific account ID from Plaid metadata if the customer linked multiple accounts
  • payment_service_id - The UUID of your Adyen ACH connection (found in Gr4vy dashboard)
The transaction is processed through Adyen’s ACH network using the bank account details securely retrieved from Plaid.

​
Testing

In a test environment, you can use Plaid’s sandbox mode along with Adyen’s test environment:
  1. Configure Plaid with sandbox credentials
  2. Use Plaid’s test credentials to link a test bank account
  3. Process test transactions through Adyen’s sandbox
Refer to Plaid’s testing documentation for available test credentials and scenarios.

​
Limitations

​
Refunds

Partial refunds are not supported for unsettled ACH transactions. If you need to refund an ACH transaction before it has settled, you must refund the full transaction amount. Once a transaction has settled, partial refunds become available.

​
Payment methods

This connector only supports bank accounts linked through Plaid. Direct ACH account number entry is not supported through this integration.