Skip to main content
POST
/
make_payment
Make Payment
curl --request POST \
  --url https://mobiska-api.stimuluzdev.com/make_payment \
  --header 'Content-Type: application/json' \
  --data '
{
  "service_id": 123,
  "reference": "<string>",
  "nickname": "<string>",
  "transaction_id": "<string>",
  "trans_type": "<string>",
  "customer_number": "<string>",
  "nw": "<string>",
  "amount": 123,
  "payment_option": "<string>",
  "callback_url": "<string>",
  "currency_code": "<string>"
}
'
{
  "response_code": "<string>",
  "response_message": "<string>"
}
Process a payment transaction using mobile money, cards, or hosted checkout.

​
Authentication

All requests must include Basic Authentication header. See Authentication for more details. 
Authorization: Basic YOUR_ENCODED_API_KEYS

​
Example Request

curl -X POST https://mobiska-api.stimuluzdev.com/make_payment \
  -H "Authorization: Basic YOUR_ENCODED_API_KEYS" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": 2,
    "reference": "Payment on PasquoAI",
    "nickname": "PasquoAI",
    "transaction_id": "5",
    "trans_type": "CTM",
    "customer_number": "0541840988",
    "nw": "MTN",
    "amount": 1,
    "payment_option": "MOM",
    "callback_url": "https://your-callback-url.com/webhook",
    "currency_code": "GHS",
    "currency_val": 1,
    "request_time": "2025-01-30T16:31:56Z"
  }'

​
Request Body

​
service_id
integer
required
Your service identifier
​
reference
string
required
Payment description or reference
​
nickname
string
required
Merchant name or identifier
​
transaction_id
string
required
Unique transaction identifier
​
trans_type
string
required
Transaction type (e.g., “CTM” for customer to merchant)
​
customer_number
string
required
Customer’s phone number
​
nw
string
required
Network provider code:
  • MTN: MTN Mobile Money
  • VOD: Vodafone Cash
  • AIR: AirtelTigo Money
  • VIS: Visa Card
  • MAS: Mastercard
​
amount
number
required
Transaction amount
​
payment_option
string
required
Payment method:
  • MOM: Mobile Money
  • CRD: Bank Cards
  • CRM: Hosted Checkout (Mobile Money and Cards)
​
callback_url
string
required
URL to receive transaction status updates
​
currency_code
string
required
Three-letter currency code (e.g., “GHS”)

​
Response

​
response_code
string
Status code of the request
​
response_message
string
Human-readable status message
{
  "response_message": "Request successfully received for processing",
  "response_code": "202"
}