Nium Verify
Nium Verify is a real-time bank account verification solution designed to help businesses ensure the accuracy of account details before processing payments.
By verifying account details upfront, Nium Verify reduces the risk of payment failures, fraud, and helps you fulfill compliance requirements. It integrates seamlessly into your existing payment workflows, providing a simple and efficient way to validate bank account information across multiple regions and payout methods.
Please note, the Account Verification request can only be used to verify bank accounts by providing either the bank account number and routing code or the linked proxy identifier (e.g. PayNow in Singapore, UPI in India).
Nium Verify is available for both:
- New Nium users who want to verify bank account details independently, without using Nium’s other services.
- Existing Nium clients who can add Verify into their existing Nium integration, seamlessly verifying accounts before creating beneficiaries or triggering payouts.
Verifying account details help ensure that payments are sent to the correct recipients. With Nium Verify, you no longer need a separate process for verifying bank account details, simplifying your integration and improving operational efficiency.
To sign up for Nium Verify, please contact your Nium account manager or Nium Support. Use of the Verify Service is subject to Terms of Service.
For details on how to test Verify, see Testing Verify.
Using Nium Verify independently
If you only need Nium Verify and do not plan to use other Nium services, you can leverage Verify for direct account verification.
Using Nium Verify independently, you can submit account details directly for verification and review the status without integrating into our larger payment platform.
To sign up for Nium Verify independently, contact the Nium sales team.
Use this approach if you are using Nium for Verify only. You can use this before triggering payouts, or linking direct debits, or before creating a beneficiary and adding them to your platform.
Step 1: Call Nium Verify
Submit an Account Verification request with the mandatory fields noted in Supported corridors.
Step 2: Handle the response
Below are the responses from the Account Verification request:
- valid: Account exists.
- invalid: Account is not invalid. Review and confirm the account details and resubmit the request. Check the
failureCodefield for a reason.
Using Nium Verify as an existing client
Nium Verify offers an easy-to-implement Account Verification request you'll use to verify whether accounts exist and whether the names match with bank records. You can leverage Nium Verify at the same time as creating a beneficiary.
Once the beneficiary is created, you can continue with creating Payouts as usual.
Step 1: Add the beneficiary
Use the Add Beneficiary V2 request. Alternatively, fetch the details of the beneficiary using the Beneficiary Details V2 request.
Step 2: Review account verification status
Check the status and name fields within the accountVerification object in the response:
- verified: The account details are correct, and you can proceed with Payouts.
- not_verified: The account details are incorrect; verify and submit again.
- not_supported: The country is not supported for account verification.
Key concepts
| Term | Description |
|---|---|
| Account holder | The recipient of the funds, either a business or individual, whose account you want to verify. |
| Account holder details | Includes details like the account holder's name, bank account number, routing codes, and more. See the Beneficiary Validation Schema V2 for required fields. |
Payout methods
The Account Verification request can only be used when the beneficiary#payoutMethod is LOCAL or PROXY:
| Payout method | beneficiary#payoutMethod value | Description |
|---|---|---|
| Local bank accounts | LOCAL |
|
| SWIFT (foreign currency wires) | SWIFT | Transfers through the Society for Worldwide Interbank Financial Telecommunication |
Account verification statuses
Nium uses the following statuses to indicate the result of an account verification request:
| Status | Description |
|---|---|
valid | The account details are incorrect. Please verify the information and try again. |
invalid | The bank account details have been successfully verified. Note: Even after verification, payments to this account may still fail due to other reasons such as compliance issues or account closure. |
Account verification error codes
If an error occurs during account verification, the following error codes are returned:
| Status | Description |
|---|---|
400_bad_request | The account verification request could not be processed due to invalid data. Verify the request details and try again. |
401_unauthorized | The request was not authorized. Please check your authentication credentials and try again. |
404_not_found | The requested resource (such as a beneficiary#id) was not found. Verify the information and retry. |
500_internal_error | An internal server error occurred. Please wait a few moments and try again. |
503_service_unavailable | The service is temporarily unavailable. Please try again later. |
Supported corridors
Nium Verify validates account information against clearing systems in supported countries. In some cases, Nium also provides the full name of the account holder associated with the bank account.
The following table outlines the countries where account verification is available and if the account holder’s name can be retrieved.
| Country – Currency | Payout Method | Account Holder Name |
|---|---|---|
| Australia - AUD | PROXY | Available |
| Belgium - EUR (Beta) | LOCAL | Available |
| France - EUR (Beta) | LOCAL | Available |
| Hong Kong - HKD | PROXY | Available |
| India - INR | LOCAL / PROXY | Available |
| Indonesia - IDR | LOCAL | Available |
| Italy - EUR (Beta) | LOCAL | Available |
| Malaysia – MYR | LOCAL / PROXY | Available |
| Netherlands - EUR (Beta) | LOCAL | Available |
| Nigeria - NGN | LOCAL | Available |
| Pakistan – PKR | LOCAL | Available |
| Poland - EUR (Beta) | LOCAL | Available |
| Singapore - SGD | PROXY | Available |
| South Korea - KRW | LOCAL | Available |
| Tanzania - TZS | LOCAL | Available |
| Thailand - THB | LOCAL | Unavailable |
| United Kingdom - GBP | LOCAL | Available* |
| United States - USD (Beta) | LOCAL | Unavailable |
| Vietnam - VND | LOCAL | Available |
For UK accounts: The account holder's name is only returned for strong and partial matches. For weak matches, the name will not be returned. This matching process is standardized across all UK providers.
We are expanding Nium Verify to support more corridors. Corridors currently in development are marked as (Beta) and subject to additional changes. If you have any questions about using Nium Verify and a corridor, contact support@nium.com or your Nium account manager.