Apex 開発者ガイド
jSalesforce での非同期支払ゲートウェイアダプタの設定
非同期支払ゲートウェイアダプタとのインターフェースになるように Salesforce を設定します。
| 使用可能なバージョン: Salesforce Summer ’20 以降 |
| API 49.0 以降で使用できます。 |
commercepayments API にアクセスするには、PaymentPlatform 組織権限が必要です。
-
サイトを作成します。
- サイトを登録して、サイトドメインを設定します。
- [設定] の [クイック検索] ボックスに「サイト」と入力し、[サイト] を選択します。[サイト] リストに移動し、[新規] をクリックします。
- 表示ラベルを入力し、[有効] を選択します。
- デフォルト Web アドレスの一意の値を入力します。
- [支払 API へのゲストアクセス] を選択して、変更を保存します。
- 支払ゲートウェイアダプタの Apex クラスを作成します。非同期設定では、Salesforce が非同期アダプタと同期アダプタの両方を実装する必要があります。Apex でのゲートウェイアダプタの作成についての詳細は、「非同期ゲートウェイアダプタの作成」および「同期ゲートウェイアダプタの作成」を参照してください。
-
Salesforce UI で指定ログイン情報を作成します。
- [設定] で、[クイック検索] ボックスに「NamedCredential」と入力し、[新規指定ログイン情報] を選択します。
- 支払ゲートウェイのユーザ名、パスワード、URL を入力して、変更を保存します。
-
支払ゲートウェイプロバイダを作成します。支払ゲートウェイプロバイダとは、トランザクションを処理するときに Salesforce が通信する支払ゲートウェイに関する詳細を保存するオブジェクトです。Salesforce Summer ’20 以降、支払ゲートウェイプロバイダレコードはワークベンチからのみ作成できます。
- ワークベンチにログインし、[REST Explorer] を選択します。
-
メソッドを Post に設定し、次の URL を入力して、[version] を目的の API バージョンに置き換えます。支払ゲートウェイプロバイダエンティティは Salesforce API バージョン 48.0 以降で使用できます。
services/data/[version]/tooling/sobjects/PaymentGatewayProvider
-
ペイロードを入力し、VALUE を目的の値に置き換えます。
1{ 2 "ApexAdapterId": "{{VALUE}}", 3 "DeveloperName": "{{VALUE}}", 4 "MasterLabel": "VALUE", 5 "IdempotencySupported": "VALUE", 6 "Comments": "VALUE",
-
支払ゲートウェイレコードを作成します。このオブジェクトには、Salesforce が支払ゲートウェイと通信するた���に使用する情報が保存されます。このレコードには次の項目値が必要です。
- 名前: Salesforce と通信する外部支払ゲートウェイと同じ名前を使用することをお勧めします。
- 業者のログイン情報 ID: ステップ 2 で作成した指定ログイン情報の ID を入力します。
- 支払ゲートウェイプロバイダ: ステップ 3 で作成した支払ゲートウェイプロバイダの ID を入力します。
- 状況: 有効
-
外部支払ゲートウェイでは、Web フックを使用して通知情報を HTTP POST メッセージとして Salesforce 非同期支払ゲートウェイアダプタに送信します。Web フックは、外部支払ゲートウェイの標準通知トランスポート設定で URL を指定することで作成できます。ステップ 1 の Salesforce サイトエンドポイントをステップ 4 で作成した支払ゲートウェイプロバイダの ID と組み合わせて、URL を作成します。
-
エンドポイントは次のアドレスになります。domain はステップ 1A のドメインに、subdomain はステップ 1D で指定したデフォルト Web アドレスに置き換えてください。
http://domain.dev.localhost.soma.force.com/subdomain/services/data/v49.0/commerce/payments/notify
-
ステップ 4 で作成した支払ゲートウェイプロバイダの ID を見つけ、?provider=ID をエンドポイントの最後に追加してください。
例: http://123solutions.dev.localhost.soma.force.com/solutionsusers/services/data/v49.0/commerce/payments/notify?provider=0cJR00000004CEhMAM
- 外部支払ゲートウェイの標準通知設定に Web フックを入力します。
-
エンドポイントは次のアドレスになります。domain はステップ 1A のドメインに、subdomain はステップ 1D で指定したデフォルト Web アドレスに置き換えてください。