Initiate Collection Payment

POST

/payment

Initiates a mobile money collection payment request.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Examples

Responses

🟢200Success

text/plain

🟢200Pending

Request Example

Shell

JavaScript

Java

Swift

curl --location '/payment' \
--header 'clientid: {{clientId}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "senderEmail": "customer@example.com",
  "phoneNumber": "0240000000",
  "channel": "mobile_money",
  "provider": "mtn",
  "amount": 150.00,
  "tot_amnt": 150.00,
  "description": "Invoice12345",
  "foreignID": "TXN12345",
  "callbackUrl": "https://yourapp.com/api/callback"
}'

Response Example

200 - Success - Pending

{
  "status": "pending",
  "message": "TRANSACTION PENDING",
  "transID": "COL1000001221896",
  "foreignID": "17263839290373",
  "reqToken": "COL100001221896"
}

Modified at 2026-10-06 12:26:22

Collections

Disbursements