RevGlanceドキュメント

Braintree

API キーペアで Braintree を接続し、トランザクションと継続課金を読み込みます。

RevGlance は Braintree のゲートウェイ API を読み込みます。Braintree のサーバー SDK が使う API で、継続課金のデータはそこにしかないためです。

接続

  1. Braintree Control Panel で Settings › API を開き、新しい API キーペアを生成します。
  2. Merchant ID、Public key、Private key をコピーします。これらが属する API ユーザーには、トランザクションとサブスクリプションを読み取れるロールが必要です。
  3. それらを入力し、環境に production(サンドボックスアカウントの場合は sandbox)と入力して、Braintreeを接続を選びます。

フォームで入力する項目

項目形式の例
マーチャントIDabc123def456ghi7
公開鍵7xh9k3b2m4n5p6q8
秘密鍵暗号化して保存0123456789abcdef0123456789abcdef
環境productionまたはsandbox

Webhook を追加する

Braintree はソースがすでに持っている API キーで Webhook に署名するため、貼り付けるシークレットはありません。

  1. RevGlance で 設定 › ソース を開き、Braintree ソースのメニューを開いて Webhook を選びます。URL をコピーします。
  2. Braintree Control Panel で Settings › Webhooks を開き、その URL で Webhook を作成して、サブスクリプションとトランザクションの通知を選択します。

RevGlance が同期するもの

  • トランザクション:決済済みおよび決済処理中の売上は支払いに、クレジットは返金になります。キャプチャされなかったオーソリは含めません。
  • サブスクリプションとそのプラン、アドオン、割引。MRR、トライアル、解約に使います。

最初の同期では、Braintree が保持するすべてのトランザクションを読み込みます。Braintree は API で処理手数料も解約理由も報告しません。

Braintree の集計方法

  • 決済済みおよび決済処理中の売上を計上します(税額を送信している場合は税抜き)。キャプチャされなかったオーソリは計上しません。
  • 返金はクレジット取引で、Braintreeが処理した日付になります。
  • BraintreeはAPIで処理手数料を報告しないため、手数料は0と表示されます。
  • MRRはアドオンを含むサブスクリプション価格から、請求サイクルが残っている割引を差し引いた額です。サブスクリプションには顧客名がないため、請求の顧客を使用します。まだ請求がないものはカードの下に表示されます。
  • 解約日はステータス履歴から取得します。期限切れのサブスクリプションは支払い済み期間の終了日に終了します。
  • 回収できなかった支払いは失敗した請求として計上します。資金の移動はありません。
  • チャージバックは読み込まないため、敗訴したものは、プロバイダーが返金としても報告しない限り請求として計上されたままになります。