init

2026-06-16 15:15:50 +08:00
parent 84ab3bad99
commit 1f634eb465
21 changed files with 2776 additions and 41 deletions
--- a/docs/agent-open-api/功能总结.md
+++ b/docs/agent-open-api/功能总结.md
@@ -250,7 +250,7 @@ curl -G "https://open.example.com/api/open/v1/cards/status" \
 - `total_flow_mb`：套餐总流量，单位 MB。
 - `valid_days`：套餐有效天数。

-钱包购买接口一次只允许一个 `package_code`，`card_nos` 最多 100 张卡。每张卡独立创建钱包订单，允许部分成功，失败卡会返回独立错误码和原因。
+钱包购买接口一次只允许一个 `package_code`，`card_nos` 最多 100 张卡。每张卡独立创建钱包订单，允许部分成功，失败卡会返回独立错误码和原因。任一卡购买失败时，外层 `code`/`msg` 返回首条失败卡的错误码和原因，同时 `data.failed_cards` 保留失败明细，`data.orders` 保留已成功订单；接入方应以 `success_count`、`failed_count`、`orders`、`failed_cards` 判断单卡结果，避免整批重试造成重复下单。

 ## 5. 错误码