Authorize.Net をつなぐ

必要なもの

フィールド	何をするか
API Login ID	API 呼び出しであなたのアカウントを識別します。Transaction Key と組になります。
Transaction Key	API 認証の秘密の半分。Login ID と合わせて、各支払いフォームを作ります。秘密です。
Signature Key	webhook が本当に Authorize.Net から来たことを確認します。Transaction Key とは別です。秘密です。
成功 URL / キャンセル URL	支払い後、または引き返した後に購入者がたどり着く先。

API Login ID と Transaction Key は常に一緒に動きます。Signature Key は独立しています。

各フィールドを尋ねる理由

API 呼び出しであなたのアカウントを名指します。Transaction Key と組になったときにのみ機能します。

Transaction Key

API リクエストがあなたのものだと証明する秘密。API Login ID と合わせて、ホスト型の支払いフォームを作れるようにし、請求があなたのアカウントを通るようにします。

Signature Key

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

成功とキャンセルの URL

素の設定です。支払い後、または引き返した後に購入者がたどり着く先。秘密ではありません。

設定

無料のサンドボックスアカウントを作る(支払い不要)
テストに有料のマーチャントアカウントは不要です。Authorize.Net は本番を模した無料のサンドボックスを、クレジットカード不要で提供しています。
1. developer.authorize.net/hello_world/sandbox.html に行き、サンドボックスアカウントに登録します。メインの登録ページや料金ページ(有料のライブ申し込み)ではなく、そのリンクを使ってください。
2. sandbox.authorize.net のサンドボックスの Merchant Interface にサインインします。
署名の仕組みは本番と同一なので、サンドボックスで確認したものはライブでも同じように振る舞います。
3つの認証情報をコピーする
サンドボックスとライブで同じ経路:Account → Settings → Security Settings → General Security Settings → API Credentials and Keys。
- API Login ID は上部に表示されます。
- Transaction Key:「New Transaction Key」を選び、確定して、すぐにコピーします(一度だけ表示されます)。
- Signature Key:「New Signature Key」を選び、確定して、すぐにコピーします。
Account → Settings → Security Settings → API Credentials and Keys
webhook を追加する
1. Account → Settings → Business Settings → Webhooks で、エンドポイントを追加します。
2. エンドポイント URL をプロジェクトの webhook アドレス(下記)に設定します。
3. イベントを購読します。一回払い:net.authorize.payment.authorization.created、authcapture.created、capture.created、priorAuthCapture.created、refund.created、void.created、そして fraud.* のイベント(held、approved、declined)。サブスクリプション(Automated Recurring Billing):net.authorize.customer.subscription.* のイベント。更新は authcapture.created として届き、すでにカバーされています。余分なイベントは無害です。
4. 保存します。Authorize.Net は各配信を Signature Key で署名します。
```
https://api.coinmoebius.com/webhook/authorizenet/<your project id>
```
Account → Settings → Business Settings → Webhooks
Coin Moebius は各イベントIDを一度記録し、重複は無視するので、再送された webhook はあなたに代わって処理されます。
サンドボックスのカードでテストする
サンドボックスのカードは実際のカードに請求することは決してありません。任意の未来の有効期限(例:12/2030)と任意の CVV(3桁、American Express は4桁)を使います。
ネットワークカード
Visa 4111111111111111
Mastercard 5424000000000015
American Express 370000000000002
Discover 6011000000000012
ダッシュボードでつなぐ
プロバイダーを追加 → Authorize.Net。成功 URL、キャンセル URL、そしてライブのグループ(API Login ID、Transaction Key、Signature Key)を入力します。テストには任意のサンドボックスのグループを追加します。サンドボックスのグループは全部か無かです。3つのフィールドすべて、または無し。ライブとサンドボックスは別々に確認されます。

ネットワーク	カード
Visa	4111111111111111
Mastercard	5424000000000015
American Express	370000000000002
Discover	6011000000000012

接続した後

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

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

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

トラブルシューティング

まず「検証」から。ダッシュボードで「検証」(サンドボックスの組には「テスト認証情報を検証」)をクリックして、API Login ID と Transaction Key を確認します。

検証が失敗する。

API Login ID と Transaction Key は、同じアカウント(ライブまたはサンドボックス)の組でなければなりません。両方を改めてコピーしてください。

署名の検証が失敗する。

Signature Key は Transaction Key とは別の値です。同じ画面から Signature Key をコピーしてください。仕組みはサンドボックスとライブで同一です。

支払いは完了するのに、注文が保留のまま。

webhook URL が正確に一致すること、そして支払いのイベントを購読したことを確認してください。

テスト商品がライブのカードに請求した。

テストと印を付けた商品は、完全なサンドボックスの組が設定されていないと、ライブの認証情報に戻ります。3つのサンドボックスのフィールドすべてを追加するか、商品のテスト印を外してください。

端から端まで確認する。

Authorize.Net は非アクティブな webhook にのみ ping します。エンドポイントを非アクティブにして ping を送り、その後再アクティブ化して、注文が更新されるのを見てください。

知っておくとよいこと

トークンは短命. ホスト型フォームのトークンは約15分持続します。当社はチェックアウトごとに新しいものを作ります。

通貨. Authorize.Net は主に米国・USD のゲートウェイです。USD 以外は、あなたの処理業者との契約次第です。

キーのローテーション. 新しい Transaction Key や Signature Key をいつでも生成して、貼り付けます。秘密のフィールドは編集時に空欄のままです。

ご質問は? Join our Discord

Authorize.Net