Create mobile payment request

curl -X POST https://api.senjaropay.com/senjaropay/merchant/payments/create \
     -H "x-api-secret: <apiSecret>" \
     -H "x-idempotency-key: unique-key-123" \
     -H "x-api-key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "payment_type": "mobile",
  "details": {
    "amount": 1000,
    "currency": "TZS"
  },
  "phone_number": "255700000001",
  "customer": {
    "firstname": "Test",
    "lastname": "Customer",
    "email": "test.customer@example.com",
    "country": "Tanzania",
    "city": "Dar es Salaam",
    "address": "Sample Street"
  },
  "submerchant_id": "",
  "webhook_url": "https://example.com/webhooks/senjaropay/mock-callback"
}'

{
  "status": "success",
  "code": 200,
  "data": {
    "amount": {
      "currency": "TZS",
      "value": 1000
    },
    "api_version": "2026-01-25",
    "expires_at": "2026-04-17T09:13:54.946Z",
    "object": "payment",
    "payment_type": "mobile",
    "reference": "mock-ref-7b2a4f3e",
    "status": "pending"
  }
}

Creates a USSD push request for customer payment authorization.

Authentication

x-api-keystring

Dashboard Public Key. Maps to x-api-key.

x-api-secretstring

Dashboard Secret Key. Maps to x-api-secret. Server-side only.

Request

This endpoint expects an object.

payment_typeenumRequired

Allowed values:

detailsobjectRequired

phone_numberstringRequired

MSISDN in international format

customerobjectRequired

submerchant_idstringOptional

Optional sub-merchant ID. Send empty string when unused.

webhook_urlstringOptionalformat: "uri"

Response

Payment request accepted

statusstring

codeinteger

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

Authentication

Headers

Request

Response

Errors