回调接口概览

SpeedPay 会通过 Webhook 将异步业务结果推送到商户在 API KEY 中配置的 HTTPS 回调地址。回调地址由商户提供，不是固定的平台接口路径。

通用请求

项目	说明
方法	`POST`
地址	商户在 SpeedPay 商户平台 API KEY 中配置的 HTTPS 回调地址
内容类型	`application/json`
超时时间	5 秒
签名 Header	`Authorization`

Authorization 的值为 SpeedPay 使用平台私钥对完整 JSON 请求体签名后的结果。商户需要使用 SpeedPay 公钥验签，验签失败时不得处理业务数据。

商户处理成功后返回以下 JSON：

{
  "code": 0,
  "msg": "success"
}

code 必须为数字 0。非 0、网络错误或超时会被记录为回调失败。

`api_name`	说明	详情
`pr_card_activation_result_push`	Visa 开卡/申请结果	Visa 回调
`transaction_advice`	Visa 交易通知	Visa 回调
`change_advice`	Visa 卡状态变更	Visa 回调
`express_advice`	Visa 物流信息变更	Visa 回调
`mobile_advice`	Visa 手机号变更	Visa 回调
`apply_edit_advice`	Visa 申请资料变更	Visa 回调

要求	说明
先验签后入库	使用 SpeedPay 公钥对完整 JSON 请求体进行验签
幂等处理	根据 `api_name`、业务流水号、交易 ID、卡号等字段去重
快速响应	建议验签后先落库或入队列，再异步处理重业务逻辑
保留原文	建议保存原始请求体、签名、处理结果和错误信息，便于排查