logo
Merchant Invoices APICreate invoice (no payment method yet)

Create Invoice

curl -X POST "https://api.example.com/v1/api/v1/create-invoice" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{
  "amount": "1500.00",
  "callback_url": "https://yoursite.com/webhooks/payment",
  "currency_code": "UAH",
  "customer_id": "user_12345",
  "external_id": "order-2026-0001",
  "fail_url": "https://yoursite.com/payment/failed",
  "purpose": "Payment for Premium subscription",
  "success_url": "https://yoursite.com/payment/success"
}'
{
  "amount": "1500.00",
  "callback_url": "https://yoursite.com/webhooks/payment",
  "conversion_rate": "41.50",
  "created_at": "2026-02-25T12:00:00Z",
  "currency": "UAH",
  "customer_id": "user_12345",
  "expires_at": "2026-02-25T12:20:00Z",
  "external_id": "order-2026-0001",
  "fail_url": "https://yoursite.com/payment/failed",
  "invoice_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "merchant_usdt": "35.42",
  "payment_link": "https://pay.app.com/a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "purpose": "Payment for Premium subscription",
  "status": "pending",
  "success_url": "https://yoursite.com/payment/success"
}
POST
/api/v1/create-invoice
POST
API Key (header: X-Api-Key)
X-Api-Keystring
Required

Merchant API Key.

Merchant API Key.
Content-Typestring
Required

The media type of the request body

Options: application/json
amountstring
Required

Payment amount in fiat currency

currency_codestring
Required

ISO 4217 currency code (3 uppercase letters)

Pattern: ^[A-Z]{3}$
customer_idstring
Required

Unique customer identifier in your system. Used for rate limiting

Max length: 128
external_idstring
Required

Your unique invoice/order ID. Must be unique per merchant.

Max length: 128
purposestring

Payment description shown to customer on payment page

callback_urlstring

HTTPS URL for webhook notifications. Overrides merchant default webhook_url

success_urlstring

URL to redirect customer after successful payment

fail_urlstring

URL to redirect customer after failed/expired payment

Request Preview
Response

Response will appear here after sending the request

Authentication

header
X-Api-Keystring
Required

API Key for authentication. Merchant API Key.

Body

application/json
amountstring
Required

Payment amount in fiat currency

currency_codestring
Required

ISO 4217 currency code (3 uppercase letters)

customer_idstring
Required

Unique customer identifier in your system. Used for rate limiting

external_idstring
Required

Your unique invoice/order ID. Must be unique per merchant.

purposestring

Payment description shown to customer on payment page

callback_urlstring

HTTPS URL for webhook notifications. Overrides merchant default webhook_url

success_urlstring

URL to redirect customer after successful payment

fail_urlstring

URL to redirect customer after failed/expired payment

Responses

invoice_idstring
Required

Internal invoice ID (UUID). Use this to query invoice status

external_idstring
Required

Your external_id passed in the request

amountstring
Required

Invoice amount in fiat currency

currencystring
Required

Currency code (e.g. UAH, USD)

conversion_ratestring
Required

USDT/fiat conversion rate applied to this invoice

merchant_usdtstring
Required

USDT amount that will be credited to merchant balance after payment (after commissions)

statusstring
Required

Invoice status: pending — awaiting payment, success — paid, expired — not paid in time, cancelled — cancelled

payment_linkstring
Required

URL to redirect the customer for payment. Valid until expires_at

customer_idstring
Required

Customer ID from the request

purposestring

Payment description from the request

callback_urlstring

Webhook URL that will receive payment notifications

success_urlstring

Customer redirect URL on successful payment

fail_urlstring

Customer redirect URL on failed/expired payment

created_atstring
Required

Invoice creation timestamp (ISO 8601 UTC)

expires_atstring
Required

Invoice expiration timestamp (ISO 8601 UTC). After this time the invoice cannot be paid

finished_atstring

Payment completion timestamp (ISO 8601 UTC). null until paid