curl --location 'https://api.nomba.com/v1/direct-debits' \
--header 'Authorization: Bearer [token]' \
--header 'accountId: <accountId>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "customerAccountNumber": "2334334532",
  "bankCode": "101",
  "customerName": "Kolapo Adeoti",
  "customerAddress": "maryland Ikeja computer village",
  "customerAccountName": "Kolapo Adeoti",
  "frequency": "VARIABLE",
  "narration": "test e mandate response",
  "customerPhoneNumber": "08022222222",
  "merchantReference": "12003074001223212",
  "startDate": "2025-08-29T15:30",
  "endDate": "2025-08-30T10:40",
  "customerEmail": "[email protected]",
  "startImmediately": true
}'

{
    "code": "00",
    "description": "SUCCESS",
    "data": {
        "mandateId": "c93e1e1b-85f5-461e-8b9b-74ee091d4aa4",
        "merchantReference": "12003074001",
        "customerPhoneNumber": "08079914423",
        "description": "Welcome to NIBSS e-mandate authentication service, a seamless and convenient authentication experience. Kindly proceed with a token payment of N50.00 into account number 9880218357 with Paystack-Titan Bank. This payment will trigger the  authentication of your mandate. Thank You"
    },
    "message": "SUCCESS",
    "status": true
}

Create Direct Debit Mandate

​
POST /v1/direct-debits

​
Request body

​
customerName
string
required
The customer’s account name.
​
customerPhoneNumber
string
required
The phone of the customer.
​
customerEmail
string
required
The email of the customer.
​
customerAddress
string
required
The address of the customer.
​
amount
number
required
The amount to be used for the mandate.
​
customerAccountNumber
string
required
The customer’s account number.
​
customerAccountName
string
required
The customer’s account name.
​
bankCode
string
required
The customer account bank code.
​
merchantReference
string
required
Unique reference used to track a transaction from an external process.
​
frequency
string
required
The frequency of the mandate
​
narration
string
required
The narration for this transfer (NB: This will be appended to the normal system generated narration).
​
startDate
date
required
The start date for the mandate to commence. This is a future date to the date of creation.
​
endDate
date
required
The end date for the mandate to stop
​
startImmediately
boolean
required
This is set to allow the mandate to start running immediately

​
Response body

​
code
string
required
Response code
​
description
string
required
Response description
​
data
object
​
message
string
required
Message
​
status
boolean
required
status
curl --location 'https://api.nomba.com/v1/direct-debits' \
--header 'Authorization: Bearer [token]' \
--header 'accountId: <accountId>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "customerAccountNumber": "2334334532",
  "bankCode": "101",
  "customerName": "Kolapo Adeoti",
  "customerAddress": "maryland Ikeja computer village",
  "customerAccountName": "Kolapo Adeoti",
  "frequency": "VARIABLE",
  "narration": "test e mandate response",
  "customerPhoneNumber": "08022222222",
  "merchantReference": "12003074001223212",
  "startDate": "2025-08-29T15:30",
  "endDate": "2025-08-30T10:40",
  "customerEmail": "[email protected]",
  "startImmediately": true
}'

{
    "code": "00",
    "description": "SUCCESS",
    "data": {
        "mandateId": "c93e1e1b-85f5-461e-8b9b-74ee091d4aa4",
        "merchantReference": "12003074001",
        "customerPhoneNumber": "08079914423",
        "description": "Welcome to NIBSS e-mandate authentication service, a seamless and convenient authentication experience. Kindly proceed with a token payment of N50.00 into account number 9880218357 with Paystack-Titan Bank. This payment will trigger the  authentication of your mandate. Thank You"
    },
    "message": "SUCCESS",
    "status": true
}