買い物カゴの作成と注文の確定

B2C Commerce API (SCAPI) は、Shopper Baskets、Shopper Customers、および Shopper Orders API ファミリーを通じた注文手続きをサポートしています。

このトピックでは、買い物カゴを作成して送信するためのベストプラクティスの概要を説明し、SCAPI を使用した支払処理へのアプローチ方法に関する全体的なガイダンスを提供します。

支払カードデータを B2C Commerce に渡さないでください。代わりに、プロバイダーの script/iframe を使用して買い物客に支払カードデータを直接決済プロバイダーに提供してもらい、プロバイダーから返されたトークンを API に渡します。トークンを検証し、トークンが有効な場合は注文を受け入れ、それ以外の場合は拒否します。

この記事では、支払いトークンを取得する支払いゲートウェイを操作していることを前提としています。

このページの一部のリンクにアクセスできるのは、既存のお客様のみです。Commerce Cloud リポジトリにアクセスする方法については Salesforce Commerce Cloud GitHub リポジトリとアクセスを参照してください。

以下を実装していることを確認します。

  • 支払いゲートウェイ
  • 注文の作成方法に関する戦略。SCAPI では、支払を検証する前に注文を作成することをお勧めします。
  • SLAS プライベートクライアントまたは SLAS パブリッククライアント。このトピックのコード例では、プライベートクライアントを使用します。詳細については、SLAS クライアントの作成を参照してください。

買い物カゴを作成するには、次の 2 つの方法があります。

  • 買い物カゴを段階的に作成する
  • 1 つのリクエストで買い物カゴを作成する

買い物カゴを段階的に作成する場合は、買い物客から提供された情報を入力します。これにより、買い物カゴが B2C Commerce バックエンドに保持され、買い物カゴを簡単に永続化できない場合に便利です。 また、次のコード例に示すように、検証を実行し、API エラーを返すこともできます。コード例に含まれるコメントはわかりやすくするために提供されており、コードを機能させるには削除する必要があることに注意してください。

また、リクエストを 1 回行うだけで買い物カゴを作成し、入力したい関連部分を指定することもできます。 次の例では、買い物カゴ全体とその入れ子になったドキュメントを 1 つのリクエストで作成します。

既存の買い物カゴを取得するには、Shopper Customers API getCustomerBaskets エンドポイントを使用します。

次の例では、顧客 ID を使用して顧客の買い物カゴを取得します。

次の例では、買い物カゴ ID を使用して買い物カゴを取得します。