Dodo Payments をつなぐ

必要なもの

フィールド	何をするか
API key	ホスト型チェックアウトを作るために Dodo を呼び出せるようにします。秘密です。
Webhook signing secret (whsec_…)	webhook が本当に Dodo から来たことを確認します。秘密です。
Return URL	チェックアウト後に購入者がたどり着く先。

ホスト型チェックアウトの作成を承認し、請求があなたのアカウントを通るようにします。

届いた webhook が本当に Dodo からのものだと証明し、誰も「支払い済み」イベントを偽造できないようにします。API key とは別の値です。

素の設定です。チェックアウト後に購入者がたどり着く先。秘密ではありません。

テストモードを使う(無料)
Dodo には別個のテスト環境があります。テストモードのキーは Dodo のテストホストに対して動き、実際のお金は動きません。
1. app.dodopayments.com にサインインします。
2. Dodo はライブとテストのキーを分けます。まずテストで設定し、その後ライブで繰り返します。
API key をコピーする
Developer → API Keys に行き、確認するための Test key、または実際の支払いを受けるための Live key をコピーします。
Dodo → Developer → API Keys
webhook を追加する
1. Dodo で webhook を追加します。
2. webhook URL をプロジェクトの webhook アドレス(下記)に設定します。
3. webhook signing secret(whsec_…)をコピーします。テストとライブで別々の webhook を追加します。
```
https://api.coinmoebius.com/webhook/dodopayments/<your project id>
```
Dodo → Developer → Webhooks
ダッシュボードでつなぐ
プロバイダーを追加 → Dodo Payments。Return URL とライブのグループ(Live API key、Live webhook signing secret)を入力します。先に確認するには任意のテストのグループを追加します。テストのグループは対です。テストの API key とテストの webhook secret の両方を追加するか、両方とも空欄にします。ライブとテストは別々に確認されます。

本番公開の前に、テスト支払いを一度実行します。

商品を作り、その Environment を Testing に設定します。これで商品がテストの認証情報で動き、お金を動かさずに注文を一通り出せます。(テストの組を省いた場合、Testing の商品はライブに戻るので、先に追加してください。)
プロジェクトに向けた買うボタンをページ(ローカルの HTML ファイルでも可)に置きます。
Dodo のテストモードでチェックアウトを完了します。
取引タブを開きます。Testing と付いた新しい行が現れます。そのステータスが succeeded に達したら、認証情報と webhook が両方とも端から端まで機能しています。

実際の支払いの準備ができたら、商品の Environment を Live に切り替えます。

まず「検証」から。ダッシュボードで「検証」(または「テスト認証情報を検証」)をクリックして、API key を確認します。

Test タブでテストの API key を追加し、プロバイダーを保存してから、ダイアログを開き直して検証してください。

webhook URL が一致すること、そして signing secret が同じ環境の webhook と一致すること(テストにはテストのシークレット、ライブにはライブ)を確認してください。

テストのグループは対です。テストの API key とテストの webhook secret の両方を追加するか、両方とも空欄にしてください。

Dodo Dashboard → Developer → Webhooks → Send Example(または Dodo CLI)を webhook URL に向け、その後注文が更新されるのを見てください。

一回払いのみ. Coin Moebius は Dodo を、サブスクリプションではなく単発の支払いに使います。

シークレットのローテーション. API key や webhook secret はいつでもローテーションでき、新しい値を貼り付けます。秘密のフィールドは編集時に空欄のままです。