Skip to main content
POST
/
api
/
v1
/
payments
curl --request POST \
  --url https://meet.briq.tz/api/v1/payments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "amount": 5000,
  "currency": "TZS",
  "type": "mobile",
  "phone": "255700000000",
  "network": "AIRTEL",
  "customer": {
    "firstname": "John",
    "lastname": "Doe",
    "email": "[email protected]"
  },
  "reference": "ORDER_12345",
  "metadata": {
    "item_id": "PROD_001"
  }
}
'
{
  "id": "<string>",
  "status": "<string>",
  "payment_url": "<string>",
  "qr_code": "<string>"
}

Authorizations

​
Authorization
string
header
required

API key obtained from the merchant dashboard. When using the 'Try It' feature, enter only the key—the 'Bearer ' prefix is added automatically. For direct API calls, the 'Authorization: Bearer ' format is mandatory.

Headers

​
Idempotency-Key
string<uuid>
required

A unique UUID to prevent duplicate transactions. Retrying a request with the same key will return the previous result.

Example:

"123e4567-e89b-12d3-a456-426614174000"

Body

application/json
​
amount
number
required
​
currency
enum<string>
default:TZS
required
Available options:
TZS
​
type
enum<string>
required

Use mobile for collections today. card and dynamic-qr are not enabled for new collections yet.

Available options:
mobile,
card,
dynamic-qr
​
customer
object
required
​
phone
string
​
network
enum<string>
Available options:
VODACOM,
AIRTEL,
TIGO,
HALOTEL,
TTCL
​
reference
string
​
webhook_url
string

Per-payment webhook URL. Overrides merchant webhook_url when set.

​
callback_url
string

Per-payment callback URL for terminal status. Overrides merchant callback_url when set.

​
metadata
object

Response

200 - application/json

Payment created successfully

​
id
string
​
status
string
​
payment_url
string
​
qr_code
string