4.18 获取授权H5链接
请求URL:
测试环境: https://mkt-test.allinpay.com/mngapi/mng/authurl
生产环境: https://mkt.allinpay.com/mngapi/mng/authurl
请求path: /mngapi/mng/authurl
接口说明：获取活动的可用商户授权H5链接
请求入参:
|
参数 |
参数名 |
类型[长度] |
必填 |
描述 |
|
appid |
应用id |
String[10] |
是 |
基础营销平台分配,与报文头一致 |
|
buttid |
对接方id |
String[10] |
是 |
基础营销平台分配 |
|
opeid |
活动发起方id |
String[10] |
是 |
由基础营销平台导入，buttid opeid不能同时为空 |
|
actid |
活动id |
String[10] |
是 |
|
|
cusid |
授权人id |
String[15] |
否 |
活动的可用商户、出资方 |
|
notify_url |
结果回调链接 |
String[256]
|
否 |
授权结束会跳转该链接，并通过get方式带入结果信息，详见4.18.1 |
返回参数:
|
参数 |
参数名 |
类型[长度] |
必填 |
描述 |
|
ret_code |
接口状态码 |
String(4) |
是 |
200-处理成功 详见附录 |
|
ret_msg |
接口错误信息 |
String |
是 |
|
|
result_code |
错误码 |
String(32) |
否 |
SUCCESS-调用成功 详见附录 |
|
result_msg |
错误信息 |
String |
否 |
|
|
url |
授权H5链接 |
String |
否 |
|
4.18.1 授权回调
已送notifyurl的请求，在授权结束时会跳转至该链接，并将结果信息签名后通过get方式返回，签名方式如下：
- 签名字符串为除了sign之外，所有参与签名的字段，按字段名的ASCLL码从小到大排序后，使用URL的键值对的格式(即key1=value1&key2=value2)拼接成字符串string
- 通过请求设置的signtype，进行签名，验签公钥见2.3.3.3
回调参数:
|
参数 |
参数名 |
类型[长度] |
必填 |
描述 |
|
appid |
应用id |
String[10] |
是 |
基础营销平台分配,与报文头一致 |
|
actid |
活动id |
String[10] |
是 |
|
|
cusid |
授权人id |
String[15] |
否 |
活动的可用商户、出资方 |
|
status |
授权状态 |
String[15] |
是 |
AUTHSUCC：授权成功 AUTHFAIL：授权失败 通过该字段判断授权结果 |
|
signtype |
签约类型 |
String[10] |
是 |
SM2、RSA256 |
|
sign |
签名 |
String |
是 |
|
|
timestamp |
请求时间戳 |
String |
是 |
|
|
nonce |
随机字符串 |
String[12] |
是 |
|