連携 · 決済サービス
Paddle の取引・更新・返金を、その訪問に紐づけます。
4 つの権限に限定した API キーで Paddle Billing を接続します。Tally は完了したすべての取引を読み取り、新規の売上と更新・アップグレードを区別して、チェックアウトのカスタムデータで渡された ID の訪問者にそれぞれ紐づけます。
無料で始める
14 日間無料、カード登録は不要です。
01Tally が読み取るもの
- Paddle で完了したすべての取引。Paddle.js のチェックアウト、API で作成した取引、サブスクリプションの各請求サイクルが対象です。
- 取引の発生元（origin）から、新規・更新・アップグレードを判定します。サブスクリプションへの単発の請求は拡張（expansion）として数え、トライアルからの移行は新規として数えます。
- 返金とチャージバックは、Paddle が承認した時点で調整（adjustment）から読み取ります。クレジットはお金が動かないため除外します。
- 金額は税抜きで、その日の参照レートで米ドル（セント単位）に換算します。
- サンドボックスのキーはテストモードで接続されるため、サンドボックスのチェックアウトを最初から最後まで試せます。
02売上が訪問に紐づくしくみ
- Paddle.js の customDataチェックアウトを開くときに、訪問者の ID を tally_visitor_id として customData に渡します。Paddle がサブスクリプションから各更新へコピーするので、更新分にも引き継がれます。
- 取引の custom_dataサーバーで作成する取引では、同じキーを custom_data に入れます。
- メールアドレス顧客のメールアドレスを受け取った時点でハッシュ化し、サイトでの tally('identify') の呼び出しと照合します。確度：中。
03読み取れないもの
- Paddle のホスト型チェックアウトとデフォルトの支払いリンクでは、訪問者の ID を渡す方法が公開されていないため、これらの売上はメールアドレスでのみ紐づけます。
- Paddle に権限機能が加わる前に作られたレガシー API キーは権限を制限できないため、受け付けません。
- Paddle の承認待ちの返金は、承認されるまで数えません。却下された返金は一切数えません。
- 取り込み対象の 365 日より古い取引に対する調整は取り込みません。
04接続のしかた
- Paddle で Developer tools → Authentication を開き、下記の 4 つの権限を付けた API キーを作成します。
- サイトの Integrations ページに貼り付けます。各権限は、それぞれ個別の API 呼び出しで確認します。
- Tally は Paddle に専用の通知先を追加し、過去 365 日分の取引を取り込みます。
- Paddle.js のチェックアウトを開く箇所で、customData に tally_visitor_id を追加します。ページ用とサーバーで作成する取引用のコードは Coverage ページにあります。
API キーに必要な権限
Tally が求めるのは、次のことだけができる API キーです。貼り付けた時点で権限ごとに実際の呼び出しで確認するので、足りない権限があれば名前で示されます。
| 権限 | アクセス | 用途 |
|---|---|---|
| Transaction | 読み取り | すべての支払い：金額、税額、発生元、カスタムデータ。 |
| Adjustment | 読み取り | 返金とチャージバック。 |
| Customer | 読み取り | tally('identify') と照合するための顧客のメールアドレス（すぐにハッシュ化し、保存はしません）。 |
| Notification setting | 書き込み | Tally が専用の通知先を追加するので、支払いは数秒で届きます。 |
05よくある質問
Tally は Paddle Classic に対応していますか？
Tally が読み取るのは Paddle Billing（API バージョン 1）で、権限付きのキーを使います。権限のないレガシーキーは、その旨を説明する一文とともに拒否されます。
Paddle で 4 つの権限が必要なのはなぜですか？
決済のための取引（transactions）、返金とチャージバックのための調整（adjustments）、メールアドレス照合のための顧客（customers）、そして Tally が専用の通知先を追加し、各決済を数秒以内に受け取るための通知設定（notification settings）です。
チャージバックは数えますか？
はい。承認されたチャージバックの調整はマイナスのチャージバックとして、取り消されたものはプラスとして戻るため、両者は元の売上に対して相殺されます。