支払い項目

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

支払いラインアイテムは、カードと国内主要決済手段処理にメリットをもたらす Payment Intents API の機能です。

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

機能の制限

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

	カード L2/L3 プログラム	Klarna	PayPal
各地域での提供状況	アメリカ国内取引 (アメリカで発行されたカードを受け付けるアメリカのユーザー、アメリカの領土を除く)、および EU 域内の取引 (EU のカードを受け付ける EU の企業) でサポートされています。	Klarna はグローバルな決済手段です。ビジネスの場所のサポートについては、Klarna 決済をご覧ください。	すべての地域の顧客が利用できます。ビジネスの場所のサポートについては、PayPal 決済をご覧ください。
カードネットワーク	Visa、Mastercard、アメリカン・エキスプレスでのみ対応しています (コストを削減するには、アメリカン・エキスプレスとの直接契約が必要)	該当しない	該当しない
項目数	現在、200 のライン項目をサポートしています。(アメリカンExpressの仕様では、最初の 4 つのライン項目のみを送信するように制限されています)。	カードと同様	カードと同様
機能の互換性	自動キャプチャーと手動キャプチャーのどちらのモードも、支払い項目に対して機能します。部分オーソリと減分オーソリを除く柔軟な決済シナリオは、項目を渡す決済の決済明細項目で機能します。	自動キャプチャーと手動キャプチャーのどちらのモードも、支払い項目に対して機能します。	自動キャプチャーと手動キャプチャーのどちらのモードも、支払い項目に対して機能します。
業種固有のメタデータ	業界固有のメタデータ (レンタカー / 宿泊施設、航空会社など) と一緒に項目を送信することはできません	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 / 商品 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 / 商品 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/商品 3 の税率には必要ありません。売上税が徴収されず、正確な値を報告する必要がある場合は、0 を使用できます。

L2 または L3 レートを受け取るには、以下のフィールドが必要です。

カード L2 または L3 レートの対象	レベル 2	レベル 3 / 商品 3
最小フィールド要件	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_item[unit_of_measure] payment_details[order_reference]

フィールドの要件

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

「必須フィールド」は、ライン項目データが入力されている場合に Stripe の検証に合格するためのフィールドが必須であることを示します。「L2 または L3 に必須」は、ネットワーク L2/L3 レートを受信するためのフィールドが必須であることを示します。

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

フィールド名	タイプ	説明	形式
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_item[unit_of_measure]	文字列	ライン項目の測定単位。ガロン、フィート、メートル、一般的な測定値 (それぞれなど)など。	L3 に必須最大 12 文字英数字
payment_details[order_reference]	文字列	取引を識別するために事業者が割り当てた一意の値。	L3 に必須 L2 に必須カードネットワークの場合: スペースを除く英数字 25 文字に切り捨てられます Klarna の場合: 255 文字に切り詰められ、Klarna アプリで注文を表示する際に顧客に表示されます
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_item[tax][total_tax_amount] は相互排他的です。どちらか一方のみを指定できます。

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

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

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

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

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

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

フィールド名	タイプ	説明	形式
line_item[payment_method_options][klarna][product_url]	文字列	商品の有効な http または https の URL	最大 4096 文字。
line_item[payment_method_options][klarna][image_url]	文字列	画像の有効な http または https の URL	最大 4096 文字。
amount_details[line_items][0][payment_method_options][klarna][reference]	文字列	この項目の一意の参照。システムの内部レコードと関連付けます。このフィールドは、渡されると Klarna Consumer App に表示されます。	最大 255 文字。
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_item[payment_method_options][paypal][description]	文字列	ラインアイテムの説明。	最大 127 文字
line_item[payment_method_options][paypal][category]	列挙型	ラインアイテムのタイプ。	digital_goods, physical_goods, donation
line_item[payment_method_options][paypal][sold_by]	文字列	商品を販売する連結アカウントの Stripe アカウント ID。連結アカウント以外の場合は空白のままにします。	最大 127 文字

L2 および L3 レートのカード固有の項目

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

レベル 2: 取引に課される売上税
レベル 3 / 商品 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"
    }
  }
  ...
}

数値計算のルールを緩和

デフォルトでは、Stripe が明細項目データの合計が正しく計算されているかを検証します。明細項目の合計が請求額と一致しない場合、Stripe は 400 エラーを返します。これにより、お客様は支払いが処理される前にその不一致を修正できます。

enforce_arithmetic_validation を false に設定することで、リクエスト単位の厳密な検証を解除することができます。実行すると下記のような影響があります。

明細項目の合計額が請求額と一致しない場合でも、リクエストは続行されます。
Stripe はレスポンスの amount_details.error フィールドに検証エラーの詳細を返します。
カード決済の場合、Stripe は、算術エラーのある明細項目のデータをカードネットワークに送信しません。そのため、取引が L2/L3 インターチェンジ割引の対象になりません。

サンプルリクエスト

以下は、演算検証が実行されない場合のリクエストのサンプルです。

サンプルレスポンス

以下は、演算検証が実行されない場合のレスポンスのサンプルです。

{
  "id": "pi_3Spjgy2QCQbYXizB0HMvTu0w",
  "object": "payment_intent",
  "amount": 5000,
  "amount_details": {
    "error": {
      "code": "amount_details_amount_mismatch",
      "message": "The total value of `amount_details` (4500) does not match the `amount` (5000). Make sure that the total value of `line_items` matches the amount to charge, taking into account any discounts, tax, and shipping. See https://docs.stripe.com/payments/payment-line-items"
    },
    "line_items": {
      "object": "list",
      "data": [
        {
          "id": "uli_TnKLbGmvsdUYdN",
          "object": "payment_intent_amount_details_line_item",
          "discount_amount": null,
          "payment_method_options": null,
          "product_code": "SKU001",
          "product_name": "Product 001",
          "quantity": 2,
          "tax": null,
          "unit_cost": 2000,
          "unit_of_measure": null
        }
      ],
      "has_more": false,
      "url": "/v1/payment_intents/pi_3Spjgy2QCQbYXizB0HMvTu0w/amount_details_line_items"
    },
    "tax": {
      "total_tax_amount": 500
    },
    "tip": {}
  },
  "status": "requires_payment_method"
}

業種から 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: 短大、大学

柔軟な支払いシナリオ

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