4 回调
接口地址:/hypercard/callback
(由商户自定义,在商户后台配置此地址)
请求方式:POST
请求数据类型:application/json
响应数据类型:application/json
接口描述:
在需要HyperCard调用商户的接口时,就需要商户按照此规范定义接口信息。
此接口是一个通用的回调接口,根据不同的业务约定不同的
notify_type
字段的值为了让商户在收到此回调时能够确定回调是从HyperCard发出的,需要商户对此接口做签名校验
签名校验与HyperCard的算法和header信息保持一致
其中HyperCard的公钥可以在商户后台获取
通用请求示例:
{
"notify_type": "TRANSFER_VERIFY",
"data": {}
}
通用请求参数:
参数名称 | 数据类型 | 是否必须 | 参数说明 |
---|---|---|---|
notify_type | string | true | 业务类型, 每种回调都需要定义单独的业务类型,如TRANSFER_VERIFY 为划转校验 |
data | object | true | 业务数据,不同的业务类型此字段的值也不一样,需要根据每个业务类型单独约定里面的字段 |
通用响应参数:
参数名称 | 类型 | 参数说明 |
---|---|---|
code | string | 错误码; 1成功,其他失败 |
msg | string | 错误信息 |
data | object | 响应数据 |
通用响应示例:
{
"code": 1,
"msg": "ok",
"data": {}
}