Nium Verify

Verify account holder details in real-time to ensure accurate payments and reduce fraud.

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.

Nium Verify is available for both:

  • Existing Nium clients who can add Verify into their existing Nium integration, seamlessly verifying accounts before creating beneficiaries.
  • New Nium Verify users who want to verify bank account details independently, without Nium’s other services.

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.

Using Nium Verify as a Nium client

Nium Verify offers an easy-to-implement Account Verification request you'll use to verify the account details of payees before creating a beneficiary and adding them to your platform. You can also confirm account details while creating a beneficiary.

Please note, the Account Verification request can only be used when the beneficiary#payoutMethod is LOCAL or PROXY. For more information on the different payout methods available, see Payouts - Overview.

When adding a beneficiary or account holder, there are two ways to verify their account details using Nium Verify:

For guidance on testing Nium Verify, contact Nium Support.

For a breakdown of all the different payout methods available, see Payouts Overview.

Before creating a beneficiary

Use this approach to confirm account details before creating a beneficiary to ensure that only verified details are used in your Nium account.

Step 1: Validate required fields

Use the Beneficiary Validation Schema V2 request to determine which fields are required for the account’s region.

Step 2: Submit account verification

Submit an Account Verification request, and include the fields returned by the Beneficiary Validation Schema, along with the account holder’s details.

Step 3: Handle the response

Based on the response from the Account Verification request:

  • verified: Proceed with creating the beneficiary using Add Beneficiary V2 request.
  • not_verified: Review and confirm the account details and resubmit the request.
  • not_supported: The account holder's country is not supported by Nium for verification.

Once the beneficiary is created, you can continue with creating Payouts as usual.

While creating a beneficiary

You can also verify account details at the same time as creating a beneficiary.

Step 1: Add the beneficiary

Use the Add Beneficiary V2 request. Alternatively, fetch the details of the beneficiary using the Fetch Beneficiary Details V2 request.

Step 2: Review account verification status

Check the status and name fields within the accountVerification object in the Add Beneficiary V2 or Fetch Beneficiary Details V2 response:

  • verified: The account details are correct, and you can proceed with creating Payouts.
  • not_verified: The account details are incorrect; verify and submit again.
  • not_supported: The country is not supported for account verification.

Key concepts

TermDescription
Account holderThe recipient of the funds, either a business or individual, whose account you want to verify.
Account holder detailsIncludes details like the account holder's name, bank account number, routing codes, and more.

Payout methods

The Account Verification request can only be used when the beneficiary#payoutMethod is LOCAL or PROXY:

Payout methodbeneficiary#payoutMethod valueDescription
Local bank accountsLOCAL
  • Local clearing systems to transfer funds electronically (e.g., ACH)
  • Local currency wires to bank accounts.
SWIFT (foreign currency wires)SWIFTTransfers 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:

StatusDescription
not_supportedNium does not support verifying bank account details in this country.
not_verifiedThe account details are incorrect. Please verify the information and try again.
verifiedThe 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 get returned and indicates the issue:

StatusDescription
400_bad_requestThe account verification request could not be processed due to invalid data. Verify the request details and try again.
401_unauthorizedThe request was not authorized. Please check your authentication credentials and try again.
404_not_foundThe requested resource (such as a beneficiary#id) was not found. Verify the information and retry.
500_internal_errorAn internal server error occurred. Please wait a few moments and try again.
503_service_unavailableThe service is temporarily unavailable. Please try again later.

Using Nium Verify independently

If you only need Nium Verify and do not 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 a larger payment platform.

To sign up for Nium Verify independently, contact the Nium sales team.

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 table below outlines the countries where account verification is available and whether the account holder’s name can be retrieved.

  • 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 [email protected] or your Nium account manager.
Country – CurrencyPayout MethodAccount Holder Name
Australia - AUDPROXYAvailable
Belgium - EUR (Beta)LOCALAvailable
France - EUR (Beta)LOCALAvailable
Hong Kong - HKDPROXYAvailable
India - INRPROXYAvailable
Indonesia - IDRLOCALAvailable
Italy - EUR (Beta)LOCALAvailable
Malaysia – MYRLOCAL / PROXYAvailable
Netherlands - EUR (Beta)LOCALAvailable
Nigeria - NGNLOCALAvailable
Pakistan – PKRLOCALAvailable
Poland - EUR (Beta)LOCALAvailable
Singapore - SGDPROXYAvailable
South Korea - KRWLOCALAvailable
Tanzania - TZSLOCALAvailable
Thailand - THBLOCALUnavailable
United Kingdom - GBPLOCALUnavailable*
United States - USD (Beta)LOCALUnavailable
Vietnam - VNDLOCALAvailable

For UK accounts: The 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.