获取渠道用户ID
获取渠道用户ID
商户通过该接口获取渠道的用户ID,如微信的openID,支付宝的userId。该接口通过跳转获取到用户ID后,会跳转到商户上传的redirectUrl地址,并传递用户ID参数
接口说明
适用对象:普通商户 特约商户
请求URL:https://pay.yintongzaixian.com/api/channelUserId/jump
请求方式:GET
请求类型:application/json 或 application/x-www-form-urlencoded
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户号 | mchNo | 是 | String(30) | M1621873433953 | 商户号 |
| 应用ID | appId | 是 | String(24) | 60cc09bce4b0f1c0b83761c9 | 应用ID |
| 支付接口 | ifCode | 是 | String(30) | AUTO | 目前只支持传 AUTO |
| 跳转地址 | redirectUrl | 是 | String | https://www.yintongzaixian.cn | 获取到用户ID后,会携带用户ID参数跳转到该地址 |
| 请求时间 | reqTime | 是 | long | 1622016572190 | 请求接口时间,13位时间戳 |
| 接口版本 | version | 是 | String(3) | 1.0 | 接口版本号,固定:1.0 |
| 签名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 签名值,详见签名算法 |
| 签名类型 | signType | 是 | String(32) | MD5 | 签名类型,目前只支持MD5方式 |
@RequestMapping("/mchJeepayPayOrderNotify")
public void mchJeepayPayOrderNotify(HttpServletRequest request, HttpServletResponse response) throws IOException {
// 获取到请求参数
PayOrderNotifyResModel payOrderNotifyResModel = JeepayNotifyKit.convertNotifyResModel(request);
// 获取到jeepay回调参数中的: mchNo 和 appId
String mchNo = payOrderNotifyResModel.getMchNo();
String appId = payOrderNotifyResModel.getAppId();
String mchOrderNo = payOrderNotifyResModel.getMchOrderNo(); // 商户订单编号
String mchAppSecret = ""; // TODO 根据[mchNo,appId]自行查询配置的秘钥
// 验签失败
if(!payOrderNotifyResModel.checkSign(mchAppSecret)){
response.getWriter().print("sign fail");
return;
}
// 以下为验签成功
// TODO 商户业务逻辑处理。。。。。。。。。。。
// 响应jeepay SUCCESS字样
response.getWriter().print("SUCCESS");
}
请求示例数据JSON
{
"mchNo": "M1621873433953",
"appId": "60cc09bce4b0f1c0b83761c9",
"ifCode": "wxpay",
"redirectUrl": "https://www.yintongzaixianpay.cn",
"sign": "A5C93D50743126ED91AA6ED96CDEEEF8",
"signType": "MD5",
"reqTime": "1622011236571",
"version": "1.0"
}
当获取到渠道用户ID后,会301重定向到跳转地址,传递参数如下
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 渠道用户ID | channelUserId | 是 | String | o6BcIwvSiRpfS8e_UyfQNrYuk2LI | 渠道用户ID,微信openId或支付宝userId |
完整跳转URL示例HTML
https://www.yintongzaixianpay.cn/toU?channelUserId=o6BcIwvSiRpfS8e_UyfQNrYuk2LI
返回码
| code | 描述 |
|---|---|
| 0 | 成功 |
| 9999 | 异常,具体错误详见msg字段 |