代充放单API
POST
/api/merchant/upload_order
1、状态编码说明
错误码 (错误以错误码为主，同一错误码有不同的错误原因，方便跟踪问题)
2.请求参数:
| 参数名称 | 参数类型 | 是否必须 | 参数描述 |
|---|---|---|---|
| biz_no | string | 是 | 商品编码； 权益业务必传 话费油卡可忽略 |
| source_pack_id | string | 否 | 资源编码，不传时使用默认资源，代充业务可忽略 |
| datas | array | 是 | 商品规格数据包，一维数组 |
| third_id | string | 是 | 商家侧订单ID |
| call_back_url | string | 否 | 回调地址（如不填则使用商户后台配置的地址）外网可访问 |
参数说明
【调用“获取产品列表”接口实时查看平台产品】
【页面实时查看平台产品：查看 】
当参数中需要传递 card_pwd时 需要进行加密后传递
| 业务类型 | 商品编码（必传） biz_no | 业务名称 | datas参数 | 资源id | 备注 |
|---|---|---|---|---|---|
| 代充 | SK000001 | 中石油代充 （已维护） | datas:[" "target":'充值账号', //16671829*** "amount": "充值金额",//1,10,20,30,50,100,200,300,500 "card_no": "卡号",//98220039665497 "card_pwd": "卡密"//x3OOYokmHzRomYNZUz8sDJItBEHpL3CFAo+76sDm1/8= ] 【卡密加密参考下方card_pwd加密方法】 | -- | 代充-油卡代充 |
| 代充 | SK000002 | 电信卡密代充 | 同上 | -- | 代充-话费代充 |
| 代充 | SK000020 | 联通卡密代充 | 同上 | -- | 代充-话费代充 |
| 错误码 | 接口 | 错误描述 | 处理结果 |
|---|---|---|---|
| 0 | 所有 | 成功 | 订单推送成功 |
| 10001 | 所有 | 参数错误 | 接口访问失败 |
| 10002 | 所有 | 签名错误 | 接口访问失败 |
| 10003 | 所有 | 时间戳超期 | 接口访问失败 |
| 10004 | 所有 | 商户不存在 | 接口访问失败 |
| 10005 | 所有 | 商户被禁用 | 接口访问失败 |
| 10006 | 所有 | 商户请求IP错误 | 接口访问失败 |
| 10010 | 所有 | 第三方订单号已存在 | 不用处理，查单获取结果 |
| 10011 | 所有 | 账户余额不足 | 接口访问失败 |
| 10012 | 所有 | 渠道不可用或无资源 业务配置异常 | 接口访问失败 |
| 10013 | 所有 | 充值故障，请稍后再试 | 接口访问失败 |
| 10014 | 所有 | 充值号码有问题（号码格式错误、空号或已拉黑） | 处理失败 |
| 10015 | 所有 | 订单不存在 | 一分钟后查单不存在，则处理失败 |
| 10016 | 所有 | 请求太频繁，请稍后重试 | 接口访问失败 |
订单状态说明：
| state | 状态名 | 备注 | 处理结果 |
|---|---|---|---|
| 1 | 待处理 | 未进行充值 | 处理中 |
| 11 | 待账号验证 | 未进行充值 | 处理中 |
| 12 | 账号验证中 | 未进行充值 | 处理中 |
| 2 | 处理中 | 开始进行充值 | 处理中 |
| 3 | 充值成功 | 充值结果 | 处理成功 |
| 4 | 充值失败 | 充值结果 | 处理失败 |
| 41 | 充值结果未知 | 充值结果未知 | 人工核实 |
| 6 | 失败已退款 | 充值结果 | 处理失败 |
当state=4或6时 充值失败会返回 error_code
| error_code | 说明 |
|---|---|
| 1 | 充值号码问题 |
| 2 | 卡号卡密问题 |
| 3 | 未进行充值 |
| 4 | 其他问题 |
2、card_pwd加密方法
PHP示例：
JAVA示例：
请求参数
Header 参数
Body 参数application/json
请求示例代码
返回响应
修改于 2025-07-30 07:15:05