Pay by Bank (US) Web Component integration

Add Pay by Bank (US) to an existing Web Components integration.

This page explains how to add Pay by Bank (US) to your existing Web Components integration.

Requirements

Select the server-side flow that your integration uses:

Import resources for v6

If you are using Web Components v6, import the Component that you need for Pay by Bank (US):

import { AdyenCheckout, PayByBankUS } from '@adyen/adyen-web'

API reference

Select the endpoint you are using to make payments:

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="paybybank_AIS_DD-container"></div>

Step 2: Create an instance of the Component

v6.0.0 or later

Create an instance of the Component, passing:

Your instance of AdyenCheckout.

const openBanking = new PayByBankUS(checkout).mount('#paybybank_AIS_DD-container');

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

const openBankingComponent = checkout.create('paybybank_AIS_DD').mount('#paybybank_AIS_DD-container');

Redirect handling

Your Components integration handles the redirect, so you do not need to do anything additional for Pay by Bank (US).

Payment outcome

Your Components integration gets the payment outcome, so you do not need to do anything additional for Pay by Bank (US).

Capture

We strongly recommend capturing Pay by Bank (US) payments immediately, to reduce the risk of insufficient funds at the time of capture.

Adyen completes the checks on the shopper's bank account, including a balance check and risk checks, at the time of authorization. However, the issuing bank does not hold the authorized funds and thus it is possible that the account balance is no longer sufficient by the time you capture the payment. For that reason, you should capture Pay by Bank (US) payments as soon as possible.

However, even with immediate capture there is still a risk of insufficient funds at the time of capture, because capturing is an asynchronous process on the ACH Direct Debit network.

Recurring payments

Pay by Bank (US) supports tokenization of the shopper's payment details for recurring transactions.

We strongly recommend that you ask explicit permission from the shopper if you intend to make future recurring payments. Being transparent about the payment schedule and the amount reduces the risk of chargebacks.

To make recurring payments, refer to Tokenization to:

Create a token through the initial payment.
Use the token in subsequent payments.
Manage tokens.

Test and go live

We recommend that you test various scenarios, such as approved payments, authentication errors, and payments cancelled by the shopper. You can check the status of test payments in your Customer Area > Transactions > Payments.

To go live, you need to add Pay by Bank (US) in your live Customer Area. Our partner Plaid then registers your merchant account with participating banks, including some of the largest banks in the US. The registration takes up to one business week from the moment Plaid has started the process. During this time, your shoppers cannot connect their bank account to Plaid. For this reason, you cannot accept live Pay by Bank (US) payments until the registration process is completed.

We send you a paymentMethod.created webhook when you can start accepting live Pay by Bank (US) payments.