综合

支付 Webhook:它是什么,以及如何自动确认订单

了解支付 Webhook 是什么、如何运作,以及如何在您的系统或 ERP 中自动确认在巴西通过 Pix、银行卡和 boleto 支付的订单。

作者 Equipe Sila Pay阅读约 1 分钟
在联合办公空间里面带微笑的女开发者,侧面视角,正在使用笔记本电脑工作

客户付款后,需要有人通知您的系统:把订单标记为已付款、备货、开具发票并发送确认信息。起步阶段靠人工核对账单还行,但销量一增长,整个运营就会被拖慢。支付 Webhook 正是为此而生。

什么是支付 Webhook

它是一种自动通知:每当一笔收款发生变化,例如 Pix 已支付、boleto 已结清、银行卡交易被批准或退款,支付平台就会向您系统的某个地址(URL)发送通知。您的系统无需每隔一段时间去询问客户是否已付款,状态一变化就能收到消息。

使用步骤

  1. 提供 URL:即您系统中接收通知的地址,可在后台设置,也可以在通过 API 创建收款时填写 postbackUrl 字段。
  2. 客户付款:通过 Pix、信用卡或 boleto。
  3. 平台发送通知:一个 HTTP POST 请求,事件数据为 JSON 格式。
  4. 您的系统确认订单:核验通知、更新状态,并返回 HTTP 200 表示已收到。

Webhook 包含哪些内容

每条通知都包含唯一的事件 ID、付款状态和交易数据。简化示例:{"id": "evt_...", "status": "LIQUIDATED", "data": {"value": "16.5", "txId": "...", "method": "pix"}}。

在 Sila Pay,您还可以在后台选择要接收的事件,例如购买已批准(purchase_approved)、Pix 已支付(pix_paid)、boleto 已支付(boleto_paid)、Pix 已过期以及购买已退款。

Webhook 在日常运营中的用处

  • 自动处理订单:订单在您的系统或 ERP 中自动变为"已付款",无需人工核对账单。
  • 库存与发货:付款一确认就开始备货。
  • 数字产品与服务:付款后立即开通访问权限、发放门票或确认预约。
  • 过期收款:及时得知 Pix 或 boleto 未付款即已过期,并跟进客户。

想要自动确认订单吗?注册 Sila Pay 账户

接收 Webhook 的最佳实践

  • 验证签名:Sila Pay 的每条通知都带有 X-Silapay-Signature 请求头,这是用您的 secret 计算的 HMAC-SHA256。处理前请先验证。
  • 快速响应:在 5 秒内返回 HTTP 200,开具发票等耗时任务稍后再做。
  • 处理重复通知:如果您的系统没有响应,平台会重新发送;请使用事件 id,避免同一通知被处理两次。
  • 使用 HTTPS 并保护 secret:将其保存在服务器上,切勿放在网站或 App 中。

常见问题

使用 Webhook 需要会编程吗?

需要有人搭建接收通知的地址。很多 ERP 和电商平台已经内置了这项功能;如果您使用 WooCommerce 或 Shopify,Sila Pay 提供插件来连接您的店铺。

Webhook 和 API 有什么区别?

使用 API 时,是您的系统调用平台,例如创建一笔收款;使用 Webhook 时,是平台调用您的系统,通知某些状态发生了变化。两者通常配合使用。

如果我的系统宕机了怎么办?

如果没有收到 HTTP 200 响应,Sila Pay 会自动重试。不过,针对较长时间的故障,仍建议保留定期对账的流程。

在哪里可以找到文档?

请访问 doc.silapay.pro,其中包含事件列表、payload 格式以及签名验证示例。

自动确认订单,无需再核对账单。注册 Sila Pay

#pagamentos#vendas online
分享WhatsAppLinkedInX

准备好付诸实践了吗?

几分钟内创建 Sila Pay 账户,开始通过 Pix、银行卡和支付链接收款。

  • ✓ 免费注册
  • ✓ 无月费
  • ✓ D+1 到账
免费创建账户 →

订阅最新文章

关于支付和在线销售的实用内容,直接发送到您的邮箱。

没有垃圾邮件,可随时退订。

延伸阅读

Sila Pay

销售所需的一切, 尽在一处。

立即开始 →