接口详情
GET /v1/admin/recharges/orders
List reconciled recharge order heads
- operationId
listAdminRechargeOrders- 认证
- 登录会话：主控登录后的 Bearer 会话，由客户本人在自己的主控里使用；插件不能要求客户交出会话。
- 所需权限
契约没有单独标注权限码，权限要求见下方说明与 403 响应。
参数
listAdminRechargeOrders 参数| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|
X-Request-ID | header | string | 是 | — |
|---|
page | query | integer | 否 | — |
|---|
limit | query | integer | 否 | — |
|---|
channel | query | string: alipay / wechat / transfer / usdt | 否 | — |
|---|
state | query | string: pending / paid / partially_refunded / refunded / voided / failed / canceled / reconcile_required | 否 | — |
|---|
tenant_scope_id | query | string(uuid) | 否 | — |
|---|
user_id | query | string(uuid) | 否 | — |
|---|
from | query | string(date-time) | 否 | — |
|---|
to | query | string(date-time) | 否 | — |
|---|
snapshot_at | query | string(date-time) | 否 | Reuse snapshot_at returned by the first page to keep later pages and CSV on the same fact boundary. |
|---|
响应
listAdminRechargeOrders 响应| 状态码 | 说明 |
|---|
200 | Stable database snapshot 字段：items: array<RechargeOrder> total: integer(int64) page: integer limit: integer snapshot_at: string(date-time) |
|---|
400 | Stable error code; message is not safe for direct UI rendering |
|---|
401 | Stable error code; message is not safe for direct UI rendering |
|---|
403 | Stable error code; message is not safe for direct UI rendering |
|---|
失败时怎么办
400 按字段说明修正参数或请求体再发；不要原样重试。401 检查凭据格式、是否过期或被轮换。403 检查 Key 范围与所有者当前权限、当前租户作用域；不要换更高权限账号绕过。
↑ 回到列表
GET /v1/admin/recharges/orders/{order_id}/reconciliation
Read exact order, callback, ledger and statistics identities
- operationId
getRechargeReconciliation- 认证
- 登录会话：主控登录后的 Bearer 会话，由客户本人在自己的主控里使用；插件不能要求客户交出会话。
- 所需权限
契约没有单独标注权限码，权限要求见下方说明与 403 响应。
参数
getRechargeReconciliation 参数| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|
X-Request-ID | header | string | 是 | — |
|---|
order_id | path | string(uuid) | 是 | — |
|---|
响应
getRechargeReconciliation 响应| 状态码 | 说明 |
|---|
200 | Exact four-way reconciliation 字段：order: RechargeOrder callback: RechargeCallbackFact ledger: RechargeLedgerFact statistic: RechargeStatistic provider_events: array<RechargeProviderEventFact> ledger_entries: array<RechargeLedgerFact> gross_amount_minor: integer(int64) refunded_amount_minor: integer(int64) net_amount_minor: integer(int64) |
|---|
401 | Stable error code; message is not safe for direct UI rendering |
|---|
403 | Stable error code; message is not safe for direct UI rendering |
|---|
404 | Stable error code; message is not safe for direct UI rendering |
|---|
503 | Stable error code; message is not safe for direct UI rendering |
|---|
失败时怎么办
401 检查凭据格式、是否过期或被轮换。403 检查 Key 范围与所有者当前权限、当前租户作用域；不要换更高权限账号绕过。404 资源不存在或不属于当前租户。503 依赖暂不可用：稍后用原 Idempotency-Key 重试。
↑ 回到列表
GET /v1/admin/recharges/statistics
List immutable settlement statistics facts
- operationId
listRechargeStatistics- 认证
- 登录会话：主控登录后的 Bearer 会话，由客户本人在自己的主控里使用；插件不能要求客户交出会话。
- 所需权限
契约没有单独标注权限码，权限要求见下方说明与 403 响应。
参数
listRechargeStatistics 参数| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|
X-Request-ID | header | string | 是 | — |
|---|
page | query | integer | 否 | — |
|---|
limit | query | integer | 否 | — |
|---|
channel | query | string: alipay / wechat / transfer / usdt | 否 | — |
|---|
tenant_scope_id | query | string(uuid) | 否 | — |
|---|
user_id | query | string(uuid) | 否 | — |
|---|
from | query | string(date-time) | 是 | — |
|---|
to | query | string(date-time) | 是 | — |
|---|
snapshot_at | query | string(date-time) | 否 | Reuse snapshot_at returned by the first page to keep later pages and CSV on the same fact boundary. |
|---|
响应
listRechargeStatistics 响应| 状态码 | 说明 |
|---|
200 | Totals and rows from one stable snapshot 字段：items: array<RechargeStatistic> total_amount_minor: integer(int64) total_gross_amount_minor: integer(int64) total_refunded_amount_minor: integer(int64) total_net_amount_minor: integer(int64) total_orders: integer(int64) page: integer limit: integer snapshot_at: string(date-time) |
|---|
400 | Stable error code; message is not safe for direct UI rendering |
|---|
401 | Stable error code; message is not safe for direct UI rendering |
|---|
403 | Stable error code; message is not safe for direct UI rendering |
|---|
失败时怎么办
400 按字段说明修正参数或请求体再发；不要原样重试。401 检查凭据格式、是否过期或被轮换。403 检查 Key 范围与所有者当前权限、当前租户作用域；不要换更高权限账号绕过。
↑ 回到列表
GET /v1/admin/recharges/statistics.csv
Export the same bounded settlement snapshot as CSV
- operationId
exportRechargeStatistics- 认证
- 登录会话：主控登录后的 Bearer 会话，由客户本人在自己的主控里使用；插件不能要求客户交出会话。
- 所需权限
契约没有单独标注权限码，权限要求见下方说明与 403 响应。
参数
exportRechargeStatistics 参数| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|
X-Request-ID | header | string | 是 | — |
|---|
channel | query | string: alipay / wechat / transfer / usdt | 否 | — |
|---|
tenant_scope_id | query | string(uuid) | 否 | — |
|---|
user_id | query | string(uuid) | 否 | — |
|---|
from | query | string(date-time) | 是 | — |
|---|
to | query | string(date-time) | 是 | — |
|---|
snapshot_at | query | string(date-time) | 否 | Reuse snapshot_at returned by the first page to keep later pages and CSV on the same fact boundary. |
|---|
响应
exportRechargeStatistics 响应| 状态码 | 说明 |
|---|
200 | UTF-8 CSV, at most 10000 facts |
|---|
400 | Stable error code; message is not safe for direct UI rendering |
|---|
401 | Stable error code; message is not safe for direct UI rendering |
|---|
403 | Stable error code; message is not safe for direct UI rendering |
|---|
失败时怎么办
400 按字段说明修正参数或请求体再发；不要原样重试。401 检查凭据格式、是否过期或被轮换。403 检查 Key 范围与所有者当前权限、当前租户作用域；不要换更高权限账号绕过。
↑ 回到列表