Payments

POST /payments/initiate

Initiates an inbound mobile money payment.

Request body

Field	Type	Required	Description
amount	number	✅	Amount in currency unit
currency	string	—	XOF by default
operatorSlug	string	✅	Operator slug (e.g. orange-money-ci)
customerPhone	string	✅	Payer's phone number
customerName	string	—	Payer's name
customerEmail	string	—	Payer's email
merchantRef	string	—	Internal merchant reference
notifyUrl	string	—	Webhook notification URL
successUrl	string	—	Redirect on success
failedUrl	string	—	Redirect on failure
description	string	—	Transaction description
metadata	object	—	Free-form data

GET /payments/:reference

Retrieves a payment status by its reference.