# Stripe app for Salesforce 注文管理

Stripe App for Salesforce 注文管理についてご紹介します。

> Salesforce CRM、Core、およびプラットフォームとの連携には、[Stripe app for Salesforce Platform](https://docs.stripe.com/use-stripe-apps/stripe-app-for-salesforce/overview.md) を使用することをお勧めします。

Stripe App for Salesforce Order Management は、Order Management 上にインストールできる管理パッケージであり、サポートされている注文サービスのユースケースにおける支払いのキャプチャーと返金を可能にします。これには、Payments と返金を処理する非同期と同期の両方のアダプターが含まれています。

## Before you begin

1. Salesforce Core Platform 上の Salesforce B2C Commerce Cloud と Salesforce Order Management でホストされるストアフロント。
1. Commerce Cloud での Stripe「または」Salesforce Payments による支払いを回収するための Salesforce Commerce Cloud カートリッジ。
1. SalesforceB2C Commerce Cloud と Salesforce Order Management の間で連携が有効になっている。
1. PaymentPlatform 組織権限によって有効化された CommercePayments API へのアクセス。
1. Salesforce CommercePayments は、API バージョン 49.0 以降を使用する組織でのみ利用できます。Commerce Payments は、Lightning Experience でのみ利用できます。

## 中心となる概念

### PaymentIntent

PaymentIntent は Stripe の用語であり、Stripe で作成され、支払いの作成から決済処理までを追跡し、場合によって追加の認証ステップを起動する、トランザクションを指します。これは、[Payment Intents API](https://docs.stripe.com/payments/payment-intents.md) を実装することで実行されます。Payment Intent を Salesforce Order Management で確認するには、Order Summary (注文のサマリー) の支払いのオーソリレコードに対応する Gateway Reference Number (ゲートウェイ参照番号) (`GatewayRefNumber`) フィールドを探します。

### 支払いのオーソリ

支払いのオーソリは、Stripe と Salesforce OMS の両方に関連します。オーソリされた金額とは、顧客に購入の完了に必要な残高が十分にあることを確認するために、企業がクレジットカードまたはデビットカード処理業者に送金する金額で、承認された金額が請求されることになります。

Stripe LINK Cartridge for Salesforce B2C Commerce Cloud には、オーソリとキャプチャーという 2 つの[キャプチャーモード](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-capture_method)があります。LINK カートリッジで決済時に支払いをオーソリするように設定されている場合、支払いのオーソリレコードが Salesforce Order Management で作成されます。次の手順を使用して、注文のサマリーに対する支払いのオーソリを確認できます。

**Order Summary Record (注文のサマリーレコード) > Order Payment Summary Record (注文の支払いのサマリーレコード) > Payment Authorizations in Related Tab (関連タブの支払いのオーソリ)**

**Related (関連)** タブに `Refunds` が表示されない場合は、Salesforce 管理者に連絡して、以下に示すように支払いのオーソリ関連リストをページレイアウトに含めます。
![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-payment-auth-sc1.bb4f7cb8c5bce6a76d45fa975c210894.png)

Stripe での PaymentIntent ID (pi_XXXXXX) は、支払いのオーソリレコードの Gateway Reference Number (ゲートウェイ参照番号) (`GatewayRefNumber`) フィールドに保存されます。Processing Mode (処理モード) (`ProcessingMode`) は、`External` に設定され、支払いのオーソリが Salesforce 決済プラットフォームの外部で処理されたことが示されます。

### 支払い

Stripe LINK カートリッジのキャプチャーモードが `Capture` に設定されている場合、支払いは顧客からキャプチャーされます。この場合、支払いレコードは Salesforce Order Management で作成されます。次の手順で注文のサマリーから支払いを確認できます。

**Order Summary Record (注文のサマリーレコード) > Order Payment Summary Record (注文の支払いのサマリーレコード) > Payment in Related Tab (関連タブの支払い)**

**Related (関連)** タブに `Refunds` が表示されない場合は、Salesforce 管理者に連絡して、以下に示すように支払い関連リストをページレイアウトに含めます。
![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-payment-sc1.8c48be7fc8849db13914a5f363fba750.png)

### 取引残高 ID

Stripe での PaymentIntent (`pi_XXXXXX`) に対する取引残高 ID (`txn_XXXXXXXXX`) は、Gateway Reference Number (ゲートウェイ参照番号) (`GatewayRefNumber`) フィールドに保存されます。Processing Mode (処理モード) (`ProcessingMode`) フィールドの値は、`External` に設定され、支払いが Salesforce 決済プラットフォームの外部で処理されたことが示されます。支払いが Salesforce B2C Commerce Cloud ストアフロントでオーソリされ、金額が後から Salesforce OMS でキャプチャーされた場合、支払いレコードは次のように表示されます。
![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-baltxn-sc1.7eae0d579cb7f583f4270517d7bd5ab3.png)

Stripe での Payment Intent (`pi_XXXXXX`) に対応する Salesforce Payment Gateway ID (`SFXXXXX`) は、Gateway Reference Number (ゲートウェイ参照番号) (`GatewayRefNumber`) フィールドに保存されます。Processing Mode (処理モード) (`ProcessingMode`) フィールドの値は、`Salesforce` に設定され、支払いが Salesforce 決済プラットフォームによって処理されたことが示されます。

### 返金

返金が Salesforce OMS から開始された場合、次の手順で返金レコードまで追跡できます。

**Order Summary Record (注文のサマリーレコード) > Order Payment Summary Record (注文の支払いのサマリーレコード) > Refunds (返金) (関連タブ内)**

**Related (関連)** タブに `Refunds` が表示されない場合は、Salesforce 管理者に連絡して、以下に示すように返金関連リストをページレイアウトに含めます。
![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-refund-sc1.6ac94b1ed3162b35735ca3bbf0e6bd70.png)

Salesforce Payment Gateway ID (`SFXXXXX`) は、Gateway Reference Number (ゲートウェイ参照番号) (`GatewayRefNumber`) フィールドに保存されます。Processing Mode (処理モード) (ProcessingMode) は、`Salesforce` に設定され、返金が Salesforce 決済プラットフォームによって処理されたことが示されます。

### Payment Gateway のログ

Salesforce プラットフォームで行われた取引のログは、**Order Summary Record (注文のサマリーレコード) > Order Payment Summary Record (注文の支払いのサマリーレコード) > Gateway Logs (ゲートウェイログ)** に移動して **Related (関連)** タブで確認できます。**Related (関連)** タブにゲートウェイログが表示されない場合は、Salesforce 管理者に連絡して該当ページのレイアウトにゲートウェイログを含めるか、この SOQL を Developer Console または VS コードの SOQL Builder で実行します。

```sql
SELECT Id, OrderPaymentSummaryId, ReferencedEntityId, Request, Response, SfRefNumber, SfResultCode, GatewayRefNumber, GatewayAuthCode, GatewayDate, GatewayMessage, GatewayResultCode, GatewayResultCodeDescription, InteractionStatus FROM PaymentGatewayLog
```

## See also

- [コンポーネントの概要](https://docs.stripe.com/use-stripe-apps/salesforce-order-management/overview.md)
- [インストールガイド](https://docs.stripe.com/use-stripe-apps/salesforce-order-management/installation.md)
- [運用とメンテナンス](https://docs.stripe.com/use-stripe-apps/salesforce-order-management/operations-and-maintenance.md)
- [テスト](https://docs.stripe.com/use-stripe-apps/salesforce-order-management/testing.md)