Paddle 账单：设置和支付事件

Paddle 处理的内容

Paddle 作为符合条件的交易的记录商。其税务和账单服务适用于您与 Paddle 的协议下的这些交易；连接网关并不意味着业务的每个部分在每个司法管辖区都合规。

设置前

完成 Paddle 要求的账户和产品审批。
使用当前的 Paddle 账单集成，而不是 Paddle Classic 的凭据或事件名称。
准备单独的沙盒和实时凭据。将 API 密钥和 webhook 秘密保存在服务器上。

连接网关

在管理后台打开支付网关设置，选择 Paddle。
输入当前表单请求的 API 和客户端凭据，以及 webhook 签名秘密。
选择沙盒环境进行测试。切勿将沙盒令牌与实时 API 密钥混合。
在 Paddle 中，为您安装的 Paddle webhook 端点创建通知目标。

此集成使用的端点是 https://your-store.example/api/payment/webhooks/paddle。在配置之前确认您安装版本的实际路径。

使用当前账单事件

Paddle 账单使用点分事件名称。支付完成通过 transaction.completed报告；订阅使用事件，如 subscription.created 和 subscription.updated。选择您的安装驱动程序处理的事件。不要使用旧的 Classic 列表，如 payment_succeeded。

上线前验证

完成沙盒结账，检查其订单和交易状态，并确认签名的 webhook 被接受。对于定期产品，测试创建、续订和取消。重复通知不得创建第二次履行或收费。

网关批准、支持的产品、货币、税务和支付条款来自 Paddle。查看他们的当前文档： Paddle 账单 webhook。

故障排除

对于身份验证失败，请检查环境和凭据。对于签名失败，请检查目标密钥和端点。对于待处理订单，在重试之前检查其支付和Webhook状态。请勿在支持票中发送密钥。