> For the complete documentation index, see [llms.txt](https://docs.musepay.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.musepay.io/cn/ji-cheng/webhook.md).

# Webhook

### 配置

配置 Webhook URL 后，您可以接收入金、出金及其他交易状态变化通知：

<figure><img src="https://3284514181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNWFeaFjBSxNdDRnZTvM%2Fuploads%2Fgit-blob-b99e1cf1e19995cbcadde727db0fbab792270174%2Fimage%20(3).png?alt=media" alt=""><figcaption></figcaption></figure>

配置完成后，MusePay 会向该 URL 发送事件通知。对于使用 RSA 签名的订单通知，签名基于原始 HTTP 请求体生成：

* **sign** = `Base64(SHA1WithRSA(MusePay 私钥, 原始请求体))`

请使用下方展示的 MusePay 公钥和未经修改的原始请求体验证签名。验证 Webhook 时不要使用您的合作伙伴公钥。

**上述规则不适用于所有通知类型。独立商户 KYC 的 `KYC_RESULT` 不带 RSA 签名，请按** [**KYC 回调说明**](/cn/ji-cheng/webhook/kyc.md)**处理。其他通知继续遵循对应产品的既有签名规则。**

<figure><img src="https://3284514181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXNWFeaFjBSxNdDRnZTvM%2Fuploads%2Fgit-blob-f329b7386de5007312bcbd6393c4cebd0928db7c%2Fimage%20(11).png?alt=media" alt=""><figcaption></figcaption></figure>

### 数据对象

{% content-ref url="/pages/vjM25awqcedpNycA0t8B" %}
[Acquiring（收单）](/cn/ji-cheng/webhook/order.md)
{% endcontent-ref %}

{% content-ref url="/pages/WUI6zehhiS0oSVOHhDm1" %}
[卡片](/cn/ji-cheng/webhook/card.md)
{% endcontent-ref %}

{% content-ref url="/pages/IGcMCvzqUWuIeKunIy9S" %}
[Fiat Payout（法币出款）](/cn/ji-cheng/webhook/fiat-payout.md)
{% endcontent-ref %}

{% content-ref url="/pages/wTZ2pwR1ggvw5z2qOMhh" %}
[KYC](/cn/ji-cheng/webhook/kyc.md)
{% endcontent-ref %}

### 重试机制

MusePay 会向配置的 URL 发送 POST 请求，并期待收到 HTTP 200 响应。如果未收到成功响应，MusePay 会在 0、2、4、8、16、32 和 64 分钟后重试。