主题
免密支付签约申请
接口描述
该功能用于同步申请商户平台用户的免密支付签约,需要同步返回结果
请求URL
- 商户事先提供的 url,需要配置
请求方式
- POST
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码：00000000-成功，非00000000-失败，具体原因取message | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 43e2c287-24b1-4cd1-b3d2-e40e7840cc40 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
| notifyType | 是 | string | 32 | 通知类型 | free_pwd_pay_sign_notify |
| authNo | 是 | string | 64 | 授权号 | AUTH202605080001 |
| merchantTag | 否 | string | 64 | 商户侧标识 | MERCHANT_TAG_001 |
| idCardNo | 否 | string | 18 | 身份证号码 | 110101199001011234 |
| authStatus | 是 | string | 32 | 授权状态：ACTIVE 已授权 / INACTIVE 未授权 / FROZEN 冻结 | ACTIVE |
请求报文示例
json
{
"code": "00000000",
"message": "成功",
"signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g==",
"transDate": "1746662400000",
"transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
"authNo": "AUTH202605080001",
"merchantTag": "MERCHANT_TAG_001",
"idCardNo": "110101199001011234",
"authStatus": "ACTIVE"
}响应参数
商户平台接收到回调后，需返回字符串 SUCCESS，甬易平台收到该返回便认为接入方已收到通知。
响应示例
注意事项
- 甬易平台可能同一个授权号进行多次申请(关闭再申请)，商户平台需要做好幂等处理
- 商户平台接收到回调后，需要对通知内容做签名验证，防止数据被篡改
- 商户平台接收到回调后，需要返回SUCCESS，否则甬易平台将继续发送通知，以递增时间间隔重复发送5次，时间间隔分别为：24s、1m、1m、6m、12m
备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述