支払い項目
サポートされている決済手段タイプ間で追加の取引メタデータを送信して、コスト削減、支払いの照合の効率化、オーソリ成功率の向上を実現します。 支払い項目は、カード決済および地域の決済手段の処理に役立つ Payment Intents API の一機能です。
IC+ ユーザー 向けの対象となる商用カードのコスト削減: 決済ラインアイテムを渡すことで、主要なカードネットワークが管理するレベル 2 / レベル 3 / 商品 3 (L2/L3) プログラムに参加できます。対象となる商用カードの場合、項目データを渡すことでインターチェンジフィーを節約できます。照合の円滑化: 項目データを渡すことで、顧客の照合がスムーズになります。たとえば、政府機関の顧客が主なサービス提供先である場合、顧客は購入内容と明細書に記載されている内容を照合しやすくなります。オーソリ成功率の向上: Klarna や PayPal などの決済手段は、リスク評価モデルで項目データを使用するため、項目データが渡されたときに承認できるクレジットベースの支払いオプションが多くなる可能性があります。機能の制限 支払い項目には、サポートされている決済手段タイプによって以下の制限が適用されます。
カード L2/L3 プログラム Klarna PayPal 各地域での提供状況 アメリカ国内取引(アメリカ領土を除く、アメリカ発行カードを受け付けるアメリカのユーザー)でのみサポートされます。 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、4112Visa の場合: 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、5983Visa の場合: 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 以上の値である必要があります 条件付き検証 1 line_item[product_code] 文字列 SKU など、項目の商品コード。 line_item[unit_of_measure] 文字列 ライン項目の測定単位。ガロン、フィート、メートル、一般的な測定値 (それぞれなど)など。 payment_details[order_reference] 文字列 取引を識別するために事業者が割り当てた一意の値。 L3 に必須 L2 に必須 カードネットワークの場合: スペースを除く英数字 25 文字に切り捨てられます Klarna の場合: 255 文字に切り詰められ、Klarna アプリで注文を表示する際に顧客に表示されます tax[total_tax_amount] 整数 取引に対する合計税額は最小通貨単位 で表されます。 L2 に必須 0 以上の値である必要があります 条件付き検証 1 payment_details[customer_reference] 文字列 顧客を識別するための一意の値。このフィールドは、カード支払いでのみ使用できます。 この文字列は、スペースを除く 25 文字の英数字のみがカードネットワークに送信されます。 shipping[to_postal_code] 文字列 物品を配送する場合、配送先の郵便番号。 shipping[from_postal_code] 文字列 物品を配送する場合、発送元の郵便番号。 shipping[amount] 整数 物品を配送する場合、配送料は最小通貨単位 で表されます。 discount_amount 整数 取引に適用される割引合計は最小通貨単位 で表されます。 0 より大きい値でなければなりません 条件付き検証 2 line_item[discount_amount] 整数 この項目に適用される割引は最小通貨単位 で表されます。 0 より大きい値でなければなりません 条件付き検証 2
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 データ) curl https://api.stripe.com/v1/payment_intents \
-u "sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
-d amount = 4600 \
-d currency = usd \
-d "payment_method_types[]" = card \
-d "payment_details[customer_reference]" = customer_reference \
-d "payment_details[order_reference]" = order_reference \
-d "amount_details[tax][total_tax_amount]" = 500 サンプルレスポンス (レベル 2 データ) {
"id" : "pi_3OoMm5BLxXjrKOiR3LRyi610" ,
"amount" : 4600 ,
"currency" : "usd"
"amount_details" : {
"tax" : {
"total_tax_amount" : 500
} ,
} ,
"status" : "requires_payment_method"
}
PaymentIntent の操作 確定とキャプチャーの両方で項目を渡すことができます。
確定時に項目を設定する 選択した capture_method に関係なく、確定時に項目を設定できます。確定時に項目を渡し、個別にキャプチャーする場合、項目を再度渡す必要はありません。
curl https://api.stripe.com/v1/payment_intents \
-u "sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
-d amount = 4100 \
-d currency = usd \
-d "payment_method_types[0]" = card \
-d payment_method = pm_card_visa \
-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][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 \
-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 \
-d confirm = true キャプチャー時に項目を設定する 確認時に項目を指定しない場合は、キャプチャー時に渡すことができます。
curl https://api.stripe.com/v1/payment_intents \
-u "sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
-d amount = 4100 \
-d currency = usd \
-d "payment_method_types[0]" = card \
-d "payment_method_types[1]" = paypal \
-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][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 \
-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 \
-d confirm = true \
-d capture_method = manual 必要に応じて、キャプチャー中に更新された amount_ details ハッシュを渡します。
curl -X POST https://api.stripe.com/v1/payment_intents/pi_xxxxxxxx/capture \
-u "sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" 決済手段固有の項目 ラインアイテムごとに追加の決済手段タイプをすべて 1 か所で渡します。パラメーターがサポートされている限り、未確認の決済手段に関連するデータも渡すことができます。これにより、各決済手段の固有フィールドを追加 / 削除するエンジニアリング作業を伴うことなく、システムを簡素化できます。
メモ デフォルトでは、ラインアイテムは API レスポンスに含まれません。ラインアイテムを返すには、amount_ details. line_ items を拡張 します。
サンプルリクエスト (決済手段固有の項目あり) 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 を渡す方法を示しています。
サンプルリクエスト (最上位の割引または税金) curl https://api.stripe.com/v1/payment_intents \
-u "sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
-d amount = 2500 \
-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[discount_amount]" = 100 \
-d "amount_details[tax][total_tax_amount]" = 500 \
-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][quantity]" = 1 \
-d "amount_details[line_items][0][unit_cost]" = 2000 \
- -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 "expand[0]" = "amount_details.line_items" サンプルレスポンス (最上位の割引または税金) {
"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 : 短大、大学
柔軟な支払いシナリオ 決済項目は、マルチキャプチャーやオーバーキャプチャーなどの複雑な決済 で使用できます。