第一步:把你的业务系统接进来。
应用是上游供货方:它把商品推给本平台缓存,阿奇索来问时本平台返回缓存;
真实发货时本平台才调应用的接口取卡密或充值结果。
应用必须填「发货接口地址」,否则阿奇索下单会失败(不会退回用本平台库存)。
配好后去「② 商品」页点「从应用拉取」。
第二步:拉商品。点「从应用拉取商品」,系统会去问应用要商品存到本地, 阿奇索查商品时返回的就是这份缓存。重复拉取是更新,不会产生重复商品。 「手动新增」用于调整价格、上下架、配直充模板。
第三步(仅「本地卡密直发」的商品需要):选中商品后点「导入卡密」。 从应用拉取的商品不用导入卡密——下单时系统会实时调你的应用取货, 库存多少也由应用说了算,本平台只负责转发。 直充商品不需要卡密,这步可以跳过。
多数情况这里只有一条——就是你自己,配好后基本不用再动。 「平台ID」和「接口调用私钥」是你在阿奇索后台的身份凭证,点每行的「接入资料」可直接查看要提交的三项内容; 「上线自检」会在提交前按阿奇索的验收规则跑一遍检查。
服务地址
把下面的地址填到阿奇索开放平台的「接入地址」里:
阿奇索调用本服务(被调用方)
除 getAppId 外,全部需要 sign 签名(ASCII 升序 + 空值参与 + 32 位大写 MD5)。
| 接口 | 路径 | 说明 |
|---|---|---|
| 获取应用ID | POST /agisoAcprSupplierApi/app/getAppId | 匿名,无需签名 |
| 商品列表 | POST /agisoAcprSupplierApi/product/getList | 需签名 |
| 商品模版 | POST /agisoAcprSupplierApi/product/getTemplate | 需签名 |
| 卡密下单 | POST /agisoAcprSupplierApi/order/createPurchase | 需签名 |
| 直充下单 | POST /agisoAcprSupplierApi/order/createRecharge | 需签名 |
| 订单查询 | POST /agisoAcprSupplierApi/order/get | 需签名 |
| 撤销订单 | POST /agisoAcprSupplierApi/order/cancelOrder | 需签名 |
| 订阅调价 | POST /agisoAcprSupplierApi/product/subscribePriceNotify | 需签名 |
| 取消订阅 | POST /agisoAcprSupplierApi/product/cancelSubscribePriceNotify | 需签名 |
| 调价通知 | POST /agisoAcprSupplierApi/product/notifyPriceChange | 需签名(双 AppSecret) |
管理接口(X-Admin-Token 鉴权)
| 用途 | 方法与路径 |
|---|---|
| 健康检查 | GET /healthz(无需令牌) |
| 服务信息 | GET /admin/api/info |
| 接入方列表/新增/更新/删除 | GET POST PUT /admin/api/merchants、DELETE /admin/api/merchants/:userId |
| 商品列表/新增/更新/删除 | GET POST PUT /admin/api/products、DELETE /admin/api/products |
| 卡密导入 | POST /admin/api/cards/import(JSON 或纯文本) |
| 卡密列表/统计 | GET /admin/api/cards、GET /admin/api/cards/stats |
| 订单列表/详情 | GET /admin/api/orders、GET /admin/api/orders/:orderNo |
| 手动重投回调 | POST /admin/api/orders/:orderNo/retry-callback |
开放平台接口(接入方自助,appKey 签名)
接入方用自己的 appKey 签名,只能操作自己名下的数据。
| 用途 | 方法与路径 |
|---|---|
| 商品列表 / 新增 | GET POST /open/api/products |
| 导入卡密 | POST /open/api/cards/import |
| 订单列表 / 详情 | GET /open/api/orders、GET /open/api/orders/:orderNo |
| 回填直充结果 | POST /open/api/orders/:orderNo/complete |
错误码
| code | 含义 |
|---|---|
| 200 | 请求成功(仅代表通信成功) |
| 401 | 签名错误 |
| 403 | IP 不在白名单 |
| 408 | 时间戳过期 |
| 1001 / 1002 | 会员ID无效 / 已被禁用 |
| 1100 / 1101 | 商品不存在 / 未开放 |
| 1220 | 超出订单金额限制 |
| 1230 | 库存不足 |
| 9999 | 其他错误 |
完整文档见项目 docs/ 目录。