コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要決済を受け付ける構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つける継続課金
対面決済
決済手段
決済業務
残高と売上処理にかかる期間領収書返金とキャンセル
高度な連携システム
決済以外の機能

AI エージェントでコンテキストに応じた販売を実現非公開プレビュー

AI エージェントを使って、コンテキストに応じた商品販売の方法を学びましょう。

プライベートプレビュー

ビジネスでエージェントコマースを使用して商品を販売したい場合は、待機リストに登録してください。

メモ

このガイドは e コマース事業者向けです。もし貴社がマーケットプレイスで、自社プラットフォーム上でのコンテキストに応じた代理販売を提供したい場合は、プラットフォームおよびマーケットプレイス向けガイドをご覧ください。

Stripe アカウントを設定する

Stripe アカウントをまだお持ちでない場合は、作成します。メールを確認したら、ビジネスと個人情報の詳細を提供し、Payouts 用の銀行口座を関連付け、2 段階認証などのセキュリティ機能を設定して、決済を有効にする必要があります。

次に、Stripe ダッシュボードでエージェンティックコマースのアカウント登録に移動します。ここで Stripe プロフィールを作成し、エージェンティックコマースの各種設定を行います。

税金を設定

Stripe Tax を使用して税金を管理し、個々の商品に設定を適用します。税金設定ガイドに従って Stripe Tax を設定します。

商品カタログの CSV アップロードで、stripe_product_tax_code 列を設定して、商品を税金処理に関連付けます。

Stripe は、Anrok、Avalara、Sphere などのサードパーティーの税務プロバイダーによる税金計算にも対応しています。

Stripe に商品カタログデータをアップロードする

Stripe 製品カタログの仕様に準拠した CSV ファイルを作成します。

Stripe にカタログデータをアップロードする

Stripe ダッシュボードまたは Stripe API を介して該当するフィードを配信します。フィードはいつでもアップロードできます。データを最新の状態にするには、1 日 1 回商品データをアップロードし、在庫と価格の増分更新を頻繁に送信してください。

メモ

フィードのアップロードは、独立した非同期タスクとして処理されます。アップロードが送信された順に処理または完了するとは限りません。複数のファイルを連続してすばやくアップロードすると、後からアップロードされたものが先にアップロードされたものより先に完了することがあります。

Stripe API を使用して、商品カタログ CSV をアップロードできます。本番更新を有効にする前に、サンドボックスを使用して解析、フィールドマッピング、データ品質を検証することをお勧めします。

まず、Files API を使用して商品カタログ CSV をアップロードします。リクエストが成功すると、id を含む File オブジェクトが返されます。

  • data_management_manual_upload の目的を指定します。
  • ファイルアップロードの MIME タイプは、そのファイル形式に対応している必要があります。使用できる形式は、CSV と TSV です。各行は 1 つの商品またはバリエーションを表します。
  • 最大ファイルサイズは 200 MB です。
Command Line
curl https://files.stripe.com/v1/files \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -F purpose=data_management_manual_upload \
  -F file="@/path/to/your/file.csv;type=text/csv"

次に、Data Management API を使用して ImportSet を作成します。このコールによりカタログ処理が開始され、ダッシュボードでデータを使用できるようになります。以下を含めます。

  • 返されたファイル id
  • プレビューヘッダー (Stripe-Version: 2025-09-30.clover;udap_beta=v1 など)
Command Line
curl https://api.stripe.com/v1/data_management/import_sets \
  -H "Stripe-Version: 2025-09-30.clover;udap_beta=v1" \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d file={{FILE_ID}} \
  --data-urlencode standard_data_format="product_catalog_feed"

フィードステータスを監視し、エラーを解決する

Stripe はカタログデータを処理し、検証とクリーンアップを行い、AI エージェントに送信できる形式でインデックスを作成します。Stripe のインデックス作成の進捗状況は、次の 2 つの方法で監視できます。

GET リクエストを作成し、ImportSet オブジェクトのステータスフィールドを確認します。ステータスは pending、failed、succeeded、succeeded_with_errors、pending_archive、archived のいずれかです。

Command Line
curl https://api.stripe.com/v1/data_management/import_sets/{{IMPORT_SET_ID}} \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

レスポンスには、ステータスとエラーが含まれます。

{
  "id": "impset_7MabcdZ8b617780e5145413",
  "object": "data_management.import_set",
  "created": 1643992696,
  "livemode": true,
  "result": {
    "errors": {
      "file": "file_234923sIENc",
      "row_count": 30
    },
    "rows_processed": 120,
    "successes": {
      "row_count": 90
    }
  },
  "status": "succeeded_with_errors"
}

インポートのステータスが succeeded_with_errors の場合は、エラーレポートをダウンロードできます。

  1. 応答で result.errors.file フィールドを探します。
  2. Files API を使用して、ファイル ID を使用してエラーファイルのコンテンツを取得します。
  3. ダウンロードされた CSV ファイルには、stripe_error_message という先頭の列に各行が失敗した理由を示す元のデータが含まれています。
Command Line
curl https://files.stripe.com/v1/files/{{ERROR_FILE_ID}}/contents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

API は、失敗した行のみを含む CSV ファイルを返します。各エラーを説明する stripe_error_message 列が含まれます。

購入への対応と注文のフルフィルメント

AI チャットエージェントを介して行われた注文は、次の3つの方法で監視できます。

ダッシュボードの取引ページで注文を表示します。注文は元のエージェントでタグ付けされています。

AI チャットエージェントでの販売を有効にする

AI チャットエージェントで販売する準備ができたら、Stripe ダッシュボードでエージェントの規約をレビューし、エージェントを有効にします。Stripe はエージェントに承認リクエストを送信し、エージェントは承認する必要があります。

AI チャットエージェントでの販売を一時停止または停止するには、ダッシュボードでエージェントを無効にします。

オプション手動でキャプチャーする

デフォルトでは、Stripe は購入後すぐに決済をキャプチャーします。手動キャプチャーを使用するには、ダッシュボードのエージェント設定ページを開き、キャプチャーモードを手動に設定します。手動キャプチャーを有効にすると、PaymentIntent で capture メソッドを呼び出します。

Command Line
curl -X POST https://api.stripe.com/v1/payment_intents/pi_3MrPBM2eZvKYlo2C1TEMacFD/capture \
  -u "<secret_key>:" \
  -H "Stripe-Version: 2025-09-30.preview"

オプション確認前の承認フックを設定する

デフォルトでは、決済確定前に貴社の商品カタログデータをもとに在庫確認と、Radar を用いた不正利用チェックが自動で行われます。購入完了可否を自社で制御したい場合は、手動承認フックを設定してください。決済完了の直前に、Stripe が貴社のサービスへの承認リクエストを送信しますので、承諾または却下の判断を返してください。このフックには 2 秒のタイムアウト制限が設定されています。この制限時間内に応答がない場合、Stripe はその決済を自動的に却下します。

手動承認フックを設定するには

  1. ダッシュボードのエージェンティックコマース設定のページでエンドポイントを指定します。
  2. エンドポイントにロジックを実装し、以下のリクエストとレスポンスの形式を使用します。

承認リクエスト形式

Stripe はエンドポイントに次のリクエストを送信します。

{
  type: "v1.delegated_checkout.finalize_checkout",
  id: String,
  livemode: Boolean,
  // account ID
  context?: String,
  // request specific data
  data: {
    amount_subtotal?: Number,
    amount_total?: Number,
    billing_details?: {
      name?: String,
      address?: {
        line1?: String,
        line2?: String,
        city?: String,
        state?: String,
        postal_code?: String,
        country?: String
      }
    },
    currency: String,
    email?: String,
    line_items_details: Array<{
      id: String,
      unit_amount: Number,
      quantity: Number,
      name: String
    }>,
    payment_method_details?: {
      type: "card" | ...,
      card?: {
        brand: "amex" | "visa" | "master_card" | ...,
        country?: String,
        exp_month: Number,
        exp_year: Number,
        fingerprint?: String,
        funding: "credit" | "debit" | "prepaid" | "unknown",
        iin?: String,
        last4: String,
        wallet?: {
          type: "apple_pay" | "google_pay" | ...
        }
      }
    },
    phone?: String,
    shipping_details?: {
      name?: String,
      address?: {
        line1?: String,
        line2?: String,
        city?: String,
        state?: String,
        postal_code?: String,
        country?: String
      },
    },
    total_details?: {
      amount_discount?: Number,
      amount_shipping?: Number,
      amount_tax?: Number
    }
  }
}

確認前承認応答フォーマット

HTTP/1.1 200 OK
{
  manual_approval_details: {
    type: "approved" | "declined",
    declined?: {
      reason: String
    }
  }
}

オプション配送オプションフックを設定する

デフォルトでは、Stripe は商品カタログで定義されたオプションに基づいて、商品の配送オプションを計算します。各オプションには、名前、説明、配送予定日、料金が含まれます。商品カタログでは、商品ごとに送料無料を設定できます。

独自のロジックで配送オプションとコストを動的に計算するには、配送オプションフックを実装します。カート内のアイテムとともに Checkout をエージェントに返す前にフックが呼び出されます。その後、エージェント UI は計算した配送オプションと価格を表示します。

リクエスト形式

次の例は、配送オプションを計算するためにお客様が設定したリバース API エンドポイントに、compute_shipping_options リクエストの入力を送信する方法を示しています。

{
  livemode: Boolean,
  currency: String,
  amount_total: Integer,
  amount_subtotal: Integer,
  total_details?: {
      amount_discount?: Number,
      amount_tax?: Number
  },
  line_items_details: [
      {
        sku_id: String,
        unit_amount: Integer,
        quantity: Integer,
        amount_subtotal: Integer,
        amount_total: Integer,
        amount_tax: Integer,
        amount_discount: Integer
      }
    ],
  fulfillment_details?: {
      address?: {
        line1?: String,
        line2?: String,
        city?: String,
        state?: String,
        postal_code?: String,
        country?: String
      }
    }
  }

配送オプションの応答フォーマット

HTTP/1.1 200 OK
{
  fulfillment_options: [
    {
        display_name: String,
        description: String,
        earliest_delivery_time: Integer,
        latest_delivery_time: Integer,
        shipping_amount: Integer
     }
  ]
}

オプション増分インベントリ更新を送信する

商品カタログのアップロードに加えて、Inventory Feed API を使用して個別の商品在庫の更新を送信します。カタログのアップロードと同じアップロードプロセスを使用しますが、standard_data_forma を inventory_feed に設定します。

Command Line
# Step 1: Upload your CSV using the Files API
curl https://files.stripe.com/v1/files \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -F purpose=data_management_manual_upload \
  -F file="@/path/to/your/file.csv;type=text/csv"

# Step 2: Create an ImportSet object
curl https://api.stripe.com/v1/data_management/import_sets \
  -H "Stripe-Version: 2025-09-30.clover;udap_beta=v1" \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d file={{FILE_ID}} \
  --data-urlencode standard_data_format="inventory_feed"

オプション価格の増分更新を送信

商品カタログをアップロードし、Price Feed API を通じて個別の価格更新を送信してください。カタログアップロードと同じアップロードプロセスを使用し、standard_data_format を price_feed に設定してください。

Command Line
# Step 1: Upload your CSV using the Files API
curl https://files.stripe.com/v1/files \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -F purpose=data_management_manual_upload \
  -F file="@/path/to/your/file.csv;type=text/csv"

# Step 2: Create an ImportSet object
curl https://api.stripe.com/v1/data_management/import_sets \
  -H "Stripe-Version: 2025-09-30.clover;udap_beta=v1" \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d file={{FILE_ID}} \
  --data-urlencode standard_data_format="price_feed"

オプション返金および不審請求の申し立ての処理

決済が成功した後、顧客がウェブサイトまたは顧客サービスで注文をキャンセルした場合は、返金を開始します。Checkout Sessions API または PaymentIntents API をすでに使用している場合は、エージェントによる決済では既存の返金するフローは変更されずに機能します。

返金と不審請求の申し立ては、ダッシュボードの取引ページで管理することも、Refunds API を使用してプログラムで処理することもできます。

参照情報