支払い項目公開プレビュー

サポートされている決済手段タイプ間で追加の取引メタデータを送信して、コスト削減、支払いの照合の効率化、オーソリ成功率の向上を実現します。

プレビューヘッダーで利用可能

API リクエストにバージョンヘッダ 2025-04-30.preview 以降を含めることで、このパブリックプレビュー機能を利用できます。

支払い項目は、カード決済および地域の決済手段の処理に役立つ Payment Intents API の一機能です。

IC+ ユーザー: 支払い項目を渡すことで、主要なカードネットワークが運営する Level 2/Level 3 (L2/L3) プログラムに加入できます。対象法人カードの場合、項目データを渡すことでインターチェンジフィーを節約できます。
照合の円滑化: 項目データを渡すことで、顧客の照合がスムーズになります。たとえば、政府機関の顧客が主なサービス提供先である場合、顧客は購入内容と明細書に記載されている内容を照合しやすくなります。
オーソリ成功率の向上: Klarna や PayPal などの決済手段は、リスク評価モデルで項目データを使用するため、項目データが渡されたときに承認できるクレジットベースの支払いオプションが多くなる可能性があります。

機能の制限

支払い項目には、サポートされている決済手段タイプによって以下の制限が適用されます。

	カード L2/L3 プログラム	Klarna	PayPal
各地域での提供状況	アメリカ国内取引(アメリカ領土を除く、アメリカ発行カードを受け付けるアメリカのユーザー)でのみサポートされます。	Klarna はグローバルな決済手段です。ビジネスの場所のサポートについては、Klarna 決済をご覧ください。	すべての地域の顧客が利用できます。ビジネスの場所のサポートについては、PayPal 決済をご覧ください。
カードネットワーク	Visa、Mastercard、アメリカン・エキスプレスでのみ対応しています (コストを削減するには、アメリカン・エキスプレスとの直接契約が必要)	該当しない	該当しない
項目数	現在、200 のライン項目をサポートしています。(アメリカンExpressの仕様では、最初の 4 つのライン項目のみを送信するように制限されています)。	カードと同様	カードと同様
機能の互換性	自動キャプチャーと手動キャプチャーのどちらのモードも、支払い項目に対して機能します。 Multicapture and overcapture also work with payment line items. However, you can’t use other flexible payment scenarios or decrement authorization for payments where you’re passing in line items.	自動キャプチャーと手動キャプチャーのどちらのモードも、支払い項目に対して機能します。	自動キャプチャーと手動キャプチャーのどちらのモードも、支払い項目に対して機能します。
業種固有のメタデータ	業界固有のメタデータ (レンタカー / 宿泊施設、航空会社など) と一緒に項目を送信することはできません	Klarna は、追加の加盟店データ (非公開ベータ) を持つ業界固有のメタデータをサポートしています。	カードと同様
表面	PaymentIntents API を使用した支払いで利用できます。	カードと同様	カードと同様

カードの L2 / L3 レートの対象資格

Visa CEDP プログラム

To learn more about Visa’s Commercial Enhanced Data Program (CEDP), which replaces their U.S. Level 2/3 interchange programs, including information about its network fees, see the CEDP Support article.

貴社が該当する MCC を確認するには、業種から MCC コードへをご覧ください。

Stripe API は、ネットワークの MCC や税金の要件を満たしていない項目を拒否しませんが、これらの取引は対応するレベル 2/3 の割引の対象外になります。

カードの L2 / L3 レートの対象資格	レベル 2	レベル 3
カードタイプ	ビジネスカード、パーチェシングカード、コーポレートカードのみが対象です	パーチェシングカードとコーポレートカードのみが対象です
MCC	次の MCC に該当するユーザーは、レベル 2 の対象にはなりません。 Mastercard の場合: 5812、3501 ～ 3999、7011、3351 ～ 3500、7512、7513、7519、3000 ～ 3299、4511、4112 Visaの場合: 5812、5814、3501 ～ 4010、3351 ～ 3500、7512、7513、3000 ～ 3299、4511、4411、4112、4722、5962、5966、5967	次の MCC に該当するユーザーは、レベル 3 の対象にはなりません。 Mastercard の場合: 5812、3501 ～ 3999、7011、3351 ～ 3500、7512、7513、7519、3000 ～ 3299、4511、4112、8398、4468、5499、5541、5542、5983 Visaの場合: 5812、5814、3501 ～ 4010、3351 ～ 3500、7512、7513、3000 ～ 3299、4511、4411、4112、4722、5962、5966、5967
売上税の要件	Mastercard について : 消費税は 0.1%~30% です。ただし、事業が 4468、5541、5542、5499、5983、7511、9752、4111、4131、4215、4784、8211、8220、8398、8661、9211、9222、9311、9399、9402 のいずれかの MCC を使用している場合は除きます。 Visa について : 事業が 4468、5499、5541、5542、5983 のいずれかの MCC を使用しない限り、消費税は 0.1%~22% である必要があります。	レベル 3 の税率には必要ありません。消費税が徴収されず、正確な値を報告する必要がある場合は、0 を使用できます。
最小フィールド要件	tax[total_tax_amount] payment_details[order_reference]	line_item[product_name] line_item[unit_cost] line_item[quantity] line_item[tax][total_tax_amount] line_item[product_code] line_items[unit_of_measure] payment_details[order_reference]

フィールドの要件

以下で説明されているフィールドはすべて、amount_details パラメーターまたは payment_details パラメーター内で渡されます。データの受け渡しについては、サンプルリクエスト (レベル 2 データ) を参照してください。

サポートされている標準フィールド

フィールド名	タイプ	説明	形式
line_item[product_name]	文字列	ラインアイテムの商品名。	必須フィールド L3 に必須最大 1024 文字 (カードは 26 文字、PayPal は 127 文字まで切り捨てられます)
line_item[unit_cost]	整数	項目の単価は最小通貨単位で表されます。	必須フィールド L3 に必須 0 以上の値である必要があります
line_item[quantity]	整数	アイテムの数量。	必須フィールド L3 に必須 0 より大きい値でなければなりません
line_item[tax][total_tax_amount]	整数	1 項目に対する合計税額は最小通貨単位で表されます。	L3 に必須 0 以上の値である必要があります条件付き検証 ¹
line_item[product_code]	文字列	SKU など、項目の商品コード。	L3 に必須最大 12 文字
line_items[unit_of_measure]	文字列	ライン項目の測定単位。ガロン、フィート、メートル、一般的な測定値 (それぞれなど)など。	L3 に必須最大 12 文字英数字
payment_details[order_reference]	文字列	取引を識別するために事業者が割り当てた一意の値。	条件付き必須 ³ L3 に必須 L2 に必須この文字列は、スペースを除く 25 文字の英数字のみがカードネットワークに送信されます。
tax[total_tax_amount]	整数	取引に対する合計税額は最小通貨単位で表されます。	L2 に必須 0 以上の値である必要があります条件付き検証 ¹
payment_details[customer_reference]	文字列	顧客を識別するための一意の値。このフィールドは、カード支払いでのみ使用できます。	この文字列は、スペースを除く 25 文字の英数字のみがカードネットワークに送信されます。
shipping[to_postal_code]	文字列	物品を配送する場合、配送先の郵便番号。	最大 10 文字英数字
shipping[from_postal_code]	文字列	物品を配送する場合、発送元の郵便番号。	最大 10 文字英数字
shipping[amount]	整数	物品を配送する場合、配送料は最小通貨単位で表されます。	0 以上の値である必要があります
discount_amount	整数	取引に適用される割引合計は最小通貨単位で表されます。	0 より大きい値でなければなりません条件付き検証 ²
line_item[discount_amount]	整数	この項目に適用される割引は最小通貨単位で表されます。	0 より大きい値でなければなりません条件付き検証 ²

¹ tax[total_tax_amount] と line_items[tax][total_tax_amount] は相互排他的です。どちらか一方のみを指定できます。

² discount_amount と line_items[discount_amount] は相互排他的です。どちらか一方のみを指定できます。

³ automatic_payment_methods.enabled が true に設定されている場合など、支払い方法タイプの配列に card が含まれている場合は、フィールド payment_details[order_reference] が必要になります。

Cards がサポートするその他のフィールド

Cards は、上記の一般フィールドをサポートしており、以下もサポートしています。

フィールド名	タイプ	説明	形式
line_items[payment_method_options][card][commodity_code]	文字列	UNSPSC、NAICS、NAPCS などの標準化された商品スキームを使用して購入される商品を分類する ID。	最大長は 12 文字です。値は、スペースを含まない英数字でなければなりません。

Klarna がサポートするその他のフィールド

Klarna は、上記の一般フィールドをサポートしており、以下もサポートしています。

フィールド名	タイプ	説明	形式
line_items[payment_method_options][klarna][product_url]	文字列	商品の有効な http または https の URL	最大長は 4,096 文字です。大まかな正規表現: `https?:\/\/[-a-zA-Z0-9@:%._\+~#=]{1,256}\.[a-zA-Z0-9()]{1,64}\b([-a-zA-Z0-9()!@:%_\+.~#?&\/\/=]*)`
line_items[payment_method_options][klarna][image_url]	文字列	画像の有効な http または https の URL	最大長は 4,096 文字です。大まかな正規表現: `https?:\/\/[-a-zA-Z0-9@:%._\+~#=]{1,256}\.[a-zA-Z0-9()]{1,64}\b([-a-zA-Z0-9()!@:%_\+.~#?&\/\/=]*)`
amount_details[line_items][0][payment_method_options][klarna][subscription_reference]	文字列	サブスクリプションを説明するために選択した任意の識別子。一部の Klarna 継続導入で使用されます。これは顧客には表示されません。	最大 255 文字。特別な正規表現はありません。

注

Klarna 取引の場合、合計金額は (unit_cost * quantity) - discount_amount + tax.total_tax_amount という式から暗黙的に算出されます。金額を渡すための明示的なフィールドはありません。

PayPal がサポートするその他のフィールド

PayPal は、上記の一般フィールドをサポートしており、以下もサポートしています。

フィールド名	タイプ	説明	形式
line_items[payment_method_options][paypal][description]	文字列	ラインアイテムの説明。	最大 127 文字
line_items[payment_method_options][paypal][category]	列挙型	ラインアイテムのタイプ。	digital_goods, physical_goods, donation
line_items[payment_method_options][paypal][sold_by]	文字列	アイテムを販売する連結アカウントの Stripe アカウント ID。連結アカウントでない場合は、空欄のままにします。	最大 127 文字

L2 / L3 レートのカード固有の項目

対象となるカードが L2/L3 ネットワークプログラムの要件を満たすために必要なデータを渡す

レベル 2: 取引に課される売上税
レベル 3: 商品コード、数量、単価などの項目レベルの内訳

サンプルリクエスト (レベル 2 データ)

サンプルレスポンス (レベル 2 データ)

{
  "id": "pi_3OoMm5BLxXjrKOiR3LRyi610",
  "amount": 4600,
  "currency": "usd"
  "amount_details": {
    "tax": {
      "total_tax_amount": 500
    },
  },
  "status": "requires_payment_method"
}

PaymentIntent の操作

確定とキャプチャーの両方で項目を渡すことができます。

確定時に項目を設定する

選択した capture_method に関係なく、確定時に項目を設定できます。確定時に項目を渡し、個別にキャプチャーする場合、項目を再度渡す必要はありません。

キャプチャー時に項目を設定する

確認時に項目を指定しない場合は、キャプチャー時に渡すことができます。

注

PayPal を使用する場合はサポート対象外

必要に応じて、キャプチャー中に更新された amount_details ハッシュを渡します。

決済手段固有の項目

ラインアイテムごとに追加の決済手段タイプをすべて 1 か所で渡します。パラメーターがサポートされている限り、未確認の決済手段に関連するデータも渡すことができます。これにより、各決済手段の固有フィールドを追加 / 削除するエンジニアリング作業を伴うことなく、システムを簡素化できます。

注

デフォルトでは、ラインアイテムは API レスポンスに含まれません。ラインアイテムを返すには、amount_details.line_items を拡張します。

サンプルリクエスト (決済手段固有の項目あり)

Command Line
言語を選択cURL
 No results
curl https://api.stripe.com/v1/payment_intents \
  -u "sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=4000 \
  -d currency=usd \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=paypal \
  -d "payment_method_types[2]"=klarna \
  -d "payment_details[customer_reference]"=customer_reference \
  -d "payment_details[order_reference]"=order_reference \
  -d "amount_details[shipping][from_postal_code]"=94110 \
  -d "amount_details[shipping][to_postal_code]"=94117 \
  -d "amount_details[shipping][amount]"=100 \
  -d "amount_details[line_items][0][product_code]"=SKU001 \
  -d "amount_details[line_items][0][product_name]"="Product 001" \
  -d "amount_details[line_items][0][unit_cost]"=2000 \
  -d "amount_details[line_items][0][discount_amount]"=100 \
  -d "amount_details[line_items][0][quantity]"=1 \
  -d "amount_details[line_items][0][tax][total_tax_amount]"=100 \
  -d "amount_details[line_items][0][unit_of_measure]"=feet \
  -d "amount_details[line_items][0][payment_method_options][card][commodity_code]"=123123 \
  --data-urlencode "amount_details[line_items][0][payment_method_options][klarna][image_url]"="https://www.example.com/image.jpg" \
  --data-urlencode "amount_details[line_items][0][payment_method_options][klarna][product_url]"="https://www.example.com/product" \
  -d "amount_details[line_items][0][payment_method_options][paypal][description]"="This is a sample product description unique to PayPal for SKU001" \
  -d "amount_details[line_items][0][payment_method_options][paypal][category]"=digital_goods \
  -d "amount_details[line_items][1][product_code]"=SKU002 \
  -d "amount_details[line_items][1][product_name]"="Product 002" \
  -d "amount_details[line_items][1][unit_cost]"=1800 \
  -d "amount_details[line_items][1][quantity]"=1 \
  -d "amount_details[line_items][1][tax][total_tax_amount]"=100 \
  -d "amount_details[line_items][1][unit_of_measure]"=gallons \
  -d "amount_details[line_items][1][payment_method_options][card][commodity_code]"=123123 \
  --data-urlencode "amount_details[line_items][1][payment_method_options][klarna][image_url]"="https://www.example.com/image.jpg" \
  --data-urlencode "amount_details[line_items][1][payment_method_options][klarna][product_url]"="https://www.example.com/product" \
  -d "amount_details[line_items][1][payment_method_options][paypal][description]"="This is a sample product description unique to PayPal for SKU002" \
  -d "amount_details[line_items][1][payment_method_options][paypal][category]"=physical_goods \
  -d "expand[0]"="amount_details.line_items"

サンプルレスポンス (決済手段固有の項目付き)

{
  "id": "pi_3OoMm5BLxXjrKOiR3LRyi610",
  "amount": 4000,
  "currency": "usd"
  "amount_details": {
    "shipping": {
      "from_postal_code": "94110",
      "to_postal_code": "94117",
      "amount": 100
    },
    "line_items": {
      "object": "list",
      "url": "/v1/payment_intents/pi_3OoMm5BLxXjrKOiR3LRyi610/amount_details_line_items",
      "has_more": false,
      "data": [{
          "_id": "li_123",
          "product_code": "SKU001",
          "product_name": "Product 001",
          "unit_cost": 2000,
          "quantity": 1,
          "discount_amount": 100,
          "tax": {
            "total_tax_amount": 100
          },
          "unit_of_measure": "feet",
          "payment_method_options": {
            "card": {
              "commodity_code": "123123",
            },
            "klarna": {
              "image_url": "https://www.example.com/image.jpg",
              "product_url": "https://www.example.com/product"
            },
            "paypal": {
              "description": "This is a sample product description unique to PayPal for SKU001",
              "category": digital_goods,
            }
          }
        },
        {
          "_id": "li_456",
          "product_code": "SKU002",
          "product_name": "Product 002",
          "unit_cost": 1800,
          "quantity": 1,
          "tax": {
            "total_tax_amount": 100
          },
          "unit_of_measure": "gallons",
          "payment_method_options": {
            "card": {
              "commodity_code": "123123",
            },
            "klarna": {
              "image_url": "https://www.example.com/image.jpg",
              "product_url": "https://www.example.com/product"
            },
            "paypal": {
              "description": "This is a sample product description unique to PayPal for SKU001",
              "category": physical_goods,
            }
          }
        }
      ]
    }
  },
  "status": "requires_payment_method"
}

最上位の割引または税金を使用

次の例は、項目レベル tax と discount_amount なしで最上位の discount_amount と tax を渡す方法を示しています。

サンプルリクエスト (最上位の割引または税金)

サンプルレスポンス (最上位の割引または税金)

{
  "id": "pi_3R0p2JCvDOElLqwO0mlHFrzv",
  "amount": 2500,
  "amount_capturable": 0,
  "amount_received": 2500,
  "payment_details": {
    "customer_reference": "customer_reference",
    "order_reference": "order_reference"
  },
  "amount_details": {
    "discount_amount": 100,
    "shipping": {
      "amount": 100,
      "from_postal_code": "94110",
      "to_postal_code": "94117"
    },
    "tax": {
      "total_tax_amount": 500
    },
    "line_items": {
      "object": "list",
      "data": [
        {
          "id": "uli_RueKif6jOR65uG",
          "object": "amount_details_line_item",
          "discount_amount": null,
          "payment_method_options": {
            "klarna": {
              "image_url": "https://www.example.com/image.jpg",
              "product_url": "https://www.example.com/product"
            },
            "paypal": {
              "category": "digital_goods",
              "description": "This is a sample product description unique to PayPal for SKU001"
            }
          },
          "product_code": "SKU001",
          "product_name": "Product 001",
          "quantity": 1,
          "tax": null,
          "unit_cost": 2000
        }
      ],
      "has_more": false,
      "url": "/v1/payment_intents/pi_3R0p2JCvDOElLqwO0mlHFrzv/amount_details_line_items"
    }
  }
  ...
}

業種から MCC コードへ

カテゴリー	説明
飲食	5812: レストラン (ファストフード以外) 5814: ファストフード店
接客サービス業と旅行	3000 ～ 3299: 航空会社 3501 ～ 3999、7011: ホテルおよび宿泊施設 3351 ～ 3500: レンタカー会社 4722: 旅行代理店、ツアーオペレーター 7512: 自動車レンタル代理店 7513: トラックのレンタルおよびリース 7519: キャンピングカーおよび RV 車のレンタル 4411: クルーズ船運行 4112: 旅客鉄道 4111: 地方および郊外の通勤用旅客輸送 4215: 貨物宅配サービス 4784: 有料道路通行料、渡橋料 4468: マリーナ、海洋サービス 5983: 燃料販売店
小売および E コマース	5962: ダイレクトマーケティング - 旅行 5966: ダイレクトマーケティング - 電話による販売 5967: ダイレクトマーケティング - その他
公共料金、その他	8398: 慈善団体および社会福祉サービス団体 9752: イギリスのガソリンスタンド、電子ホットファイル 9211: 裁判費用 (慰謝料と養育費を含む) 9311: 納税 9222: 罰金 9402: 郵便サービス - 政府のみ、およびその他の類似サービス 9399: 行政サービス (他のいずれにも該当しない場合) とその他の類似サービス 8661: 宗教団体 8211: 学校、教育機関 8220: 短大、大学

柔軟な支払いシナリオ

決済項目は、マルチキャプチャーやオーバーキャプチャーなどの複雑な決済で使用できます。