1. Payment Request
ZamuPay API Documentation
  • Introduction
  • Definitions
    • Data Types
  • Authorization
    • Overview
    • Token Request
      POST
    • Find Transaction Routes
      GET
    • Health Check
      GET
  • Payment Request
    • Overview
    • Payment Order Request Information
    • Mobile Money Requests
      • Overview
      • Mobile Transfers- Safaricom (M-Pesa)
      • Mobile Transfers - Airtel Money
    • Payment Order Requests - Business Transfers
      POST
    • Payment Order Requests - Bank Transfers
      POST
    • Find Payment Order By OriginatorConversationId
      GET
    • Reject Order By OriginatorConversationId
      POST
  • Collection Request
    • Overview
    • Express Deposit Request
      POST
    • Find Express Deposit By OriginatorConversationId
      GET
  • Checkout Request
    • Overview
    • Checkout Order Request
      POST
    • Query Checkout Request
      GET
    • Checkout Callback Request
      POST
  • Bill Payments
    • Overview
    • Bill Request Validation
      POST
    • Bill Request Payment
      POST
    • Find Bill Services
      GET
    • Find Bill Number By Service Id and Account Number
      GET
    • Find Bill Request By Originator Converstion Id
      GET
    • Bill Number
      POST
  • Account Validation
    • Overview
    • Account Number Validation Request
    • Find KYC Status by SystemTraceAuditNumber
    • Account Validation
    • Find Account Validation Status by SystemTraceAuditNumber
  • Payment Links
    • Overview
    • Create Payment Link
    • Find Payment Links By Id
    • Update Payment Link
  • Customer Accounts
    • Balance Check
    • Find Charges By TransactionTypeId
  • Airtime Purchase
    • Overview
    • Airtime Purchase
    • Find Airtime Purchases By OriginatorConversationId
  1. Payment Request

Payment Order Requests - Business Transfers

Developing
https://auth.zamupay.com
https://auth.zamupay.com
https://auth.zamupay.com
https://auth.zamupay.com
POST
/v1/payment-order/new-order
Description
Zamupay supports outbound payments (B2B) via Business Transfers
This is for M-Pesa Paybill and M-Pesa Till Number(Buy Goods)
Note: A valid token is required for authentication as it expires after every hour. Refer to Token Request to generate a new token.

Sample Buy Goods / Till Number request#

{
	"originatorConversationId": "{{$guid}}",
	"paymentNotes": "BuyGoodsTransfer",
	"paymentOrderLines": [
		{
			"recipient": {
				"name": "JOSEPH KIMANI",
				"address": null,
				"emailAddress": null,
				"phoneNumber": null,
				"idType": null,
				"idNumber": null,
				"financialInstitution": "Mobile",
				"primaryAccountNumber": "254700836996",   // Safaricom based phone number
				"mccmnc": 63902,
				"ccy": 404,
				"country": "KE",
				"purpose": "Disbursement",
				"institutionIdentifier": "3674408"  // Till Number
			},
			"transaction": {
				"routeId": "d883e7e7-fc0e-f111-858d-062ab3a3eac8",
				"channelType": 13,
				"amount": 4500.0,
				"reference":  "{{$guid}}",
				"systemTraceAuditNumber":  "{{$guid}}",
				"accountNo": "254700000356"
			}
		}
	]
}

Sample Business Paybill request#

{
	"originatorConversationId":  "{{$guid}}",
	"paymentNotes": "PaybillTransfer",
	"paymentOrderLines": [
		{
			"recipient": {
				"name": "JULIET JOY CHERUIYOT",
				"address": null,
				"emailAddress": null,
				"phoneNumber": null,
				"idType": null,
				"idNumber": null,
				"financialInstitution": "Coop",
				"primaryAccountNumber": "4949",  // Account number
				"mccmnc": 63902,
				"ccy": 404,
				"country": "KE",
				"purpose": "Disbursement",
				"institutionIdentifier": "545500"  // Paybill number
			},
			"transaction": {
				"routeId": "F012CA13-D28F-F011-8575-062AB3A3EAC8",
				"channelType": 14,
				"amount": 3450.0,
				"reference": "{{$guid}}",
				"systemTraceAuditNumber": "{{$guid}}",
				"accountNo": "4949"  // Account number
			}
		}
	]
}

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://auth.zamupay.com/v1/payment-order/new-order' \
--header 'Authorization: Bearer <token>'
Response Response Example
{}
Modified at 2026-04-20 11:53:05
Previous
Mobile Transfers - Airtel Money
Next
Payment Order Requests - Bank Transfers
Built with