Creating an invoice

POST/api/v1/payment

Request parameters

Name	Type	Definition
amount*	string	Amount to pay, e.g. 10.28
currency*	string	Currency code, e.g. USDT
order_id*	string	Unique order ID in your system
network	string	Blockchain network, e.g. tron
url_callback	string	Webhook URL for payment status
url_success	string	Redirect after successful payment
url_return	string	Return URL on payment page
lifetime	integer	Invoice lifetime in seconds (300–43200)
additional_data	string	Hidden metadata for merchant

Request example

curl /api/v1/payment \
  -X POST \
  -H 'merchant: YOUR_MERCHANT_UUID' \
  -H 'sign: COMPUTED_SIGN' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount": "15",
    "currency": "USDT",
    "order_id": "1",
    "network": "tron"
  }'

Response

Response format: { "state": 0, "result": { ... } }

{
  "state": 0,
  "result": {
    "uuid": "invoice-uuid",
    "order_id": "1",
    "amount": "15",
    "payment_status": "check",
    "url": "https://your-app/pay/...",
    "address": "T...",
    "network": "tron",
    "expired_at": 1753202502,
    "is_final": false
  }
}