Authentication

Authenticate API requests with your secret key.

All API requests must be made over HTTPS and authenticated with a secret key in the Authorization header:

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx
  • sk_live_… keys create real invoices on mainnet.
  • sk_test_… keys create test invoices on TRON Nile / BSC Testnet.

Keys belong to a store. Secrets are stored hashed and displayed once; if you lose one, regenerate it. You can restrict a key to a list of IP addresses or CIDR ranges.

Idempotency

Send an Idempotency-Key header on POST requests. Repeating a request with the same key within 24 hours returns the original response instead of creating a duplicate.

Language

Error messages are returned in English or Arabic based on ?lang=ar or the Accept-Language header.

Need help? Contact us Last updated: Nov 17, 2026