Skip to main content
POST
/
api
/
debits
cURL
curl --request POST \
  --url https://test.digitaltermination.com/api/debits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data customer_first_name=GODWIN \
  --data customer_last_name=HOTTOR \
  --data source_country=GHA \
  --data customer_msisdn=233245519485 \
  --data amount=0.1 \
  --data service_type=Wallet \
  --data extr_id=guid-example \
  --data description=ZeepayTest \
  --data debit_currency=GHS \
  --data debit_country=GHA \
  --data mno=MTN \
  --data transaction_type=DR \
  --data callback_url=https://webhook.site/3b3b3b3b-3b3b-3b3b-3b3b-3b3b3b3b3b3b
{
  "code": 411,
  "zeepay_id": 123456,
  "amount": 0.1,
  "message": "Transaction Pending Gateway Response"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/x-www-form-urlencoded
​
customer_first_name
string
required

The first name of the customer

Example:

"GODWIN"

​
customer_last_name
string
required

The mobile number of the wallet to debit

Example:

"HOTTOR"

​
source_country
string
required

The country code of the source

Example:

"GHA"

​
customer_msisdn
number
required

The mobile number of the wallet to debit

Example:

233245519485

​
amount
integer
required

The amount to debit the mobile wallet

Example:

0.1

​
service_type
string
required

The service type

Example:

"Wallet"

​
extr_id
string
required

The external ID

Example:

"guid-example"

​
description
string
required

The description of the transaction

Example:

"ZeepayTest"

​
debit_currency
string
required

The currency code of the debit

Example:

"GHS"

​
debit_country
string
required

The country code of the debit

Example:

"GHA"

​
mno
string
required

The mobile service provider

Example:

"MTN"

​
transaction_type
string
required

The transaction type

Example:

"DR"

​
callback_url
string

The callback URL (optional)

Example:

"https://webhook.site/3b3b3b3b-3b3b-3b3b-3b3b-3b3b3b3b3b3b"

Response

Successfully debited the mobile wallet

​
code
integer

Static response code indicating the status

Example:

411

​
zeepay_id
integer

Message indicating successful transaction

Example:

123456

​
amount
integer

The transaction amount

Example:

0.1

​
message
string

This is a response message from the third party

Example:

"Transaction Pending Gateway Response"