代充放单API

当前代充业务，通过本接口提交到平台

1、状态编码说明

错误码 (错误以错误码为主，同一错误码有不同的错误原因，方便跟踪问题)

错误码	接口	错误描述	处理结果
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 参数

appSecret

string

可选

测试账号的appSecret，正式调用的时候，不用上传这个header字段的

示例值:

790a423c81774f6811

Body 参数application/json

app_key

string

【公共参数】系统分配给商户的秘钥

必需

timestamp

integer

【公共参数】Unix时间戳

必需

时区为 GMT+8 允许与服务器最大误差30秒

sign

string

【公共参数】签名

必需

所有请求参数签名

biz_no

string

商品编码

必需

权益、虚拟币、一手卡密业务必传话费油卡可忽略

third_id

string

商家侧订单ID

必需

call_back_url

string

回调地址

必需

（如不填则使用商户后台配置的地址）外网可访问

datas

object

数据包

必需

target

string

充值账号

必需

13800138000

amount

string

充值金额

必需

1,10,20,30,50,100,200,300,500等

card_no

string

卡号

必需

98220039665497

card_pwd

string

卡密

必需

76sDm1/8=，【卡密加密参考上方的card_pwd加密方法】

示例

{
    "app_key": "82162472761",
    "timestamp": "",
    "sign":"sgsdsg3aasdgdsgsdfs434343efset43",
    "biz_no":"SK000020", 
    "third_id":"223221352192444",
    "call_back_url":"http:xxx.xxx.com",
    "datas":{
        "target": "15541413177",
        "amount": "100", 
        "card_no":"112500001770813",
        "card_pwd":"1105926834552733534"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

请求结果

必需

0为成功，其他为错误，详见错误码

message

string

错误信息

必需

stime

number

必需

etime

number

必需

data

object

必需

third_id

string

平台充值订单号

必需

order_id

string

商家侧订单ID

必需

target

string

需要充值的号码（手机号/油卡号）

必需

state

integer

必需

示例

成功示例异常示例

{
    "code": 0,
    "message": "ok",
    "stime": 1698980245.05146,
    "etime": 1698980245.37863,
    "data": {
        "third_id": "1698980245394604",
        "order_id": "23110100762323",
        "target": "1376047xxxx",
        "state": 1,
    }
}

1、状态编码说明#

错误码 (错误以错误码为主，同一错误码有不同的错误原因，方便跟踪问题)#

订单状态说明：#

当state=4或6时 充值失败会返回 error_code#

2、card_pwd加密方法#

PHP示例：#

JAVA示例：#

请求参数

示例代码

返回响应

1、状态编码说明

错误码 (错误以错误码为主，同一错误码有不同的错误原因，方便跟踪问题)

订单状态说明：

当state=4或6时充值失败会返回 error_code

2、card_pwd加密方法

PHP示例：

JAVA示例：