API docs · 7 of 14

Request a payment

POST/v1/merchant/collections

Sends a mobile money prompt to the customer's phone. They approve it with their PIN, and the money lands in your wallet for that currency.

FieldDescription
currencystringrequiredOne of UGX, KES, TZS, RWF or CDF. It decides the country and the wallet used.
amountintegerrequiredA positive whole number in that currency. No decimals.
phonestringrequiredThe mobile money number, e.g. +256701234567. A local number (0701234567) also works.
descriptionstringShown in your dashboard. Up to 140 characters.
curl https://api.paranthropus.app/v1/merchant/collections \
  -H "Authorization: Bearer para_test_..." \
  -H "Idempotency-Key: order-1042" \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "UGX",
    "amount": 25000,
    "phone": "+256701234567",
    "description": "Order 1042"
  }'

Response · 201 Created

{
  "success": true,
  "data": {
    "id": "6f1c2a7e-3b0d-4d7a-9a51-2f6e8c1d4b90",
    "reference": "PRN-8F3K2Q91",
    "type": "collection",
    "status": "pending",
    "currency": "UGX",
    "amount": 25000,
    "provider_fee": 500,
    "platform_fee": 0,
    "total": 25500,
    "method": "mobile_money",
    "phone": "+256701234567",
    "description": "Order 1042",
    "idempotency_key": "order-1042",
    "mode": "test",
    "created_at": "2026-11-19T09:30:00.000Z",
    "completed_at": null
  }
}

The same phone number can get at most 5 payment prompts every 10 minutes. More than that returns too_many_prompts.