Skip to main content
POST
Create Invoice

Authorizations

X-Api-Key
string
header
required

Body

application/json
external_id
string
required

Your own order id. Unique per business; used for idempotency.

Required string length: 1 - 128
Example:

"order-4821"

customer_id
string
required

Your identifier for the paying customer.

Required string length: 1 - 128
Example:

"user-99"

amount
required

Base order amount in fiat. Positive, max 2 decimal places.

Required range: x > 0
Example:

"1050.00"

currency
string
required

Fiat currency code. Must be active and allowed for your business.

Required string length: 2 - 16
Example:

"UAH"

purpose
string | null

Optional order description shown to the customer.

Maximum string length: 255
Example:

"Order #4821"

callback_url
string | null

HTTPS webhook URL for settlement. Falls back to business settings.

Maximum string length: 512
Example:

"https://shop.example/webhooks/manexx"

success_url
string | null

HTTPS redirect after successful payment. Falls back to settings.

Maximum string length: 512
Example:

"https://shop.example/paid"

fail_url
string | null

HTTPS redirect after failed payment. Falls back to settings.

Maximum string length: 512
Example:

"https://shop.example/failed"

Response

Successful Response

data
MerchantInvoiceRead · object
required
success
boolean
default:true