Query recharge options and orders¶
Inspect recharge currencies, channels, and tiers available to an account, and list existing recharge orders. This task only queries data; it does not create orders or make payments.
Prerequisites¶
Prepare a valid personal access token for the user who owns the billing account. Follow Query accounts and billing settings to obtain the target account ID. For service URLs and authentication, see Service URLs and authentication.
Call sequence¶
To inspect available recharge choices, get recharge options and review currencies, channels, and tiers.
To inspect existing recharge records, list recharge orders with the required filters.
If additional pages are available, continue using the returned next-page indicator.
API operations¶
Task |
API operation |
When to use or what to verify |
|---|---|---|
Inspect recharge choices |
Read currencies, channels, and tiers available to the account. |
|
Inspect existing orders |
Inspect order amounts and the returned order status. |
Confirm the result¶
Check amounts, currencies, and order status in List recharge orders. The list is empty when no orders exist; querying recharge options does not create an order.
Limitations and notes¶
A successful query does not mean that payment succeeded or the balance increased. Query the account overview to inspect the current balance.