Skip to main content
POST
/
api
/
pay
Initiate Paymeni Request
curl --request POST \
  --url https://business-sandbox.instntmny.com/api/pay \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data channel=2 \
  --data phone_number=233245519485 \
  --data 'name=Godwin Hottor' \
  --data amount=1 \
  --data voucher_code= \
  --data callback_url=
{
  "transaction": {
    "type": "Cr",
    "merchant_id": 5,
    "reference": "5-234r433434-24e3ed",
    "medium": "MTN Mobile Money",
    "amount": 1.01,
    "amount_details": "Hello, this is a test debit transaction",
    "status": "2",
    "status_message": "Request sent, pending processing",
    "sender_details": {
      "type": 2,
      "no": "233245519485",
      "name": "ZEEPAY GHANA LIMITED",
      "token": null
    },
    "recipient_details": {
      "type": 8,
      "no": 5,
      "name": "Godwin Hottor"
    },
    "description": "Payment",
    "extra": "Testing",
    "api": 1,
    "callback_url": "https://webhook.site/3b3b3b3b-3b3b-3b3b-3b3b-3b3b3b3b3b3b",
    "updated_at": "2020-04-14 16:18:31",
    "created_at": "2020-04-14 16:18:31",
    "id": 26
  },
  "type": "Success",
  "message": "Transaction Request Successful"
}

Documentation Index

Fetch the complete documentation index at: https://docs.myzeepay.com/llms.txt

Use this file to discover all available pages before exploring further.

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
​
channel
number
required

The channel code for the mobile wallet provider

Example:

2

​
phone_number
number
required

The mobile number of the wallet to debit

Example:

"233245519485"

​
name
string
required

The name of the account holder

Example:

"Godwin Hottor"

​
amount
number
required

The amount to debit the mobile wallet

Example:

1

​
voucher_code
string

required only for Vodafone Cash Transactions

Example:

""

​
callback_url
string

The callback URL (optional)

Example:

""

Response

200 - application/json

Request Sent, pending processing

​
transaction
object
​
type
string
Example:

"Success"

​
message
string
Example:

"Transaction Request Successful"