处理人工充值

API文档最后更新: 2026-10-28

处理人工充值

通用鉴权、响应、返回字段和错误说明见接入指南。

POST /openapi/v1/seller/orders/12345/recharge-result

参数	类型	必填	说明
status	string	是	`processing` 处理中、`success` 成功、`canceled` 取消人工充值并进入原退款流程
message	string	否	处理说明，最多 255 字符

{"status": "success", "message": "充值已完成"}

该操作要求本店是实际履约方。成功、处理中仅用于人工充值；远程货源订单不能用该接口人工写成成功。取消仅适用于当前可取消的人工充值订单，结果通过详情查询确认。

成功 data 为订单详情快照。该请求不支持按 requestNo 建立新的通用幂等语义；重复操作受订单状态约束。

上传充值凭证

同一路径使用 multipart/form-data：

字段	类型	说明
processData	string	JSON 字符串，固定示例 `{"action":"saveRechargeProof"}`
rechargeProofImage	file	JPEG、PNG、WebP 图片，大小不超过 2 MiB，像素总量不超过 4000 万

curl "${KYS_BASE_URL}/openapi/v1/seller/orders/12345/recharge-result" \
  -H "X-KYS-User-Id: ${KYS_USER_ID}" \
  -H "X-KYS-Key: ${KYS_OPENAPI_KEY}" \
  --form 'processData={"action":"saveRechargeProof"}' \
  --form "rechargeProofImage=@${KYS_PROOF_FILE}"

上传凭证与提交充值成功分两次调用。上传成功返回：

{
  "code": 0,
  "message": "success",
  "data": {
    "rechargeProof": {
      "url": "/frontApi/order/recharge-proof/12345?key=EXAMPLE_ACCESS_KEY",
      "uploadedAt": 1793145600,
      "expiresAt": 1793404800
    }
  },
  "requestId": "req_example"
}

凭证链接可能为相对地址，请接在当前商户域名后访问；链接携带访问凭证，应保密，按 expiresAt 判断有效期。