Paypal REST API 计费协议 Webhooks

Question

我正在将Paypal Rest API与我的Django网站集成，以便引入基于订阅的计费，目前一切都进行得很顺利。

我已经有了账单计划、账单协议、交易历史记录的接口，并且可以创建和激活账单协议等等。

但是，如果账单协议被取消或者支付了账单协议，我需要一种通知的方式。因此，我认为Webhooks可能是解决这个问题的方法，但我不确定Webhooks是否适用于账单协议？

有人能否建议一种跟踪付款的方法，比如为账单协议支付的方法？

- Sam Buckingham

Answer 1

我可以确认，当执行定期付款时，您将通过webhook事件PAYMENT.SALE.COMPLETED（如此处所述）收到通知： https://github.com/paypal/PayPal-Python-SDK/issues/132#issuecomment-261374087 webhook事件的JSON结构:

{
    ...
    "resource": {
        ...
        "billing_agreement_id": "I-38097XVV6XVU"
        ...
    }
    ...
}

这里可以找到所有事件名称的列表： https://developer.paypal.com/docs/integration/direct/webhooks/event-names/

- Ned

---

沙盒环境可能会导致它们不能像预期的那样工作吗？我收到了来自不同计划的约20个通知，但只有2个PAYMENT.SALE.COMPLETED Webhook被实际触发！ - Jurgen Cuschieri

花了一段时间才搞定Webhook，但它起作用了，并且是从沙盒发送的。我记得当时是在2017年初开始研究这个问题的。关于你的另一个问题，我不确定是否可以混合使用API：使用旧的Web Forms API创建重复付款并注册REST API中的Webhook。在我的测试环境中，我发现使用旧的Web Forms API接收订阅ID以"S-XXXXXX"开头，而来自REST API的订阅ID则以"I-XXXXXX"开头，如上面的示例所示。我认为可以只使用IPN模拟器在沙盒中发送测试IPN。 - Ned

Jurgen，我刚刚测试了REST API，并在创建订阅并收到BILLING.SUBSCRIPTION.CREATED事件11小时后收到了PAYMENT.SALE.COMPLETED事件。我是在沙盒环境下进行测试的。不幸的是，我无法提供任何生产时间。 - Ned

谢谢。我被告知在生产模式下它可以正常工作。不确定是否应该冒险尝试。11个小时似乎还好，但可能会有变化，这就是问题的起源。 - Jurgen Cuschieri

Answer 2

这可能不包括在Paypal的Webhooks通知范围内。您可以在沙箱中尝试并查看是否收到Webhooks通知。或者您可以使用IPN，应该能够获取IPN通知。

- Alex

---

好的，我测试了所有的Webhooks，但是没有任何反馈，所以看起来它们对订阅无效，这很烦人，因为我已经在REST API上做了所有这些工作，现在只能使用IPN，直到REST API准备就绪:/ - Sam Buckingham

我们何时能够看到REST API Webhooks的这些更改呢？因为这是我等待的全部，以便将REST API集成到我的网站计费系统中。目前，我只能暂时集成IPN系统。 - Sam Buckingham

@PayPalAlex，你的意思是说官方推荐的API不支持任何支付处理器中最基本的订阅功能...而且文档中没有明显的警告？这又是让我所遇到的每个开发者都讨厌PayPal的原因清单中的又一项。 - Mike Marcacci

有关Python-SDK的GitHub问题：https://github.com/paypal/PayPal-Python-SDK/issues/69 - Jason Russell

18个月过去了，仍然没有支持webhooks中的账单协议。看起来我们只能使用IPN，参见https://github.com/paypal/PayPal-Python-SDK/issues/69#issuecomment-69647946 Jason在github问题上发布的评论。 - Dave Anderson

Answer 3

目前看来，Webhooks 不是实现 PayPal 定期付款的正确方式。以下是最近的 Github 线程，您可以在其中了解工作流程可能如何： https://github.com/paypal/PayPal-REST-API-issues/issues/105

这是由 PayPal 开发人员之一回答的。也许在 Webhooks 开发完成之前，我们必须使用 IPN。

- José Manuel Blasco

---

但是如何在REST API中设置IPN端点的notify_url呢？对于普通的经典付款，您将其作为请求的一部分发送！ - Jurgen Cuschieri

你好！你需要在你的Paypal开发者面板（developer.paypal.com）中进行配置。 - José Manuel Blasco

你确定他们没有删除它吗？我认为他们可能已经更新了门户网站，因为我找不到它。我曾看到其他来源提到过它，但我找不到任何类似的东西！ - Jurgen Cuschieri

哦，我没有仔细阅读。很抱歉，我目前正在使用Webhooks，不知道如何将其与IPN配合使用。 - José Manuel Blasco

让我们在聊天中继续这个讨论。 - Jurgen Cuschieri