必要なもの
| フィールド | 何をするか |
|---|---|
| API key ID | 適切なアカウントを呼ぶために MakePay API key を識別します。 |
| API key secret | あなたのアカウント上で MakePay チェックアウトを作るのを許可します。秘密です。 |
| Webhook secret | webhook が本当に MakePay から来たことを確認します。秘密です。 |
| 成功 URL | 支払い完了後に購入者がたどり着く先。 |
| 失敗 URL | 支払いが失敗したか、キャンセルされた場合に購入者がたどり着く先。 |
MakePay は API key ID とシークレットを一緒に発行します。webhook secret はコールバック設定から別個の値です。
各フィールドを尋ねる理由
API key ID
どの MakePay key で認証するかを指名します。それ自体は秘密ではありませんが、下記のシークレットと組で使われます。
API key secret
チェックアウトの作成を承認し、支払いがあなたの MakePay アカウントへ対して動き、ウォレットへ入金されます。MakePay は生成直後にそれを一度だけ表示します。
Webhook secret
届いた webhook が本当に MakePay からのものだと証明し、誰も「支払い済み」イベントを偽造できないようにします。API key とは別の値です。
成功と失敗の URL
素の設定です:支払い後、または失敗/キャンセル後に購入者がたどり着く先。秘密ではありません。
設定
- MakePay で API key を生成する
MakePay にサインインし、API & SDK → API integrations に移動します。API keys 下で「Generate API Key」をクリックし、「Coin Moebius」のような名前をつけ、作成します。MakePay は API key ID と secret をそれぞれ生成直後に一度だけ表示します。秘密は二度と表示されないので、今それぞれコピーしてください。
MakePay → API & SDK → API integrations → Generate API Key API key secret をパスワードのように扱ってください。失った場合は、古いキーから復旧を試みるのではなく、新しいキーを生成してください。
- あなたの Coin Moebius プロジェクト ID を探す
別のタブで Coin Moebius ダッシュボードのあなたのプロジェクトを開き、プロジェクト名の下の Project ID をコピーします。あなたの MakePay コールバック URL はそのプロジェクト ID を下記のアドレスに落とし込んだものです。次のステップで MakePay に貼り付けます。
https://api.coinmoebius.com/webhook/makepay/<your project id>Coin Moebius → あなたのプロジェクト → Project ID つないだプロバイダーカード(最後のステップ)も同じ URL を表示するので、いつでも再コピーできます。
- コールバック URL を設定し、webhook secret をコピーする
MakePay に戻り、Delivery → Callback URL configuration にスクロールします。「Edit Callback URL」をクリックし、あなたの Coin Moebius webhook URL をアクティブな宛先として貼り付け、保存します。次に「Webhook signing」で、署名シークレットをコピーしてください(値がない場合は「Regenerate secret」を使う)。それが Coin Moebius が求める Webhook secret です。
MakePay → Delivery → Callback URL configuration MakePay はすべてのマーチャント目立つステータス変更の後、このアドレスに配信アップデートを送ります。署名シークレットは API key とは別なので、両方が必要です。
- Coin Moebius ダッシュボードでつなぐ
Coin Moebius で、プロバイダーを追加 → MakePay を開きます。API key ID、API key secret、Webhook secret を貼り付け、成功 URL と失敗 URL を設定(支払い後、または失敗した支払いの後に購入者がたどり着く先)。「Save」をクリックします。
Coin Moebius → Add provider → MakePay 保存されたシークレットは隠れたままです。後で変更するには、「Replace」を選んで新しい値を入力してください。
- つながりました
MakePay があなたの「Providers」タブに、つなぎ日時と、それが見守る webhook URL と共に現れます。まだ MakePay のコールバック設定にそのの URL を貼り付けていなければ、そうしてください。「Edit」でキーをローテーションするか、「Disconnect」で削除でき、「Test mode」トグルで実際の数値に影響を与えずに注文を一通りしてください。
Coin Moebius → Providers → MakePay (connected)
接続した後
本番公開の前に、一度注文を一通りしてください:
- つながった MakePay カード上で「Test mode」トグルをオンにし、実際の数値に影響を与えずに注文を一通りします。
- 商品を作り、買うボタンをあなたのプロジェクトを向かせたページ(ローカルの HTML ファイルでも可)に置きます。
- MakePay 経由でチェックアウトを完了します。
- 取引タブを開きます。新しい行のステータスが succeeded に達したら、キーと webhook の両方とも端から端まで機能しています。
実際の支払いの準備ができたら、Test mode をオフにしてください。
トラブルシューティング
ダッシュボードから始めてください:MakePay カードがつながったと表示されていること、そして webhook URL がコールバック先として MakePay に保存されたものと一致していることを確認します。
支払いは完了するのに、注文が保留のまま。
webhook が着地していないか、検証されていません。MakePay のコールバック URL があなたのプロジェクトの webhook URL と完全に一致することを確認し、Coin Moebius の Webhook secret が MakePay の署名シークレットと同じであることを確認してください。
プロバイダーの保存が拒否される。
API key ID、API key secret、Webhook secret はすべて必須です。MakePay からこれらを再コピーしてください。シークレットは一度だけ表示されるので、もう持っていない場合は新しいキーを生成してください。
テスト注文が「取引」タブに現れない。
MakePay カード上で「Test mode」トグルをオンにしてから買うボタンを実行し、そして商品が同じプロジェクトを向いていることを確認してください。
知っておくとよいこと
ノンカストディアル. MakePay は暗号資産をあなた自身のウォレットへ直接入金します。Coin Moebius はお金を保持せず、動かすことはできません。
シークレットのローテーション. いつでも新しい API key を生成するか webhook 署名シークレットをローテーション。その後ダッシュボードで「Replace」を選んで新しい値を貼り付けます。秘密のフィールドは編集時に空欄のままです。
ご質問は? Join our Discord