免密支付签约状态变更通知

接口描述

该功能用于异步通知商户平台用户的免密支付授权状态变更结果。当用户授权状态发生变化时，甬易侧会触发回调商户提供的URL，将最新的签约状态同步给商户平台。

请求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_status_notify
authNo	是	string	64	授权号	AUTH202605080001
authStatus	是	string	32	授权状态：ACTIVE 已授权 / INACTIVE 未授权 / FROZEN 冻结	ACTIVE

请求报文示例

{
"code": "00000000",
"message": "成功",
"signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g==",
"transDate": "1746662400000",
"transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
"authNo": "AUTH202605080001",
"authStatus": "ACTIVE"
}

响应参数

商户平台接收到回调后，需返回字符串 SUCCESS，甬易平台收到该返回便认为接入方已收到通知。

响应示例

注意事项

• 甬易平台可能同一笔签约进行多次状态变更通知，商户平台需要做好幂等处理
• 商户平台接收到回调后，需要对通知内容做签名验证，防止数据被篡改
• 商户平台接收到回调后，需要返回SUCCESS，否则甬易平台将继续发送通知，以递增时间间隔重复发送5次，时间间隔分别为：24s、1m、1m、6m、12m
• 授权状态说明：ACTIVE表示用户已授权免密支付，INACTIVE表示用户未授权或已取消授权，FROZEN表示授权已被冻结

备注

• 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述