顺菏话费充值
  1. 通用规范
顺菏话费充值
  • 通用规范
    • 接口调用规范
    • 订单状态对照表
    • 错误编码对照表
  • 查询
    • 订单查询
      POST
    • 商户余额查询
      POST
  • 下单
    • 话费充值接口
      POST
    • 预下单接口
      POST
  • 回调
    • 异步回调通知
      POST
  1. 通用规范

接口调用规范

通讯协议#

通讯方式:http/https协议通信交易结果
请求URL:https://api.sz186.cn/api
Method:POST
ContentType:application/json;charset=GBK
通讯字符集:GBK 编码

公共请求参数#

1.
签名
sign String(32) 参照签名方式说明
2.
账号
agentAccount String(20) 商户账号
3.
业务接口实体
busiBody Json 参照各业务接口模块

签名方式#

签名算法 md5 采用UTF-8编码
例:sign=md5(busiBody + md5Key)
busiBody: 其中busiBody要和请求参数busiBody的内容完全相同,包括字段的顺序和字段的值都要相同,如有需要做urlEncode编码的字段(如retUrl,ispName)需在请求参数和签名报文里面都要做相同的处理
md5Key: 是你的账户密钥,请联系客户经理发送到开户邮箱
测试账号:
用户名:api_test
密钥:13D5C4F4910EDC34
签名原文示例:
{"action":"CZ","orderId":"Test00000002","chargeAcct":"13530555931","chargeCash":"10","chargeType":"0","retUrl":"http%3A%2F%2Fsy666.com%3A49999"}13D5C4F4910EDC34

安全机制#

接口调用前需提供固定ip白名单给我们运营同事加白(暂时不需要,未来会)
修改于 2025-10-23 08:25:18
下一页
订单状态对照表
Built with