RevGlanceBraintree
使用 API 密钥对连接 Braintree，读取交易和定期计费数据。
RevGlance 读取 Braintree 的网关 API，即 Braintree 服务端 SDK 所使用的 API，因为定期计费数据只存在于那里。
连接
- 在 Braintree Control Panel 中，打开 Settings › API，生成一个新的 API 密钥对。
- 复制 Merchant ID、Public key 和 Private key。它们所属的 API 用户需要具有可读取交易和订阅的角色。
- 填写这些值，在 环境 下输入
production（沙盒账户则输入sandbox），然后选择 连接 Braintree。
表单需要填写的内容
| 字段 | 格式示例 |
|---|---|
| 商家 ID | abc123def456ghi7 |
| 公钥 | 7xh9k3b2m4n5p6q8 |
| 私钥加密存储 | 0123456789abcdef0123456789abcdef |
| 环境 | production 或 sandbox |
添加 webhook
Braintree 使用数据源已持有的同一组 API 密钥为 webhook 签名，因此无需粘贴密钥。
- 在 RevGlance 中，打开 设置 › 来源，打开 Braintree 数据源的菜单并选择 Webhook。复制 URL。
- 在 Braintree Control Panel 中，打开 Settings › Webhooks，使用该 URL 创建一个 webhook，并选择订阅和交易通知。
RevGlance 同步哪些数据
- 交易：已结算和结算中的销售计为付款；退还款项计为退款。从未请款的授权不计入。
- 订阅 及其方案、附加项和折扣，用于计算 MRR、试用和取消。
首次同步会读取 Braintree 保留的所有交易。Braintree 的 API 不提供处理手续费，也不提供取消原因。
Braintree 的计算方式
- 已结算和结算中的销售计入；如果您发送了税额，则按税前计入。从未请款的授权不计入。
- 退款为贷记交易，按 Braintree 处理的日期计。
- Braintree 不通过其 API 报告处理费，因此手续费显示为零。
- MRR 为订阅价格加上附加项，减去仍有剩余计费周期的折扣。订阅不关联客户，因此使用其扣款对应的客户；尚无扣款的订阅显示在其银行卡下。
- 取消日期取自状态历史。已过期的订阅在其付费截止日期结束。
- 未能收取的付款计为失败的扣款。不涉及资金变动。
- 不读取拒付，因此输掉的拒付仍计为扣款，除非服务商也将其报告为退款。