Setup
Please follow the common Adyen instructions to get set up with Pay by Bank (US). Next, contact Adyen to enable Pay by Bank (US) on your merchant account. Adyen requires merchants to be registered with Plaid before go-live, which can take up to one week.Supported countries
Pay by Bank (US) supports transactions from buyers inUS.
Supported currencies
Pay by Bank (US) supports processing payments inUSD.
Features
Pay by Bank (US) via Adyen supports the following features:- Direct capture - Capture funds at the time of the transaction
- Refunds - Refund transactions in full
- Partial refunds - Refund a portion of the original transaction amount
- Payment method tokenization - Store the bank account for recurring debits
- Settlement reporting - Reconcile transactions against Adyen settlement reports
Limitations
The following features are not supported by this connector:- Delayed capture - Authorization and capture happen together
- Partial capture - Cannot capture a portion of the authorized amount
- Void - Cannot cancel a transaction once initiated
- Zero auth - Zero-amount verification transactions are not supported
Integration
Pay by Bank (US) is always a redirect flow. After creating a transaction, the buyer is redirected to Plaid to select their bank and authenticate. After authentication, Plaid runs a balance check and the buyer is redirected back to yourredirect_url.
Redirect integration
Create a new transaction using thepaybybank method.
payment_method.approval_url and the buyer_approval_pending status.
approval_url in a popup or redirect so the buyer can authenticate with their bank via Plaid. After the buyer completes the flow they are redirected to the redirect_url you provided when creating the transaction. Do not rely solely on the redirect — either poll the transaction or (recommended) rely on webhooks to detect the final status (for example capture_succeeded or failure states).
Pay by Bank (US) includes a Plaid balance check at authorization. If the selected bank account has insufficient funds, Adyen refuses the authorization and the transaction moves to a declined state.
Recurring payments
Pay by Bank (US) via Adyen supports storing the bank account after the first redirect. When you store the payment method, Gr4vy registers a recurring contract with Adyen so the stored bank account can be debited for subsequent transactions without requiring the buyer to go through the Plaid flow again. See Recurring payments for an overview of storing and reusing payment methods.Testing
Adyen provides a Pay by Bank (US) sandbox for testing. Use the Plaid sandbox credentials (user_good / pass_good) when prompted during the redirect flow. Select an account with sufficient balance (for example, the savings account) to avoid the balance-check refusal.