We, at Eko, continue to work on providing a seamless and hassle free payment and transaction experience to our merchants, customers and partners.
For sending money to a bank account, a bank account needs to be mapped to a customer’s wallet. For that purpose, “Add Recipient” API is required. However, since different banks require different field parameters for registering a bank account, we have designed a process that simplifies adding of a bank account to a customer wallet.
We have implemented the changes in workflow in our merchant portal “Connect” for money remittance business and now we want to share the same process with our API partners.
4 Simple Steps for adding a bank account
- Capture Bank Name – Enable your merchant/customer to first select the bank (figure 1) to which money needs to be transferred. On selecting the bank name, invoke Get Bank API and Eko shall return the following details about the bank like:
- Full Bank Name (parameter name “name”)
- Account Verification is available or not (parameter isVerificationAvailable) – This signifies if bank has enabled verification of bank account feature or not. If value returned is “1” then verification is available else it is not allowed.
- IFSC code required or not (parameter “ifsc_status”) – Signifies if the IFSC code is required for money transaction or not
- Channel available for money transfer (parameter name “available_channels”) – This signifies IMPS is available or not and if not then, NEFT channel needs to be pused. The following values signifies which channel is available:
-> ALL : 0
-> NEFT : 1
-> IMPS : 2
- Enter Recipient’s Bank Account Details – As a second step, enable your merchant/customer to enter the following:
- Recipient’s Bank Account Number – Only bank account number is required for bank, for whom IMPS is available. The next step is point 3.
- IFSC Code – If IMPS is not available for the bank selected. The next step is point 4.
- Account Name Verification – If Account verification feature is available, then Account Name Info API needs to be invoked, which instantly pulls out the Name of the recipient by either pushing Rs 1 transaction via IMPS or from Eko’s database. In the example shown in figure 2, it shows that for banks like SBI, etc where IMPS is available and account verification is available, only bank account details are required and recipients details are returned in response to Account Name Info
- Capture Recipient Details – If Account verification feature is not available, then following recipient details are required:
- Recipient’s Name
- Recipient’s Mobile Number
- IFSC code of the recipient’s BankIn the example shown below, when “Abu Dhabi Commercial Bank” is chosen as bank, for which IMPS and account verification is not available, bank details and recipient details are required
In the below example, the customer/merchant has selected “HDFC Bank”, for which IMPS is available but account verification feature is not available, and in such cases bank account number and recipient details are required.
After capturing the details of the recipients, “Add Recipient” API needs to be invoked.