Error Reference
This page covers all server error codes surfaced by the Payments & SMS API and re-emitted by the Android SDK.
Use it to decide how your app should react (retry, show a toast, log & fail, etc.).
Related docs
- Android SDK guide: Payments SDK Integration Guide for Android
- Payments API reference: Payments API Reference
- Purchase restore & SMS: Purchase Restore and SMS Authentication
Error format
All errors are returned as JSON objects in the following format:
{
"code": "error_code",
"msg": "error_message"
}
Category cheatsheet
| Category | Code ranges |
|---|---|
| Success | 0 |
| Auth / Session | 1, 1001, 10020–10023 |
| Validation & Integration | 10001–10019 |
| User Account | 20001–20003 |
30001–30003 | |
| Alipay | 40001 |
| Payment | 50001–50022 |
| Device / Report | 60001 |
| Service Config | 70002–70007 |
| System | 99998–99999 |
Note on 99999 (Android SDK)
On the Android SDK, 99999 means the SDK caught an unexpected local exception while processing the request or payment flow — for example a missing Activity, a dependency/configuration problem, or a JSON parsing error. It is not, by itself, a specific payment-provider or backend decline.
Do not classify a 99999 from the error code alone: obtain the underlying Android exception and surrounding logs first. See Troubleshooting → Understanding SDK error 99999.
Downloads
If you encounter undocumented errors or behavior, please contact support with the traceId of your request.