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.
| Field | Description |
|---|---|
currencystringrequired | One of UGX, KES, TZS, RWF or CDF. It decides the country and the wallet used. |
amountintegerrequired | A positive whole number in that currency. No decimals. |
phonestringrequired | The mobile money number, e.g. +256701234567. A local number (0701234567) also works. |
descriptionstring | Shown in your dashboard. Up to 140 characters. |
Request
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.