# 订单查询与取消
## 查询充值结果
跟进订单与续费
### 订单详情
GET `/v1/apps/chatgpt-recharge/orders/{id}` API Key
按本站订单编号读取已记录的结果。先看 status，再决定是否继续刷新进度。
#### 请求参数
**id** · path · string · 必填
创建充值时返回的本站订单编号。
### 响应字段说明
**id / key\_id** · string
本站订单编号和发起充值的 API Key 编号；网页订单 key\_id 为空。当前账户的 API Key 可查询该账户的网页和 API 历史订单。
**status / settled** · string / boolean
pending\_admin 等待管理员代充、manual\_processing 管理员手动代充中、submitting 提交中、processing 处理中、unknown 待核实、success 成功、failed 失败。settled=true 表示本次全部积分已完成结算或退款。HTTP 200 只表示请求已处理。
**fee** · decimal string
下单时锁定的积分合计，代充包括订阅费与平台服务费。处理中预留，成功后转为消费，确认失败后原路退回。
**account / card\_last4** · string
脱敏邮箱和银行卡后四位。Session 不写入订单响应或日志。代充申请加密暂存 Session，平台提交、手动结算、取消或资料过期后清除；完整卡号与 CVV 仅在本次处理内存中使用，最长 15 分钟，不写入数据库或日志。
**payment\_amount / payment\_currency** · string
充值通道返回的实际卡支付金额和原始币种，未返回时为空；不保证是 USD。payment\_minor 是可选的最小货币单位金额，不能对所有币种一律除以 100。
**renewal\_status / failure\_code** · string
自动续费处理状态及失败分类，可能为空。PAYMENT\_RISK\_CONTROL 表示上游支付风控拦截；PAYMENT\_VERIFICATION\_REQUIRED 表示需要支付安全验证；RECHARGE\_FAILED 表示原因尚未识别，已结算的此类失败订单可通过 refresh 查询原因，不会重复结算。ASSISTED\_MANUAL\_FAILED 表示管理员确认手动代充失败并退款。renewal\_status=success 表示通道或办理管理员确认取消成功；failed 时应提醒用户在 ChatGPT 中检查订阅。
**failure\_message** · string
后端生成的公开失败原因，页面和客户端应原样展示；历史记录可能为空。
只能查看当前本站账户的订单，包括该账户从网页和 API 创建的订单。不存在或不属于当前账户的订单均返回 404。
调用示例请求与响应分开查看
### cURL 请求
```bash
curl 'https://y.junlistudio.com/v1/apps/chatgpt-recharge/orders/ORDER_ID' \
-H 'Authorization: Bearer YOUR_API_KEY'
```
### 响应 JSON
```json
{
"id": "ORDER_ID",
"key_id": "KEY_ID",
"account": "al***@example.com",
"product": "plus",
"country": "US",
"seats": 0,
"premium_seats": 0,
"promo": false,
"cancel_renewal": true,
"card_last4": "4242",
"fee": "800.00000000",
"status": "processing",
"progress": 0,
"renewal_status": "",
"failure_code": "",
"payment_amount": "",
"payment_currency": "",
"payment_country": "",
"payment_minor": null,
"settled": false,
"created_at": "2026-10-12T12:01:00Z",
"updated_at": "2026-10-12T12:01:00Z"
}
```
将占位值替换为你的数据 · 示例不发起真实请求
金额、日期和地区数量均为结构示例。目录示例仅展示一个地区与套餐，实际以接口返回为准。
### 刷新进度
POST `/v1/apps/chatgpt-recharge/orders/{id}/refresh` API Key
向充值通道查询最新进度，确认结果后完成服务费结算或退款。无需请求体。
#### 请求字段
**id** · path · string · 必填
需要更新进度的本站订单编号。
### 响应字段说明
**status / settled** · string / boolean
pending\_admin 等待管理员代充、manual\_processing 管理员手动代充中、submitting 提交中、processing 处理中、unknown 待核实、success 成功、failed 失败。settled=true 表示本次全部积分已完成结算或退款。HTTP 200 只表示请求已处理。
**fee** · decimal string
下单时锁定的积分合计，代充包括订阅费与平台服务费。处理中预留，成功后转为消费，确认失败后原路退回。
建议至少间隔 5 秒调用；服务端会合并短时间内的重复查询。success / failed 时停止轮询；unknown 需要管理员核实。
调用示例请求与响应分开查看
### cURL 请求
```bash
curl -X POST 'https://y.junlistudio.com/v1/apps/chatgpt-recharge/orders/ORDER_ID/refresh' \
-H 'Authorization: Bearer YOUR_API_KEY'
```
### 响应 JSON
```json
{
"id": "ORDER_ID",
"key_id": "KEY_ID",
"account": "al***@example.com",
"product": "plus",
"country": "US",
"seats": 0,
"premium_seats": 0,
"promo": false,
"cancel_renewal": true,
"card_last4": "4242",
"fee": "800.00000000",
"status": "processing",
"progress": 0,
"renewal_status": "",
"failure_code": "",
"payment_amount": "",
"payment_currency": "",
"payment_country": "",
"payment_minor": null,
"settled": false,
"created_at": "2026-10-12T12:01:00Z",
"updated_at": "2026-10-12T12:01:00Z"
}
```
将占位值替换为你的数据 · 示例不发起真实请求
金额、日期和地区数量均为结构示例。目录示例仅展示一个地区与套餐，实际以接口返回为准。
### 历史订单
GET `/v1/apps/chatgpt-recharge/orders` API Key
分页读取当前账户的充值历史，按创建时间倒序排列，可筛选订单状态。
#### 请求参数
**page** · integer · 可选
默认 1，范围 1–100000，每页 20 条。
**status** · string · 可选
可选 pending\_admin、manual\_processing（管理员手动代充中）、submitting、processing、unknown、success、failed；省略则返回全部状态。
### 响应字段说明
**items / total / page** · array / integer / integer
本页订单、总条数和当前页码。items 中每项与订单详情字段一致。
订单仅返回脱敏账号和卡号后四位。未返回完整 Session、完整银行卡信息或内部费用信息。
调用示例请求与响应分开查看
### cURL 请求
```bash
curl 'https://y.junlistudio.com/v1/apps/chatgpt-recharge/orders?page=1&status=processing' \
-H 'Authorization: Bearer YOUR_API_KEY'
```
### 响应 JSON
```json
{
"items": [
{
"id": "ORDER_ID",
"key_id": "KEY_ID",
"account": "al***@example.com",
"product": "plus",
"country": "US",
"seats": 0,
"premium_seats": 0,
"promo": false,
"cancel_renewal": true,
"card_last4": "4242",
"fee": "800.00000000",
"status": "processing",
"progress": 0,
"renewal_status": "",
"failure_code": "",
"payment_amount": "",
"payment_currency": "",
"payment_country": "",
"payment_minor": null,
"settled": false,
"created_at": "2026-10-12T12:01:00Z",
"updated_at": "2026-10-12T12:01:00Z"
}
],
"total": 1,
"page": 1
}
```
将占位值替换为你的数据 · 示例不发起真实请求
金额、日期和地区数量均为结构示例。目录示例仅展示一个地区与套餐，实际以接口返回为准。
### 取消代充
POST `/v1/apps/chatgpt-recharge/orders/{id}/cancel` API Key
取消仍处于 pending\_admin 的代充申请，原路退回全部订阅积分和平台服务费，并清除暂存 Session。
#### 请求字段
**id** · path · string · 必填
待处理的本站代充订单编号。
### 响应字段说明
**status / settled** · string / boolean
pending\_admin 等待管理员代充、manual\_processing 管理员手动代充中、submitting 提交中、processing 处理中、unknown 待核实、success 成功、failed 失败。settled=true 表示本次全部积分已完成结算或退款。HTTP 200 只表示请求已处理。
**fee** · decimal string
下单时锁定的积分合计，代充包括订阅费与平台服务费。处理中预留，成功后转为消费，确认失败后原路退回。
申请开始处理后返回 409，不能再取消。重复取消已由本人取消的同一申请不会重复退款。
调用示例请求与响应分开查看
### cURL 请求
```bash
curl -X POST 'https://y.junlistudio.com/v1/apps/chatgpt-recharge/orders/ORDER_ID/cancel' \
-H 'Authorization: Bearer YOUR_API_KEY'
```
### 响应 JSON
```json
{
"id": "ORDER_ID",
"key_id": "KEY_ID",
"account": "al***@example.com",
"product": "plus",
"country": "US",
"seats": 0,
"premium_seats": 0,
"promo": false,
"cancel_renewal": true,
"card_last4": "4242",
"fee": "800.00000000",
"status": "failed",
"progress": 0,
"renewal_status": "",
"failure_code": "ASSISTED_CANCELLED",
"payment_amount": "",
"payment_currency": "",
"payment_country": "",
"payment_minor": null,
"settled": true,
"created_at": "2026-10-12T12:01:00Z",
"updated_at": "2026-10-12T12:01:00Z",
"assisted": true
}
```
将占位值替换为你的数据 · 示例不发起真实请求
金额、日期和地区数量均为结构示例。目录示例仅展示一个地区与套餐，实际以接口返回为准。
### 上次充值地区
POST `/v1/apps/chatgpt-recharge/last-region` API Key
续费前，查找这个 ChatGPT 账号在当前本站账户下最近一次成功充值的地区。
#### 请求字段
**account\_id** · string · 必填
来自完整 ChatGPT Session 的 account.id。
### 响应字段说明
**country / account / created\_at** · string
上次成功充值的地区、脱敏账号及创建时间。没有记录时仅返回 {"country":""}。
同一 ChatGPT 账号建议选择同一地区续费。没有查到记录，不代表该账号从未在其他渠道订阅。
调用示例请求与响应分开查看
### cURL 请求
```bash
curl -X POST 'https://y.junlistudio.com/v1/apps/chatgpt-recharge/last-region' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
--data '{"account_id":"CHATGPT_ACCOUNT_ID"}'
```
### 请求 JSON
```json
{
"account_id": "CHATGPT_ACCOUNT_ID"
}
```
### 响应 JSON
```json
{
"country": "US",
"account": "al***@example.com",
"created_at": "2026-10-12T12:01:00Z"
}
```
将占位值替换为你的数据 · 示例不发起真实请求
金额、日期和地区数量均为结构示例。目录示例仅展示一个地区与套餐，实际以接口返回为准。