RevGlanceドキュメント

Paddle

トランザクション、調整、サブスクリプション、顧客を読み取れる API キーで Paddle Billing を接続します。

接続

  1. Paddle で Developer tools › Authentication を開き、API キーを作成します。対応しているのは Paddle Billing のみで、Paddle Classic には対応していません。
  2. transactions、adjustments、subscriptions、customers の読み取りを許可します。回収メールを送信する場合は transaction.write も追加します。
  3. キーをコピーします。本番用キーは pdl_live_apikey_ で始まります。サンドボックス用キーも使え、Paddle のサンドボックスから同期します。
  4. APIキーに貼り付け、Paddleを接続を選びます。

フォームで入力する項目

項目形式の例
APIキー暗号化して保存pdl_live_apikey_…

Webhook を追加する

  1. RevGlance で 設定 › ソース を開き、Paddle ソースのメニューを開いて Webhook を選びます。URL をコピーします。
  2. Paddle で Developer tools › Notifications を開き、その URL で送信先を追加します。トランザクション、調整、サブスクリプションのイベントを選択します。
  3. 送信先の secret key をコピーし、RevGlance の署名シークレットに貼り付けて保存します。

RevGlance が同期するもの

  • 支払い済みまたは完了済みのトランザクション。顧客と住所を含みます。
  • 調整:承認された返金とチャージバックは返金になり、取り消された場合は再び差し引かれなくなります。
  • サブスクリプション。MRR、プラン、トライアル、解約に使い、継続割引は MRR から差し引きます。
  • 顧客(有効なものとアーカイブ済みのもの)。

Paddle は解約理由を保持しないため、解約は理由なしで届きます。

Paddle の集計方法

  • 金額はPaddleの支払い合計(税抜き)から取得し、Paddleの手数料を手数料とします。
  • 返金とチャージバックは税抜きで計上します。Paddleが勝訴したチャージバックや、Paddleが取り消した返金は計上されなくなります。
  • Paddleが差し引くチャージバック手数料は手数料として計上します。
  • 税込み価格は、次回の請求書の税の割合で、税引き前でMRRに計上します。
  • 定期割引はMRRから差し引かれます。後で割引がアーカイブされた場合も同様です。
  • 回収できなかった支払いは失敗した請求として計上します。資金の移動はありません。

回収メール

回収は、失敗した各支払いを Paddle の支払い方法更新チェックアウトにリンクします。これにはキーに transaction.write が必要です。ない場合、メールはあなた自身のカード更新ページにリンクします。