POST
/
v1
/
direct-debits
Create a Direct Debit Mandate
curl --request POST \
  --url https://api.nomba.com/v1/direct-debits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountid>' \
  --data '{
  "customerAccountNumber": "0212343456",
  "bankCode": "101",
  "customerName": "Kolapo Ojo",
  "customerAddress": "maryland Ikeja computer village",
  "customerAccountName": "Kolapo Ojo",
  "amount": 100,
  "frequency": "WEEKLY",
  "narration": "test e mandate response",
  "customerPhoneNumber": "08074332234",
  "merchantReference": "12003074001",
  "startDate": "2025-08-29T14:58",
  "endDate": "2025-08-30T10:40",
  "customerEmail": "[email protected]",
  "startImmediately": true
}'
{
  "responseMessage": "Success",
  "responseCode": "00",
  "data": {
    "mandateId": "e50b7835-502c-4cfe-9893-47657633d7a2",
    "merchantReference": "12003074001",
    "phoneNumber": "08073345562",
    "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"
  }
}

Authorizations

​
Authorization
string
header
required

Nomba authenticates API calls with OAuth2 HTTP bearer tokens. There are two methods of authentication; Client-Credentials method and PKCE (Proof Key for Code Exchange) method. In each of the methods, You will get an ACCESS_TOKEN. You need to use an "Authorization" HTTP header to provide your ACCESS_TOKEN. For example: Authorization: {ACCESS_TOKEN}.

Headers

​
accountId
string
required

The vendor account ID

Body

application/json

Response

200
application/json

Mandate created successfully

The response is of type object.