Account Verification
Use the Account Verification request to confirm the details of account holders.
The Account Verification request helps you confirm the details of bank accounts owners and beneficiaries use.
Verifying the bank account details of account holders before adding them to your Nium account helps you confirm that funds will reach the intended payee or beneficiary and mitigate any future issues.
Specifically, the Account Verification request verifies that the account holder's details, like their bank account number, is valid. With the Account Verification request, you won't need a separate integration dedicated to verifying account details.
To enable Account Verification, please contact your Nium account manager or Nium Support .
IMPORTANT
Account verifications are only supported when the payout method for a beneficiary is type
Local
orProxy
.
Verify Account Details
When adding a beneficiary or account holder, there are two ways to verify the details of their account:
Account Verification
Using the Account Verification endpoint before creating a beneficary
ensures you only create beneficiaries
using the correct details:
- Call the Beneficiary Validation Schema V2 endpoint to confirm which fields are required for your region.
- Call the Account Verification endpoint and include the fields returned in the Beneficiary Validation Schema V2 response with the account holder's details.
- Take the necessary steps based on the response you receive:
verified
ornot_verified
: Add the beneficiary using the Add Beneficiary V2 request and verified account details.- Once the
beneficary
is created you can proceed with creating Payouts and managing funds as you normally would.
- Once the
not_supported
: Nium does not support the account holder's country.
Creating a Beneficiary
You can also verify the details of a beneficiary or account holder while creating a beneficiary
:
- Add the beneficiary using the Add Beneficiary V2 request.
- Alternatively, you can fetch the details of the beneficiary using the Beneficiary Details V2 request.
- Review the
status
andname
field in theaccountVerification
object.verified
ornot_verified
: You can proceed with creating Payouts and managing funds as you normally would.not_supported
: Nium does not support the account holder's country.
Item | Description |
---|---|
Account holder | The recipient of your customer's money or whose account you want to confirm. Either a business or an individual. |
Account holder details | This can include the account holder's name, beneficiary account, routing codes, and many others. See the Beneficiary Validation Schema V2 request for a comprehensive list of required fields. |
Statuses
Status | Description |
---|---|
not_supported | Nium does not support verifying the account details of a beneficiary bank account in this destination country. |
not_verified | The beneficiary's bank account details are incorrect. Verify the details of the beneficiary and submit the request again. |
verified | Nium has successfully verified the bank account details. You can proceed with creating a beneficiary for the account holder. Note: Transactions to this beneficiary can still be returned due to several reasons, such as rejection due to compliance reasons, rejection by the bank account, closed account, etc. |
Supported Corridors
To verify account holder's details, Nium checks the account information against data from clearing systems.
Additionally, in some corridors, Nium is able to provide the full name of the account holder associated with the bank account.
The following table breaks down what corridors the Account Verification request supports and when the account holder's name is returned.
Country – Currency | Payout Method | Account Holder Name |
---|---|---|
AU - AUD | PROXY | Provided by Nium |
GB - GBP | LOCAL | Not provided by Nium |
HK - HKD | PROXY | Provided by Nium |
ID - IDR | LOCAL | Provided by Nium |
IN - INR | PROXY | Provided by Nium |
MY – MYR | LOCAL PROXY | Provided by Nium Provided by Nium |
PK – PKR | LOCAL | Provided by Nium |
SG - SGD | PROXY | Provided by Nium |
TH - THB | LOCAL | Not provided by Nium |
VN - VND | LOCAL | Not provided by Nium |
KR - KRW | LOCAL | Provided by Nium |
Updated 10 days ago