注册回调通知【webhook】
简要描述
注册完成后,会以 JSON 的形式将相关 KYC 结果和用户信息发送给商户。商户需要接收并处理这些通知,并按照文档规范返回应答。相同的通知可能会多次发送给商户,商户必须能够正确处理重复的通知。通知的频率为:在 10 分钟内订单每 10 秒请求一次,1 小时内订单每 5 分钟请求一次,48 小时内订单每小时请求一次。
回调参数
参数名 | 验签 | 必选 | 类型 | 长度 | 说明 |
---|---|---|---|---|---|
userNo | 是 | 是 | string | 32 | 用户编号 |
是 | 是 | string | 128 | 邮箱 | |
kycLevel | 是 | 是 | int | 3 | kyc等级 |
kycType | 是 | 是 | string | 32 | kyc类型 |
kycStatus | 是 | 是 | int | 3 | kyc状态(1:成功 2:永久拒绝 3:临时拒绝) |
firstName | 是 | 是 | string | 16 | firstName |
lastName | 是 | 是 | string | 32 | lastName |
country | 是 | 否 | string | 256 | 国家 |
idDocType | 是 | 是 | string | 256 | 证件类型 |
dob | 否 | 是 | string | 512 | 出生日期 |
validUntil | 是 | 是 | String | 10 | 有效期 |
number | 否 | 否 | string | 256 | 号码 |
gender | 是 | 是 | string | 512 | 性别 |
additionalNumber | 是 | 是 | string | 512 | 附加号码 |
callbackUrl | 是 | 是 | string | 512 | 回调url |
redirectUrl | 是 | 是 | string | 512 | 通知url |
documentPhoto | 是 | 是 | string | 512 | 正面照片 |
documentBackPhoto | 是 | 是 | string | 512 | 反面照片 |
facePhoto | 是 | 是 | string | 512 | 脸部照片 |
kycFailJson | 是 | 是 | string | 512 | 失败json |
street | 是 | 是 | string | 512 | 街道 |
city | 是 | 是 | string | 512 | 城市 |
state | 是 | 是 | string | 512 | 州 |
zipCode | 是 | 是 | string | 512 | 邮编 |
address | 是 | 是 | string | 512 | 地址 |
userNum | 是 | 是 | string | 512 | 用户中心用户编号 |
merchantNo | 是 | 是 | string | 512 | 商户号 |
subMerchantNo | 是 | 是 | string | 512 | 子商户号 |
remark | 是 | 是 | string | 512 | 备注 |
示例
{
"amlReport":"https://sumsub-kyc.oss-cn-hongkong.aliyuncs.com/6cf2-b773-8ce7128ee11e.pdf",
"callbackUrl":"https://api-test.alchemytech.cc/webhooks/kyc/notify",
"country":"CHN",
"dob":"1988-02-10",
"documentBackPhoto":"https://sumsub-kyc.oss-cn-hongkong.aliyuncs.com/onfido-kyc/109fb33e/back.png",
"documentPhoto":"https://sumsub-kyc.oss-cn-hongkong.aliyuncs.com/onfido-kyc/109fbc3e/front.png",
"email":"[email protected]",
"facePhoto":"https://sumsub-kyc.oss-cn-hongkong.aliyuncs.com/onfido-kyc/109fb3dc3e/face.png",
"firstName":"Test",
"gender":"2",
"idDocType":"1",
"idvReport":"https://sumsub-kyc.oss-cn-hongkong.aliyuncs.com/6cf2e.pdf",
"kycFailJson":"[]",
"kycLevel":1,
"kycPlatform":"onfido",
"kycStatus":1,
"kycType":"1",
"lastName":"last name",
"merchantNo":"TEST000001",
"number":"232301198802103743",
"subMerchantNo":"MER10123012",
"userNo":"3db9dbe7ecd542b98f1728e4617db96f",
"userNum":"101016958103533043054",
"validUntil":"2037-02-10",
"remark":"123"
}
商户响应
商户处理后http的code=200,不再回调;code!=200,会定期发送数据。
Updated about 2 months ago