status field and a human-readable message. Always branch on status rather than HTTP code alone.
Status values
Example failure
Common errors
Insufficient wallet balance
Insufficient wallet balance
Top up your wallet from the dashboard before retrying.
Duplicate request-id
Duplicate request-id
A transaction with that
request-id already exists — the original result is returned instead of charging again. Use a fresh request-id for a new purchase.Invalid plan or network
Invalid plan or network
Check the plan ID / network ID against the catalog endpoints or the dashboard’s Pricing & Plan IDs page.

