Invoices

Create an invoice

POST /v2/api/invoices

Create an invoice a wallet user can pay.

Key permission: Receive Funds

Parameters

Name	Type	Description
amount required	decimal	The amount in major units. For example, 10.00 is $10.00 BBD.
currency required	string	The currency code. Use BBD.
merchant_order_id	string	Your unique order ID. A duplicate returns a 422 error.
comment	string	A note shown with the invoice.
is_online_payment	boolean	Set true for payment-button flows.
expires_at	string	Expiry time (ISO 8601, UTC).
metadata	object	Free-form key/value data returned with the invoice.

The request amount is in major units (decimal). Response fields price, paid, and transaction_fee are in cents. See the amounts section in getting started.

curl -X POST "https://api.mmoneybb.com/merchant/v2/api/invoices" \ -H "x-api-key: mm_api_key_XXXX" \ -H "Content-Type: application/json" \ -d '{"amount":"10.00","comment":"Order 123","currency":"BBD","merchant_order_id":"order_123"}'

{ "invoice_id": 3245, "merchant_order_id": "order_124", "currency": "BBD", "price": 1000, "paid": 0, "transaction_fee": 0, "ulid": "01HNG3V4T5CHMZ6GR3YHXDEG4Q", "status": "pending", "created_at": "2026-01-01T00:00:00Z", "updated_at": "2026-01-01T00:00:00Z" }