Skip to main content
POST /api/v1/payments Idempotency-Key required. Idempotency.

​
Body

FieldRequiredNotes
amount, currency, type, customeryes
phone, networkmobile
reference, metadatano
webhook_urlnoStatus events; overrides merchant default
callback_urlnoTerminal status only; overrides merchant default
type: "mobile" with phone and network:
networkProvider
VODACOMM-Pesa
TIGOTigo Pesa
AIRTELAirtel Money
HALOTELHalopesa
TTCLT-Pesa
card and dynamic-qr not available for new collections yet.
Webhooks

API reference

POST /api/v1/payments
curl -X POST "https://meet.briq.tz/api/v1/payments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"amount":5000,"currency":"TZS","type":"mobile","phone":"255700000000","network":"AIRTEL","customer":{"firstname":"John","lastname":"Doe","email":"[email protected]"},"reference":"ORDER_123","webhook_url":"https://api.example.com/meetpay/webhooks"}'