連携 · 決済サービス
Polar の注文とサブスクリプションを、それぞれの流入元とともに。
5 つのスコープに限定した組織アクセストークンで Polar を接続します。Tally は購入とサブスクリプションの請求サイクルを、返金や敗れた異議申し立てとあわせて読み取り、チェックアウトのメタデータ、チェックアウトリンクの reference、メールアドレスのいずれかで訪問者に紐づけます。
無料で始める
14 日間無料、カード登録は不要です。
01Tally が読み取るもの
- 金額のある注文を、支払いが完了した時点で読み取ります。購入とサブスクリプションの初回支払いは新規、請求サイクルと従量課金のサイクルは更新、プラン変更はアップグレードとして扱います。
- 返金は保留中または成功の状態で数えます。失敗またはキャンセルされた返金には取り消し分を加えるため、両者の合計はゼロになります。
- 敗れた異議申し立ては、税を除いてチャージバックとして数えます。
- 金額は割引後・税抜きで、その日の参照レートで米ドル(セント単位)に換算します。
- サンドボックスのトークンはテストモードで接続します。
02売上が訪問に紐づくしくみ
- チェックアウトのメタデータチェックアウトの metadata に入れた訪問者の ID。Polar がそれを注文とサブスクリプションにコピーします。
- チェックアウトリンクチェックアウトリンクの reference_id はチェックアウトの metadata に入り、Stripe の Payment Link と同じように紐づきます。
- メールアドレス顧客のメールアドレスをすぐにハッシュ化し、tally('identify') の呼び出しと照合します。確度:中。
03読み取れないもの
- Polar は異議申し立てのイベントを送らないため、敗れた異議申し立ては、その注文が次に更新されたときか、再取り込みのときに読み取ります。
- スニペットは Polar のチェックアウトリンクに自動で ID を付けません。Polar の埋め込みが data-polar-checkout を付けたリンクなら、ページに数行足せば付けられます。
- 無料の商品など金額のない注文は売上ではないため、数えません。
04接続のしかた
- Polar で Settings → Access Tokens を開き、下記の 5 つのスコープを付けた組織トークンを作成します。
- サイトの Integrations ページに貼り付けます。各スコープを確認し、サンドボックス用のトークンはテストモードとして認識します。
- Tally は専用の Webhook エンドポイントを作成し、返金と敗れた異議申し立てを含めて過去 365 日分を取り込みます。
- Coverage ページの手順どおり、チェックアウトの metadata か、チェックアウトリンクの reference_id に訪問者の ID を入れます。
アクセストークンに必要な権限
Tally が求めるのは、次のことだけができるアクセストークンです。貼り付けた時点で権限ごとに実際の呼び出しで確認するので、足りない権限があれば名前で示されます。
| 権限 | アクセス | 用途 |
|---|---|---|
| Organizations | organizations:read | 組織名(どの組織が接続されているかを確認するため)。 |
| Orders | orders:read | すべての支払い:金額、税額、メタデータ、顧客のメールアドレス(すぐにハッシュ化し、保存はしません)。 |
| Refunds | refunds:read | 返金。 |
| Disputes | disputes:read | チャージバック:負けた異議申し立て。 |
| Webhooks | webhooks:write | Tally が専用の Webhook エンドポイントを追加するので、支払いは数秒で届きます。 |
05よくある質問
Polar で請求した従量課金も Tally で数えられますか?
はい。従量課金のサブスクリプションサイクルの注文は更新として、Polar が請求した金額で数え、顧客を獲得した訪問に帰属させます。
Polar で disputes スコープが必要なのはなぜですか?
Polar は異議申し立てのイベントを送らないため、Tally は Disputes API を読み取って敗れた異議申し立てを見つけ、その売上に対するチャージバックとして数えます。
まず Polar のサンドボックスで試せますか?
はい。サンドボックスのトークンを貼り付けると、専用の Webhook を備えたテストモードで接続されるので、サンドボックスのチェックアウトを最初から最後まで確認できます。