Direct Debit

Overview

Nium's Direct Debit funding capability helps you add your business customer's bank account to their Nium-issued wallet to help them make payments.

Prerequisites

These are the requirements for this funding mechanism:

  • Your customer needs to have a bank account and a Nium wallet.
  • Your customer needs to authorize the Direct Debit mandate to debit from their bank account and accept Nium's terms and conditions (T&C).
  • Your customer needs to have enough money in their added bank account to start your transactions.
  • Your customer needs to be a business, also known as a corporation.
  • Your customer needs to be onboarded to the Nium One platform.

Configuration

Accept Nium’s T&C. Nium provides approval according to the geography where Direct Debit is set up. Nium then configures Direct Debit for self-funding to your customer's wallets. Once you complete these steps, you can use Direct Debit.

📌

IMPORTANT

Direct Debit is a restricted functionality. As a new or existing client, contact a Nium sales representative to enable this functionality.

API server URLs

Use the following host names to distinguish the API calls between the different working environments.

  • Sandbox: https://gateway.nium.com
  • Production: https://api.spend.nium.com

Supported countries and currencies

The following table shows the supported Direct Debit countries and currencies. For more information, select the Direct Debit page linked in the table for the geography you're interested in.

Country codeCountryCurrency codeCurrency
AUAustraliaAUDAustralian dollar
EUEuropean UnionEUREuro
UKUnited KingdomGBPPound sterling
USUnited StatesUSDUnited States dollar
SGSingaporeSGDSingapore dollar

Direct Debit API endpoints

The following APIs support the Direct Debit feature:

HTTP methodAPI nameAction
POSTAdd Funding InstrumentAdd the funding instrument to your customer's wallet to start a Direct Debit transaction. Use this API to add the payer's physical bank account to the customer's wallet so that Direct Debit payments can be initiated against it. Provide the funding instrument's country and currency code.
GETGet Funding Instrument DetailsGet your customer's funding instrument details for a specific funding instrument ID. It's optional to use this API. The fundingInstrumentId is returned as a response in the Add Funding Instrument API call.
GETGet Funding Instrument ListGet the list of funding instruments registered with your customer. It's optional to use this API.
POSTConfirm Funding InstrumentConfirm the funding instrument with one-time password (OTP) authentication. Use this API to communicate the OTP you received from Nium. Nium sends you the OTP during the Add Funding Instrument API call. By confirming the Direct Debit mandate, your customer authorizes Nium to debit payments from their bank account. The debit payments appear on your customer's bank statement as Nium.
POSTFund WalletFund into your customer's wallet by selecting the funding channel as a direct_debit transaction. You also need to provide the fundingInstrumentId obtained from the response in the Add Funding Instrument API call.

The following diagram shows the Direct Debit customer wallet flow for all geographic regions.

Use cases

You can use the Direct Debit feature for business-to-business (B2B) payments such as employee payroll services or spend management. You can debit your business customer’s bank accounts and load the money into their Nium wallet so you can process their salary and expense payouts.

Use CaseClient typeExampleFunds flow
PayrollNon-financial platform clientsAs a payroll platform client, you want to debit a corporate customer's bank account and load money into their Nium wallet. This lets you manage salary and expense payouts.Corporate customer → Nium → corporate customer’s wallet → corporate customer’s employee
Spend management and supplier paymentsNon-financial platform clientsAs a software as a service (SaaS) platform client, you want to debit your customer’s accounts and load money into their wallets. This allows you to process their vendor's invoices and make payments to their vendor.SaaS platform customer → Nium → SaaS platform customer’s wallet → vendor
FintechNon-financial platform clientsAs a fintech platform, you want to direct debit your business customer’s accounts and load money into their wallets.Fintech business customer → Nium → customer's wallet → spend through a card or payout

The following diagram shows a Direct Debit payment broadly across geographic regions.

💁

TIP

To learn more about the technical words this guide uses, refer to the Glossary of Nium terms.