话费充值
请求
参数
说明
cpid
商户ID:由SP分配,如10001
type
类型:1
orderid
商户订单号:必须唯⼀一,且不不超过20位,由字⺟母数字组成
mobile
⼿手机号码:要充值的⼿手机号码
amount
充值⾦金金额:单位元,⼩小数点后最多2位,如12、12.34
callback
状态通知地址:http开头的⽹网址,不不参与数据校验,⾮非必填
datetime
时间戳:格式YYYYmmddHHMMSS,如0614151823
sign
数据校验:以上参数以URL形式组合,再加上SP提供的KEY,取MD5值,不不区分⼤大⼩小 写,校验原⽂文如下(其中加号为字符串串链接): cpid=CPID&type=TYPE&orderid=ORDERID&mobile=MOBILE&amount=AMOUNT&da tetime=DATETIME+KEY
应⽤用示例例(POST和GET⽅方式均可,⽣生产环境接⼝口地址请联系客服索取)
http://127.0.0.1/api/submit?
cpid=10001&type=1&orderid=10000000000000000000&mobile=1380000000&amount=10&datetim
e=0101080000&sign=abd3f45e6dd4ae2da919e88083a6c322
响应
参数
说明
cpid
商户ID:由SP分配,如10001
orderid
商户订单号:必须唯⼀一,且不不超过20位,由字⺟母数字组成
status
返回状态码
0000 成功
1001 校验错误
1002 功能暂停
1003 订单号错误
1004 ⼿手机号错误
1005 订单号已存在
1006 余额不不⾜足
1007 内部错误(需联系客服) 1008 内部错误(需联系客服) 1009 内部错误(需联系客服) 1010 内部错误(需联系客服) 1011 内部错误(需联系客服) 1012 内部错误(需联系客服) 1013 内部错误(需联系客服)
应⽤用示例例(JSON)
1/5
博迈通达 话费充值接⼝口 v1.3.0 -04-26
响应
{
“cpid”:”10001”,
“orderid”:”10000000000000000000”,
“status”:”0000”
}
2/5
博迈通达 话费充值接⼝口 v1.3.0 状态通知(单笔)
关于补发:
• 若⾸首次通知接收失败,系统将每隔3分钟补发1次,共补发2次;
• 若3次通知全部接收失败,系统将不不再进⾏行行补发,请调⽤用查询接⼝口进⾏行行查询。
-04-26
请求
参数
说明
cpid
商户ID:由SP分配,如10001
orderid
商户订单号:必须唯⼀一,且不不超过20位,由字⺟母数字组成
status
订单状态:0 充值失败、1 充值成功
datetime
时间戳:格式YYYYmmddHHMMSS,如0614151823
sign
数据校验:以上参数以URL形式组合,再加上SP提供的KEY,取MD5值,不不区分⼤大⼩小 写,校验原⽂文如下(其中加号为字符串串链接): cpid=CPID&orderid=ORDERID&status=STATUS&datetime=DATETIME+KEY
数据示例例(POST⽅方式,JSON格式,接收推送的地址请参看充值接⼝口)
{
“cpid”:”10001”,
“orderid”:”10000000000000000000”,
“status”:”1”,
“datetime”:”0101080000”,
“sign”:”abd3f45e6dd4ae2da919e88083a6c322”
}
响应
商户在接收到通知后3秒内响应,并在⻚页⾯面打印“OK”(不不区分⼤大⼩小写),系统将认定通知接收成功。
3/5
博迈通达 话费充值接⼝口 v1.3.0 -04-26 订单查询(单笔)
注意:仅⽀支持查询当⽉月订单和上⽉月订单!超出此时间范围将返回1004。
请求
参数
说明
cpid
商户ID:由SP分配,如10001
orderid
商户订单号:必须唯⼀一,且不不超过20位,由字⺟母数字组成
datetime
时间戳:格式YYYYmmddHHMMSS,如0614151823
sign
数据校验:以上参数以URL形式组合,再加上SP提供的KEY,取MD5值,不不区分⼤大⼩小 写,校验原⽂文如下(其中加号为字符串串链接): cpid=CPID&orderid=ORDERID&datetime=DATETIME+KEY
应⽤用示例例(POST和GET⽅方式均可,⽣生产环境接⼝口地址请联系客服索取)
http://127.0.0.1/api/search?
cpid=10001&orderid=10000000000000000000&datetime=0101080000&sign=abd3f45e6dd4a
e2da919e88083a6c322
响应
参数
说明
cpid
商户ID:由SP分配,如10001
orderid
商户订单号:必须唯⼀一,且不不超过20位,由字⺟母数字组成
status
返回状态码
0000 充值失败 0001 充值成功 0002 处理理中 1001 校验错误 1002 功能暂停 1003 订单号错误 1004 查⽆无此单
应⽤用示例例(POST和GET⽅方式均可)
{
“cpid”:”10001”,
“orderid”:”10000000000000000000”,
“status”:”0001”
}
4/5
博迈通达 话费充值接⼝口 v1.3.0 -04-26 余额查询
请求
参数
说明
cpid
商户ID:由SP分配,如10001
datetime
时间戳:格式YYYYmmddHHMMSS,如0614151823
sign
数据校验:以上参数以URL形式组合,再加上SP提供的KEY,取MD5值,不不区分⼤大⼩小 写,校验原⽂文如下(其中加号为字符串串链接): cpid=CPID&datetime=DATETIME+KEY
应⽤用示例例(POST和GET⽅方式均可,⽣生产环境接⼝口地址请联系客服索取)
http://127.0.0.1/api/money?
cpid=10001&datetime=0101080000&sign=abd3f45e6dd4ae2da919e88083a6c322
响应
参数
说明
cpid
商户ID:由SP分配,如10001
money
账户余额:单位元,如100.00
status
返回状态码 0000 查询成功 1001 校验错误
应⽤用示例例(JSON)
{
“cpid”:”10001”,
“money”:”100.00”,
“status”:”0000”
}