充值接单

业务描述

本文档适用于供货商接三网话费、加油卡充值订单，非采购文档

通用说明

sign签名计算方式

请求全参数ascii从小到大排序，例如a=1&b=2&key=商户密钥，md5后转小写

请求方式

全接口使用post json请求，编码格式utf8

充值下单

请求参数

字段	类型	描述
customerId	Int	商户ID
orderId	String	订单号
account	String	充值账号
productCode	String	充值商品编码（商户设置）
productId	Int	系统商品编号
price	BigDecimal	供货价格,保留4位小数
notifyUrl	String	异步通知请求地址
money	Int	充值金额
sign	String	参考sign签名计算方式

请求示例


{
    "account": "18600000000",
    "customerId": "1001",
    "money": "100",
    "notifyUrl": "https://baidu.com",
    "orderId": "10000000013",
    "price": "100.0000",
    "productCode": "LT100",
    "productId": "24",
    "sign": "5bd1929b2ce8dffd857bd036bfd67ba0"
}

返回字段

字段	类型	描述
orderNo	String	订单号
status	String	0接收成功,1充值失败,2订单存疑
message	String	备注信息

返回示例


{
    "orderId":"101010011010",
    "status":"0",
    "message":"sucess"
}

订单查询

请求参数

字段	类型	描述
orderNo	String	订单号
customerId	Int	商户ID
account	String	充值账号
money	Int	充值金额
sign	String	参考sign签名计算方式

请求示例


{
  "orderId": "c56d13cd-f331-44b5-9c74-ce2e519fa62e",
  "customerId": "1001",
  "account": "18088888888",
  "money": "100",
  "sign": "897400f47ae867f7e76251d33ab29bda"
}

返回字段

字段	类型	可选	描述
orderNo	String	否	订单号
status	String	否	0充值成功,1充值失败,3充值中
cardNo	String	是	充值卡卡号
voucher	String	是	凭证，可以是流水号、充值短信等
message	String	否	提示信息

返回示例


{
  "orderNo": "c56d13cd-f331-44b5-9c74-ce2e519fa62e",
  "status": "0",
  "cardNo": "982101238396994",
  "voucher": "100401101062112091128100044505",
  "message": "充值成功"
}

异步通知

请求参数

字段	类型	可选	描述
customerId	String	否	商户ID
orderNo	String	否	订单号
status	String	否	0充值成功,1充值失败
cardNo	String	是	充值卡卡号
voucher	String	是	凭证，可以是流水号、充值短信等
message	String	否	提示信息
sign	Sting	是	参照sign签名计算方式

请求示例


{
  "orderNo": "c56d13cd-f331-44b5-9c74-ce2e519fa62e",
  "status": "0",
  "cardNo": "982101238396994",
  "voucher": "100401101062112091128100044505",
  "message": "充值成功",
  "sign": "897400f47ae867f7e76251d33ab29bda"
}

返回示例

无返回信息并且http code == 200 即正常接收