灵工系统-对外文档
  1. 签名规则
灵工系统-对外文档
灵工系统-接口文档
  • 灵工系统-接口文档
  • 产品说明
  • 接入说明
  • 返回状态码
  • 常见问题
  • 签名规则
    • MD5签名规则
    • RSA签名规则
  • 接口详情
    • 1 签约
      • 1.1 小程序/H5签约API
      • 1.2 静默签API
      • 1.3 签署结果查询API
      • 1.4 签约异步通知API
      • 1.5 催签API
      • 1.6 人员信息查询
      • 1.7 校验用户并签约
      • 1.8 删除用户签约信息
    • 2 发放
      • 2.1 委托代征佣金发放API
      • 2.2 订单交易明细查询API
      • 2.3 订单回单(成功)分页查询API
      • 2.4 发放异步通知API
      • 2.5 退票异步通知API
      • 2.6 查询用户限额情况
    • 3 任务
      • 3.1 创建任务API
      • 3.2 任务列表查询API
      • 3.3 任务审核异步通知API
    • 4 开票
      • 4.1 查询开票类目API
      • 4.2 开票申请API
      • 4.3 查询开票信息API
      • 4.4 开票异步通知API
      • 4.5 开票账户查询API
    • 5 账户
      • 5.1 余额查询API
      • 5.2 充值异步通知API
      • 5.3 划拨异步通知API
    • 6 同步
      • 6.1 灵工签约合同
      • 6.2 发放订单数据
      • 6.3发放流水回单
      • 6.4 充值流水
    • 7 其他
      • 7.1 银行卡号查询所属银行
  1. 签名规则

MD5签名规则

1.
post与get签名不同,get参数放到url上拼接,post参数放到body内。
2.
生成签名原文时,将请求参数key使用ascll排序,然后将对应的value值拼接起来,如下:
Serctkey+bankType+bizOrderNo+payDetailList+payMethod+remarks+taskNo+totalAmount+totalCount
注意:payDetailList字段(即佣金发放明细),不要ascll排序,字段排序应按如下要求:
payAccountType+detailOrderNo+amount+phone+idCard+accountNo+userName+merchantRemark
佣金发放请求举例如下:
Appkey = "kWb7MeSATqYRb474u6pO0Sw9Es4SitjjRVXXLZ";
Serctkey = "Bwls4lu8EP9znjvvsPpklNK8ofLshIvB2xtoVQ";
请求传参数
{
	"headers": {
		"orderId": ["fa359493-f735-40b4-91bb-1bd506b61063"],
		"agreementId": ["30000089"],
		"sign": ["dc65432ad3f35665f7ca7eb5d80caae6"],
		"appKey": ["kWb7MeSATqYRb474u6pO0Sw9Es4SitjjRVXXLZ"],
		"Content-Type": ["application/json"],
		"merchantNo": ["10000232365"],
		"requireTime": ["2023-02-01 09:54:46"]
	},
	"body": {
		"totalAmount": "1.00",
		"payDetailList": [{
			"payAccountType": 1,
			"detailOrderNo": "TS00000011",
			"amount": "1.00",
			"phone": "13188711522",
			"idCard": "111429196605291811",
			"accountNo": "62234258676607631",
			"userName": "吴2阳1",
			"merchantRemark": "给他钱"
		}],
		"bankType": 1,
		"payMethod": 1,
		"taskNo": "TK20221217001",
		"totalCount": 1,
		"remarks": "测试第一笔",
		"bizOrderNo": "2022122815090728198"
	}
}
上述请求参数生成的签名原文如下:
Bwls4lu8EP9znjvvsPpklNK8ofLshIvB2xtoVQ12022122815090728198[{"payAccountType":1,"detailOrderNo":"TS00000011","amount":"1.00","phone":"13188711522","idCard":"111429196605291811","accountNo":"62234258676607631","userName":"吴2阳1","merchantRemark":"给他钱"}]1测试第一笔TK202212170011.001
3.
打款明细整体json_encode 后再拼接字符串,json_encode 要加 JSON_UNESCAPED_UNICODE,不能用unicode码。
4.
签名生成时,若键值对的值为空时,该参数就不需要传,否则签名无法通过校验。举例如下
[
    {
        "payAccountType": 1,
        "detailOrderNo": "TS00000011",
        "amount": "1.00",
        "phone": "13188711522",
        "idCard": "111429196605291811",
        "accountNo": "62234258676607631",
        "userName": "吴2阳1",
        "merchantRemark": ""
    }
]
merchantRemark 字段的值为空,就不能在签名时加入,应去掉该参数,如下所示:
[
    {
        "payAccountType": 1,
        "detailOrderNo": "TS00000011",
        "amount": "1.00",
        "phone": "13188711522",
        "idCard": "111429196605291811",
        "accountNo": "62234258676607631",
        "userName": "吴2阳1",
    }
]
上一页
常见问题
下一页
RSA签名规则
Built with