# 概述

**在订单相关事件发生后，AsiaBill系统会触发webhook，调用商户交易时给定的CallbackUrl，来通知商户相关系统；**

商户对接需注意以下几点：

* webhook是服务器到服务器之间的数据返回；如果商户服务器有白名单控制，请联系 AsiaBill技术支持提供，webhook服务器ip地址
* 通知地址是根据交易接口参数 callbackUrl 的值进行传输的
* webhook需商户通知接口返回报文success（不区分大小写）才算通知成功，其他返回均为失败，会继续通知
* webhook在未成功返回的情况下，总通知时长为17个小时，共十五次，推送间隔分别为：15s/15s/30s/3m/3m/30m/30m/1h/2h/2h/2h/2h/2h/2h
* 同样的webhook可能会多次发送给商户系统。商户系统必须能够正确处理重复的webhook通知；以避免出现商户系统状态覆盖问题。

### 事件类型

| 事件代码                    | 事件描述    |
| ----------------------- | ------- |
| transaction.success     | 交易成功事件  |
| transaction.fail        | 交易失败事件  |
| transaction.pending     | 交易待处理事件 |
| transaction.clear       | 交易清算事件  |
| pre-authorized.captured | 预授权捕获事件 |
| pre-authorized.void     | 预授权取消事件 |
| refund.success          | 退款成功事件  |
| refund.fail             | 退款失败事件  |
| chargeback.success      | 拒付成功事件  |

### 签名

签名方式请参考附录[webhook签名](https://asiabill.gitbook.io/api-explorer/fu-lu/shu-ju-qian-ming-guo-cheng#5-dui-jie-guo-shu-ju-qian-ming-jie-kou-xiang-ying-webhook-tong-zhi)