主题
openId获取
接口描述
- 接入方可以通过该接口获取 甬易支付的用户openId(该openId在同个appId下唯一)/银联的用户标识。
请求URL
/auth/getUser
请求方式
- POST
公共请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| appId | 是 | string | appId | 202409561403450909 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| authCode | 是 | string | 32 | 授权码 一、甬易支付示例：20a18b7d7bec4c409ea4dc2c0cd84ac1 二、云闪付获取authCode方式: 1.调用云闪付获取授权码 https://qr.95516.com/qrcGtwWeb/api/userAuth?version=1.0.0&redirectUrl=回调接收userAuthCode地址(需URLEncode)2.接收code回调 收到参数:respCode (00为成功)、userAuthCode | 20a18b7d7bec4c409ea4dc2c0cd84ac1 |
| payBrand | 是 | string | 支付品牌： YOYIPAY-甬易支付，UNIONPAY-银联二维码 默认值YOYIPAY | YOYIPAY |
请求报文示例
json
{
"appId": "202408554212370909",
"authCode": "20a18b7d7bec4c409ea4dc2c0cd84ac1",
"signature": "zsZjLynizxCOEjh2kXu4MPTMnp8KAG1IguSMe9bpdGwsRFpTf+mlomwMNQd1b63s2M9RcDW/eGhMcsFaNGxK/xV4mCONVFm709FGbxoO3vzFl3IpTCVPXJITPvLcLgNz1c8KP/oNCTWIfd49CkYp4goqGGGsHy3t/wzi8pDhFF0T9UWA8QCf8lyKw4lT3mIAnsuzzCjmWi7rdmDYk3MjvMMQdAnM2+bIjI2bXkk4H1N448LkzhVuc0HyjLMEcr9xysj3GPkQSMxtAmFgyr3b62KKPPtvkN5Nv1Q7e8kk0/fbJ6ftofzbFRpxZoLptInoyn5UwIzCi01GHst/GgZfgQ==",
"transDate": "1731488496198",
"transNonce": "8fc3f15267264896a9fd59da136636c3"
}公共响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| openId | 是 | string | 32 | openId | yoyipay1jed6scb65c01 |
响应示例
json
{
"code": "00000000",
"message": "成功",
"openId": "yoyipay1jed6scb65c01",
"signature": "zsZjLynizxCOEjh2kXu4MPTMnp8KAG1IguSMe9bpdGwsRFpTf+mlomwMNQd1b63s2M9RcDW/eGhMcsFaNGxK/xV4mCONVFm709FGbxoO3vzFl3IpTCVPXJITPvLcLgNz1c8KP/oNCTWIfd49CkYp4goqGGGsHy3t/wzi8pDhFF0T9UWA8QCf8lyKw4lT3mIAnsuzzCjmWi7rdmDYk3MjvMMQdAnM2+bIjI2bXkk4H1N448LkzhVuc0HyjLMEcr9xysj3GPkQSMxtAmFgyr3b62KKPPtvkN5Nv1Q7e8kk0/fbJ6ftofzbFRpxZoLptInoyn5UwIzCi01GHst/GgZfgQ==",
"transDate": "1731488496198",
"transNonce": "8fc3f15267264896a9fd59da136636c3"
}备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述