You can add Online Banking India to your existing integration. The following instructions show only what you must add to your integration specifically for Online Banking India.
If an instruction on this page corresponds with a step in the main integration guide, it includes a link to corresponding step of the main integration guide.
Requirements
Requirement | Description | |
---|---|---|
Integration type | Make sure that you have an existing API-only integration. This page includes only instructions to add Online Banking India to your existing integration. |
|
Redirect handling | Make sure that your existing integration is set up to handle the redirect. action.type : redirect |
|
Setup steps | Before you begin, add Online Banking India in your Customer Area. |
Get Online Banking India as an available payment method
When you make the /paymentMethods to get available payment methods, specify the following so that Online Banking India is included in the response.
Parameter | Values |
---|---|
countryCode | IN |
amount.currency | INR |
channel | Web, iOS, or Android |
Build your payment form
We provide the logo for Online Banking India that you can download.
Your payment form for Online Banking India does the following:
- Show a list of available banks to your shopper. You can get the list of issuing banks from the /paymentMethods response, in the object with
type
: onlineBanking_IN.
We recommend that you dynamically create the payment form, because of the following:- The list of available issuers for Online Banking India can change often.
- There is a large number of small issuers. When you dynamically create the form, we recommend that you show the top ten issuers and include an option to show more issuers.
- When the shopper selects a bank, pass the corresponding
issuer
value to your server.
Add additional parameters to your /payments request
When you make a payment, add the following parameters:
Parameter | Required | Description |
---|---|---|
paymentMethod.issuer |
![]() |
The issuing bank that the shopper selected. |
curl https://checkout-test.adyen.com/checkout/v71/payments \ -H 'x-api-key: ADYEN_API_KEY' \ -H 'content-type: application/json' \ -d '{ "merchantAccount":"ADYEN_MERCHANT_ACCOUNT", "reference":"YOUR_ORDER_NUMBER", "amount":{ "currency":"INR", "value":1000 }, "paymentMethod":{ "type":"onlinebanking_IN", "issuer":"CBI" }, "returnUrl":"https://your-company.com/checkout?shopperOrder=12xy.." }'
Handle the additional action
You must handle the additional action for Online Banking India.
The action.type
is redirect.
Test and go live
Online banking India currently has no test platform.
Before you can accept live Online banking India payments, you need to submit a request for Online banking India in your live Customer Area.