Skip to main content
POST
/
api
/
custom
/
transactions
/
tech-maxx
/
wallets
/
debit-wallet
cURL
curl --request POST \
  --url https://test.digitaltermination.com/api/custom/transactions/tech-maxx/wallets/debit-wallet \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerName": "Eugene Osei",
  "mno": "Zeepay",
  "amount": "1",
  "msisdn": "233201854694",
  "description": "Zeepay Test Wallet Credit",
  "reference": "23453452",
  "callback_url": "https://your-domain.com/webhook/payment-status"
}
'
{
  "code": 411,
  "zeepay_id": 123456,
  "amount": "1",
  "message": "Pending Gateway Response"
}
Call to debit a mobile wallet. Please note that a successful call to this route will trigger a USSD prompt to the user to approve / authorize the transaction.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
customerName
string
required

The receiver's name

Example:

"Eugene Osei"

​
mno
string
required

The mobile service provider

Example:

"Zeepay"

​
amount
number
required

The amount to credit the mobile wallet

Example:

"1"

​
msisdn
number
required

The receiver mobile number

Example:

"233201854694"

​
description
string
required

The description of the transaction

Example:

"Zeepay Test Wallet Credit"

​
reference
string
required

Transaction reference

Example:

"23453452"

​
callback_url
string

The callback URL (optional)

Example:

"https://your-domain.com/webhook/payment-status"

Response

200 - application/json

Successfully processed the payout request

​
code
number

Static response code indicating the status

Example:

411

​
zeepay_id
integer

The Zeepay ID of the transaction

Example:

123456

​
amount
number

The amount to debit the mobile wallet

Example:

"1"

​
message
string

This is a response message from the third party

Example:

"Pending Gateway Response"