Stripe

最終更新日： 2025年11月12日

トピック：
Sources

作成対象：

Developer

Adobe Experience Platform、Adobe Commerce、およびMagento Open Sourceを使用して、あらゆる規模の何千もの企業が、オンラインと対面の両方でStripeを利用して、支払いを受け入れ、新しい収入源を生み出し、グローバルに展開しています。

Experience PlatformのStripe ソースを使用して、お客様による購入フロー中にキャプチャされたデータを取り込みます。取り込まれたデータは、パーソナライズされたオファーの作成や、より充実したビジネスインサイトの獲得に活用できます。

TIP

Experience PlatformのStripe ソースに関するご質問は、Stripeのadobe-partnership@stripe.comまでお問い合わせください。

ソース Stripeの使用例

お客様は、オンラインストアで商品を購入できます。オプションは、今すぐ購入および 後で支払い です（Klarna、Afterpay、Affirm、またはZipを使用）。

Stripe データソースを使用して、今すぐ購入および後で支払う オプションの使用状況を分析し、これらの顧客に対するパーソナライズされたオファーを試してください。例えば、チェックアウトする前にショッピングカートに入っている商品の数を増やすために、アドオン商品をレコメンドすることを検討します。

style

shade-box

Stripe ソースアカウントのセットアップ方法、必要な資格情報の取得方法、スキーマの作成方法について詳しくは、以下のドキュメントを参照してください。

前提条件 prerequisites

次の節では、Stripe アカウントをExperience Platformに接続する前に完了する必要がある前提条件の設定について説明します。

アクセストークンの取得

Stripeの電子メールアドレスとパスワードを使用して、Stripe ダッシュボードにログインします。
Developers ダッシュボードで、API keys for developersを選択します。
「API キー」タブで、Reveal test keyを選択してアクセストークンを表示します。
Flow Service APIまたはExperience Platform UIを使用して、Stripe アカウントをExperience Platformに接続する際に、このトークンをアクセストークンとして使用できるようになりました。

必要な資格情報の収集

Stripe アカウントをExperience Platformに接続するには、次の認証情報の値を指定する必要があります。

API

Flow Service APIを使用してStripe アカウントを接続する場合は、次の資格情報を指定する必要があります。

table 0-row-2 1-row-2 2-row-2
資格情報	説明
`accessToken`	Stripe OAuth 2 リフレッシュコード認証トークン。
`connectionSpec.id`	Stripe ソースの接続仕様ID。このIDは次のように修正されています：`cc2c31d6-7b8c-4581-b49f-5c8698aa3ab3`。

Experience Platform ユーザーインターフェイスを使用してStripe アカウントを接続する場合は、次の資格情報を指定する必要があります。

table 0-row-2 1-row-2
資格情報	説明
アクセストークン	Stripe OAuth 2 リフレッシュコード認証トークン。

Stripe個のAPIの使用について詳しくは、Stripe API キーに関するドキュメントを参照してください。

Experience Data Model （XDM）スキーマの作成

Stripe ソースでは、次のリソースパスからのデータの取り込みがサポートされています。

課金
購読
返金
残高取引
顧客
価格

データセットを記述するには、XDM スキーマを作成する必要があります。このスキーマは、StripeからExperience Platformに送信されるフィールドとデータタイプを格納できます。

料金

Stripeでは、請求は、お金をStripeに移動しようとする試みを表します。特定のチャージ属性について詳しくは、Stripe チャージに関するAPI ガイドを参照してください。

accordion

選択して、Stripe料金オブジェクトを表示します

code language-json

{
  "id": "ch_3MmlLrLkdIwHu7ix0snN0B15",
  "object": "charge",
  "amount": 1099,
  "amount_captured": 1099,
  "amount_refunded": 0,
  "application": null,
  "application_fee": null,
  "application_fee_amount": null,
  "balance_transaction": "txn_3MmlLrLkdIwHu7ix0uke3Ezy",
  "billing_details": {
    "address": {
      "city": null,
      "country": null,
      "line1": null,
      "line2": null,
      "postal_code": null,
      "state": null
    },
    "email": null,
    "name": null,
    "phone": null
  },
  "calculated_statement_descriptor": "Stripe",
  "captured": true,
  "created": 1679090539,
  "currency": "usd",
  "customer": null,
  "description": null,
  "disputed": false,
  "failure_balance_transaction": null,
  "failure_code": null,
  "failure_message": null,
  "fraud_details": {},
  "invoice": null,
  "livemode": false,
  "metadata": {},
  "on_behalf_of": null,
  "outcome": {
    "network_status": "approved_by_network",
    "reason": null,
    "risk_level": "normal",
    "risk_score": 32,
    "seller_message": "Payment complete.",
    "type": "authorized"
  },
  "paid": true,
  "payment_intent": null,
  "payment_method": "card_1MmlLrLkdIwHu7ixIJwEWSNR",
  "payment_method_details": {
    "card": {
      "brand": "visa",
      "checks": {
        "address_line1_check": null,
        "address_postal_code_check": null,
        "cvc_check": null
      },
      "country": "US",
      "exp_month": 3,
      "exp_year": 2024,
      "fingerprint": "mToisGZ01V71BCos",
      "funding": "credit",
      "installments": null,
      "last4": "4242",
      "mandate": null,
      "network": "visa",
      "three_d_secure": null,
      "wallet": null
    },
    "type": "card"
  },
  "receipt_email": null,
  "receipt_number": null,
  "receipt_url": "https://pay.stripe.com/receipts/payment/CAcaFwoVYWNjdF8xTTJKVGtMa2RJd0h1N2l4KOvG06AGMgZfBXyr1aw6LBa9vaaSRWU96d8qBwz9z2J_CObiV_H2-e8RezSK_sw0KISesp4czsOUlVKY",
  "refunded": false,
  "review": null,
  "shipping": null,
  "source_transfer": null,
  "statement_descriptor": null,
  "statement_descriptor_suffix": null,
  "status": "succeeded",
  "transfer_data": null,
  "transfer_group": null
}

サブスクリプション

Stripeでは、サブスクリプションを使用して、顧客に定期的に請求できます。特定のサブスクリプション属性について詳しくは、Stripe サブスクリプションに関するAPI ガイドを参照してください。

accordion

選択して、Stripe Subscription オブジェクトを表示します

code language-json

{
  "id": "sub_1MowQVLkdIwHu7ixeRlqHVzs",
  "object": "subscription",
  "application": null,
  "application_fee_percent": null,
  "automatic_tax": {
    "enabled": false,
    "liability": null
  },
  "billing_cycle_anchor": 1679609767,
  "billing_thresholds": null,
  "cancel_at": null,
  "cancel_at_period_end": false,
  "canceled_at": null,
  "cancellation_details": {
    "comment": null,
    "feedback": null,
    "reason": null
  },
  "collection_method": "charge_automatically",
  "created": 1679609767,
  "currency": "usd",
  "current_period_end": 1682288167,
  "current_period_start": 1679609767,
  "customer": "cus_Na6dX7aXxi11N4",
  "days_until_due": null,
  "default_payment_method": null,
  "default_source": null,
  "default_tax_rates": [],
  "description": null,
  "discount": null,
  "ended_at": null,
  "invoice_settings": {
    "issuer": {
      "type": "self"
    }
  },
  "items": {
    "object": "list",
    "data": [
      {
        "id": "si_Na6dzxczY5fwHx",
        "object": "subscription_item",
        "billing_thresholds": null,
        "created": 1679609768,
        "metadata": {},
        "plan": {
          "id": "price_1MowQULkdIwHu7ixraBm864M",
          "object": "plan",
          "active": true,
          "aggregate_usage": null,
          "amount": 1000,
          "amount_decimal": "1000",
          "billing_scheme": "per_unit",
          "created": 1679609766,
          "currency": "usd",
          "interval": "month",
          "interval_count": 1,
          "livemode": false,
          "metadata": {},
          "nickname": null,
          "product": "prod_Na6dGcTsmU0I4R",
          "tiers_mode": null,
          "transform_usage": null,
          "trial_period_days": null,
          "usage_type": "licensed"
        },
        "price": {
          "id": "price_1MowQULkdIwHu7ixraBm864M",
          "object": "price",
          "active": true,
          "billing_scheme": "per_unit",
          "created": 1679609766,
          "currency": "usd",
          "custom_unit_amount": null,
          "livemode": false,
          "lookup_key": null,
          "metadata": {},
          "nickname": null,
          "product": "prod_Na6dGcTsmU0I4R",
          "recurring": {
            "aggregate_usage": null,
            "interval": "month",
            "interval_count": 1,
            "trial_period_days": null,
            "usage_type": "licensed"
          },
          "tax_behavior": "unspecified",
          "tiers_mode": null,
          "transform_quantity": null,
          "type": "recurring",
          "unit_amount": 1000,
          "unit_amount_decimal": "1000"
        },
        "quantity": 1,
        "subscription": "sub_1MowQVLkdIwHu7ixeRlqHVzs",
        "tax_rates": []
      }
    ],
    "has_more": false,
    "total_count": 1,
    "url": "/v1/subscription_items?subscription=sub_1MowQVLkdIwHu7ixeRlqHVzs"
  },
  "latest_invoice": "in_1MowQWLkdIwHu7ixuzkSPfKd",
  "livemode": false,
  "metadata": {},
  "next_pending_invoice_item_invoice": null,
  "on_behalf_of": null,
  "pause_collection": null,
  "payment_settings": {
    "payment_method_options": null,
    "payment_method_types": null,
    "save_default_payment_method": "off"
  },
  "pending_invoice_item_interval": null,
  "pending_setup_intent": null,
  "pending_update": null,
  "quantity": 1,
  "schedule": null,
  "start_date": 1679609767,
  "status": "active",
  "test_clock": null,
  "transfer_data": null,
  "trial_end": null,
  "trial_settings": {
    "end_behavior": {
      "missing_payment_method": "create_invoice"
    }
  },
  "trial_start": null
}

返金

Stripeでは、払い戻しを使用して、以前に作成した料金を返金できます。特定の払い戻し属性について詳しくは、Stripe 払い戻しに関するAPI ガイドを参照してください。

accordion

選択すると、Stripeの返金オブジェクトが表示されます

code language-json

{
  "id": "re_1Nispe2eZvKYlo2Cd31jOCgZ",
  "object": "refund",
  "amount": 1000,
  "balance_transaction": "txn_1Nispe2eZvKYlo2CYezqFhEx",
  "charge": "ch_1NirD82eZvKYlo2CIvbtLWuY",
  "created": 1692942318,
  "currency": "usd",
  "destination_details": {
    "card": {
      "reference": "123456789012",
      "reference_status": "available",
      "reference_type": "acquirer_reference_number",
      "type": "refund"
    },
    "type": "card"
  },
  "metadata": {},
  "payment_intent": "pi_1GszsK2eZvKYlo2CfhZyoZLp",
  "reason": null,
  "receipt_number": null,
  "source_transfer_reversal": null,
  "status": "succeeded",
  "transfer_reversal": null
}

トランザクションの残高

Stripeでは、残高トランザクションは、Stripe アカウント間の資金の移動を表します。特定のバランストランザクション属性について詳しくは、Stripe バランストランザクションに関するAPI ガイドを参照してください。

accordion

Stripe Balance Transaction オブジェクトを表示するには、これを選択します

code language-json

{
  "id": "txn_1MiN3gLkdIwHu7ixxapQrznl",
  "object": "balance_transaction",
  "amount": -400,
  "available_on": 1678043844,
  "created": 1678043844,
  "currency": "usd",
  "description": null,
  "exchange_rate": null,
  "fee": 0,
  "fee_details": [],
  "net": -400,
  "reporting_category": "transfer",
  "source": "tr_1MiN3gLkdIwHu7ixNCZvFdgA",
  "status": "available",
  "type": "transfer"
}

お客様

Stripeでは、お客様はお客様のビジネスの特定のお客様を表します。特定の顧客属性について詳しくは、Stripe 顧客に関するAPI ガイドを参照してください。

accordion

選択すると、Stripe Customer オブジェクトが表示されます

code language-json

{
  "id": "cus_NffrFeUfNV2Hib",
  "object": "customer",
  "address": null,
  "balance": 0,
  "created": 1680893993,
  "currency": null,
  "default_source": null,
  "delinquent": false,
  "description": null,
  "discount": null,
  "email": "jennyrosen@example.com",
  "invoice_prefix": "0759376C",
  "invoice_settings": {
    "custom_fields": null,
    "default_payment_method": null,
    "footer": null,
    "rendering_options": null
  },
  "livemode": false,
  "metadata": {},
  "name": "Jenny Rosen",
  "next_invoice_sequence": 1,
  "phone": null,
  "preferred_locales": [],
  "shipping": null,
  "tax_exempt": "none",
  "test_clock": null
}

価格

Stripeでは、価格は、製品の定期的な購入と1回限りの購入の両方の単価、通貨、およびオプションの請求サイクルを表します。特定の価格属性について詳しくは、Stripe API価格ガイドを参照してください。

accordion

選択すると、Stripe Price オブジェクトが表示されます

code language-json

{
  "id": "price_1MoBy5LkdIwHu7ixZhnattbh",
  "object": "price",
  "active": true,
  "billing_scheme": "per_unit",
  "created": 1679431181,
  "currency": "usd",
  "custom_unit_amount": null,
  "livemode": false,
  "lookup_key": null,
  "metadata": {},
  "nickname": null,
  "product": "prod_NZKdYqrwEYx6iK",
  "recurring": {
    "aggregate_usage": null,
    "interval": "month",
    "interval_count": 1,
    "trial_period_days": null,
    "usage_type": "licensed"
  },
  "tax_behavior": "unspecified",
  "tiers_mode": null,
  "transform_quantity": null,
  "type": "recurring",
  "unit_amount": 1000,
  "unit_amount_decimal": "1000"
}

IP アドレスの許可リスト

ソースをExperience Platformに接続する前に、リージョン固有のIP アドレスをードに追加する必要があります。詳しくは、Experience PlatformへのIP アドレスの許可リストに加えるに関するガイドを参照してください。

Experience Platformの権限の設定

Stripe アカウントをExperience Platformに接続するには、ソースの表示と ソースの管理 の両方の権限をアカウントに対して有効にする必要があります。必要な権限を取得するには、製品の管理者にお問い合わせください。詳しくは、アクセス制御UI ガイドを参照してください。

次の手順

前提条件の設定が完了したら、続行してStripe データをExperience Platformに接続して取り込むことができます。 APIまたはユーザーインターフェイスを使用してStripe支払いデータをExperience Platformに取り込む方法については、次のガイドを参照してください。

Flow Service APIを使用して、Stripe アカウントからExperience Platformに支払いデータを取り込みます。
ユーザーインターフェイスを使用して、Stripe アカウントからExperience Platformに支払いデータを取り込みます。

recommendation-more-help

experience-platform-help-sources