業種メタデータ公開プレビュー
旅行およびエンターテインメントの購入に固有のデータを提供する方法をご紹介します。
プレビューヘッダーで利用可能
API リクエストにバージョンヘッダー 2025-11-17. またはそれ以降のプレビューバージョンヘッダーを含めることで、このパブリックプレビュー機能を使用できます。
業種メタデータは、Payment Intents API の機能です。この機能を使用すると、サポート対象の旅行業界およびエンターテインメント業界の取引に特化した必須情報を提供できます。
業種固有のデータは、特定の加盟店カテゴリーコードがクレジットカードネットワーク要件に準拠するために提供する必要があり、Klarna 取引のオーソリ率とリスク評価が向上する可能性があります。
レンタカー、宿泊施設、旅行代理店、航空会社コードなど、ビジネスが特定の旅行およびエンターテインメント加盟店カテゴリーコード (MCC) で運営されている場合は、提供状況に記載されているカード決済の業種メタデータを実装します。
提供状況
業種固有のデータの提供は、Payment Intents のユーザーのみが利用でき、以下の加盟店カテゴリーコード (MCC) に制限されています。
- レンタカー: 3351-3441, 7512, 7513, 7519
- 宿泊施設: 3501-3999, 7011
- 旅行代理店: 4722
- フライト: 4511
業種メタデータは、特定のクレジットカードブランド (Visa、Mastercard、Amex、Discover) と Klarna での決済に送信できます。
Klarna 固有の業種
Klarna は、レンタカー、宿泊施設、飛行機に加えて、カード決済では利用できない次のような業種固有の業種もサポートしています。
- イベント (コンサート、フェスティバル、スポーツ、会議)
- 保険 (単独の保険契約)
- 鉄道、バス、フェリーの運送
- 企画旅行とツアー
- 店舗支払い
- マーケットプレイスの売り手
これらの Klarna 専用業種の詳細については、Klarna の追加購入データに関するドキュメント をご覧ください。
カードのプライベートプレビュー
業種メタデータは、カード取引についてはプライベートプレビュー、Klarna についてはパブリックプレビューのみです。さらに、カード取引ではクルーズデータの受け渡しはサポートされていません。
業界固有のデータを送信する
PaymentIntent を 作成、更新、または 確定 するときに、payment_ パラメーターを使用して業種固有のデータを送信します。
payment_ ハッシュには、car_、lodging_、および flight_ の各業種(業種)のハッシュの配列が含まれます。
これらの配列の各ハッシュは、個人のレンタカー、宿泊、航空券を表します。
データの受け渡しの詳細については、PaymentIntentの作成を参照してください。
配列の処理動作
支払い方法は複数の予約を異なる方法で処理します。
カード: 各アレイの_最初のエントリー_ (
car_、rental_ data[0] lodging_、data[0] flight_) のみがカードネットワークに送信されます。それ以降のエントリーは無視され、クレジットカードネットワークの法令遵守には使用されません。data[0] Klarna:各アレイの_すべてのエントリー_が処理され、Klarna のリスク評価とオーソリの決定に使用されます。
複数の予約を含むクレジットカード取引(複数のホテル宿泊やレンタカーなど)の場合は、予約ごとに個別の PaymentIntents を作成し、すべての取引データがカードネットワークに正しく送信されるようにします。
このセクションは、各業種の 3 つのプロパティカテゴリで構成されています。
- サポートされている一般的なプロパティ: すべての支払い方法がサポートするベース フィールド。これらのフィールドは、コア API 構造を定義します。
- カードでサポートされる追加プロパティ: 一般的なプロパティに加えて、カードネットワークワークが使用する追加フィールド。カード支払いを処理する際は、「一般」と「カード」の両方のカテゴリのフィールドを使用します。
- Klarna でサポートされる追加プロパティ: 一般的なプロパティに加えて Klarna が使用する追加フィールド。Klarna 支払いを処理する際は、「General」セクションと「Klarna」セクションの両方のフィールドを使用します。
カードと Klarna では、異なるプロパティと検証ルールが使用されます。サポートされていない支払い方法に送信されたプロパティは無視されます。
次のタブでは、car_、lodging_、および flight_ ハッシュについて説明します。
サポートされる一般的なプロパティ
Stripe API は、すべてのクレジットカードおよび Klarna 取引で使用される次のプロパティをサポートしています。
メモ
以下のフィールドは、payment_ の下にネストされています。API リクエストの構造については、完全なコード例をご覧ください。
レンタカーの必須フィールド
以下は、すべてのレンタカー取引に最低限必要なフィールドです。
pickup.address. line1 pickup.address. city pickup.address. postal_ code pickup.address. country pickup.time drop_off. address. line1 drop_off. address. city drop_off. address. postal_ code drop_off. address. country drop_off. time total.amount
クレジットカード取引には、次の追加フィールドが必要です。
pickup.(該当する国の場合)address. state drop_(該当する国の場合)off. address. state booking_number days_rented customer_service_ phone_ number renter_name vehicle.type vehicle.make vehicle.model
| プロパティ名 | タイプ | 説明 | 形式 |
|---|---|---|---|
pickup. | 文字列 | 車の受け取り先住所の最初の行 (番地、私書箱、会社) |
|
pickup. | 文字列 | 車の受け取り住所の郵便番号 |
|
pickup. | 文字列 | 車の受け取り住所の市区町村、地区、郊外、町、または村 |
|
pickup. | 文字列 | 車のピックアップ住所の国コード |
|
pickup. | タイムスタンプ | 車のピックアップ時間 |
|
drop_ | 文字列 | 車の返却先住所の 1 行目 (通り名、私書箱、または会社名) |
|
drop_ | 文字列 | レンタカーの返却先住所郵便番号 |
|
drop_ | 文字列 | 車の返却先住所の市区町村、地区、郊外、町、または村 |
|
drop_ | 文字列 | 車の返却先住所の国コード |
|
drop_ | タイムスタンプ | 車の返却時間 |
|
total. | 整数 | 最小通貨単位 でのレンタカー全体の価格 |
|
pickup. | 文字列 | 車の受け取り住所の州、郡、州、地域 |
|
drop_ | 文字列 | 車の返却先住所の州、郡、州、地域 |
|
pickup. | 文字列 | 車の受け取り住所の 2 行目 (番地、私書箱、会社) |
|
drop_ | 文字列 | 車の返却先住所の 2 行目 (番地、私書箱、会社) |
|
carrier_ | 文字列 | レンタカー会社の名前 |
|
vehicle. | 文字列 | レンタル車両の段階 |
|
affiliate. | 文字列 | 購入を開始した関連会社の名前 |
|
1 クレジットカード取引では、pickup. が pickup. の有効な州である必要があります。
2 drop_ はクレジットカード取引の drop_ で有効な州である必要があります。
カードでサポートされるその他のプロパティ
カードは、サポートされている一般的なプロパティをサポートし、以下のプロパティも使用します。Klarna はこれらのプロパティを表示せず、Klarna 取引のオーソリ率やリスク評価を改善しません。
| プロパティ名 | タイプ | 説明 | 形式 |
|---|---|---|---|
booking_ | 文字列 | レンタカーの予約確認番号 |
|
days_ | 整数 | レンタカーの日数 |
|
customer_ | 文字列 | レンタカー会社の顧客サービスの電話番号 |
|
renter_ | 文字列 | レンタカーの貸出者の氏名 |
|
vehicle. | 文字列 | 車両のクラスを示すコード |
|
vehicle. | 文字列 | レンタルされた車のブランド |
|
vehicle. | 文字列 | レンタカーの車種 |
|
distance. | 整数 | レンタカー期間中の走行距離 |
|
distance. | 文字列 | 移動距離の単位 |
|
no_ | ブール値 | 顧客が予約に現れなかったかどうかを示す |
|
pickup. | 文字列 | レンタカーの受け取り場所 |
|
drop_ | 文字列 | レンタカーの返却場所 |
|
drivers[]. | 文字列 | レンタカー契約で許可された運転者に属する運転免許証または身分証明書番号 |
|
drivers[]. | 文字列 | レンタカー契約で課税される認定運転者に課される納税者番号 |
|
total. | 整数 | 距離または移動時間ごとに請求されるレート |
|
total. | 文字列 | 移動単位あたりのレートの計算に使用される単位 |
|
total. | ブール値 | レンタカーが非課税するであったか、税金が徴収されなかったかを示します |
|
total. | 整数 | この税額の計算に使用された割合 |
|
total. | 整数 | レンタカーに課されるこの税額 |
|
total. | 文字列 | レンタカーに適用される税金の種類 |
|
total. | 整数 | レンタカー中に発生した追加料金の金額 |
|
total. | 文字列 | レンタカー中に発生する追加料金の種類 |
|
total. | 整数 | レンタカー中に許可された無料のマイル数またはキロ数 |
|
total. | 文字列 | 法人料金または割引に使用される法人に割り当てられたコード |
|
total. | 文字列 | レンタカー契約の料金の割引に使用されるクーポン |
|
vehicle. | 文字列 | レンタル車両の登録番号 |
|
vehicle. | 整数 | 貸出時の走行距離計の読み取り |
|
affiliate. | 文字列 | 購入を開始した関連会社のコード |
|
1 distance プロパティはオプションです。distance を指定する場合は、distance. と distance. が必要です。
Klarna がサポートするその他のプロパティ
Klarna はサポートされている一般的なプロパティをサポートし、次のプロパティも使用します。カードネットワークはこれらのプロパティを認識せず、クレジットカード取引のクレジットカードネットワーク要件の法令遵守に影響しません。
| プロパティ名 | タイプ | 説明 | 形式 |
|---|---|---|---|
drivers[]. | 文字列 | レンタカー契約に記載されている認定運転者の氏名 |
|
drivers[]. | 整数 | レンタカー契約に記載されている認定運転者の生年月日 |
|
drivers[]. | 整数 | レンタカー契約に記載されている認定運転者の生年月日 |
|
drivers[]. | 整数 | レンタカー契約に記載されている認定運転者の生年月日 |
|
carrier_ | 文字列 | レンタカー会社の名前 |
|
total. | 文字列 | レンタカー全体の価格の通貨 |
|
insurances[]. | 文字列 | レンタカーに適用される保険の種類 |
|
insurances[]. | 整数 | 最小通貨単位 でのレンタカーに適用される保険の価格 |
|
insurances[]. | 文字列 | レンタカーに対して提供される保険の通貨 |
|
insurances[]. | 文字列 | レンタカーの保険を提供する会社の名前 |
|
1 drivers 配列はオプションです。drivers[]. は、指定された各ドライバーに必須です。
2 drivers[]. プロパティはオプションです。drivers[]. が指定されている場合、drivers[].、drivers[].、および drivers[]. はすべて必須です。
3 insurances 配列はオプションです。指定された保険ごとに insurances[]. と insurances[]. が必要です。
メモ
一部のプロパティでは、さまざまなプロパティサイズを受け入れるさまざまな決済手段要件に準拠するために、長さが切り詰められる場合があります。
PaymentIntent を使用する
PaymentIntent を 作成、更新、確定、または キャプチャーする際に payment_ データを含めます。
下記のステップでは、PaymentIntent のライフサイクル全体での payment_ の更新方法を示すために、手動での確定とキャプチャーを示しています。payment_ は、自動確定や自動キャプチャーのユースケースでも指定できます。
PaymentIntent を作成する
payment_ を含む、未確認・未キャプチャーの PaymentIntent を作成します。PaymentIntent を確定する前に、update メソッドを使って payment_ を更新してください。すべての payment_ の更新はハッシュ全体の置き換えとなり、利用する決済手段に対して有効である必要があります。
curl https://api.stripe.com/v1/payment_intents \ -u ":" \ -d amount=200 \ -d currency=usd \ -d "payment_method_types[0]"=card \ -d "payment_details[car_rental_data][0][booking_number]"=BOOK123456 \ -d "payment_details[car_rental_data][0][days_rented]"=3 \ --data-urlencode "payment_details[car_rental_data][0][customer_service_phone_number]"="+18005551234" \ -d "payment_details[car_rental_data][0][renter_name]"="John Doe" \ -d "payment_details[car_rental_data][0][no_show_indicator]"=false \ -d "payment_details[car_rental_data][0][distance][amount]"=150 \ -d "payment_details[car_rental_data][0][distance][unit]"=miles \ -d "payment_details[car_rental_data][0][drivers][0][name]"="Jane Driver" \ -d "payment_details[car_rental_data][0][drivers][0][driver_identification_number]"=D12345678 \ -d "payment_details[car_rental_data][0][drivers][0][driver_tax_number]"=TN123456789 \ -d "payment_details[car_rental_data][0][pickup][address][line1]"="123 Main St" \ -d "payment_details[car_rental_data][0][pickup][address][postal_code]"=10001 \ -d "payment_details[car_rental_data][0][pickup][address][city]"="New York" \ -d "payment_details[car_rental_data][0][pickup][address][country]"=US \ -d "payment_details[car_rental_data][0][pickup][address][state]"=NY \ -d "payment_details[car_rental_data][0][pickup][address][line2]"="Apt 4B" \ -d "payment_details[car_rental_data][0][pickup][time]"=1768500000 \ -d "payment_details[car_rental_data][0][pickup][location_name]"="Downtown Garage" \ -d "payment_details[car_rental_data][0][drop_off][address][line1]"="456 Elm St" \ -d "payment_details[car_rental_data][0][drop_off][address][postal_code]"=02101 \ -d "payment_details[car_rental_data][0][drop_off][address][city]"=Boston \ -d "payment_details[car_rental_data][0][drop_off][address][country]"=US \ -d "payment_details[car_rental_data][0][drop_off][address][state]"=MA \ -d "payment_details[car_rental_data][0][drop_off][address][line2]"="Suite 101" \ -d "payment_details[car_rental_data][0][drop_off][time]"=1768777200 \ -d "payment_details[car_rental_data][0][drop_off][location_name]"="Airport Terminal" \ -d "payment_details[car_rental_data][0][total][amount]"=30000 \ -d "payment_details[car_rental_data][0][total][rate_per_unit]"=1500 \ -d "payment_details[car_rental_data][0][total][rate_unit]"=days \ -d "payment_details[car_rental_data][0][total][tax][tax_exempt_indicator]"=false \ -d "payment_details[car_rental_data][0][total][tax][taxes][0][rate]"=10 \ -d "payment_details[car_rental_data][0][total][tax][taxes][0][amount]"=3000 \ -d "payment_details[car_rental_data][0][total][tax][taxes][0][type]"="Sales Tax" \ -d "payment_details[car_rental_data][0][total][extra_charges][0][amount]"=2000 \ -d "payment_details[car_rental_data][0][total][extra_charges][0][type]"=gps \ -d "payment_details[car_rental_data][0][total][discounts][maximum_free_miles_or_kilometers]"=100 \ -d "payment_details[car_rental_data][0][total][discounts][corporate_client_code]"=CORP123 \ -d "payment_details[car_rental_data][0][total][discounts][coupon]"=SAVE20 \ -d "payment_details[car_rental_data][0][insurances][0][insurance_type]"=liability_supplement \ -d "payment_details[car_rental_data][0][insurances][0][amount]"=1500 \ -d "payment_details[car_rental_data][0][vehicle][vehicle_class]"=premium_economy \ -d "payment_details[car_rental_data][0][vehicle][type]"=compact \ -d "payment_details[car_rental_data][0][vehicle][make]"=Toyota \ -d "payment_details[car_rental_data][0][vehicle][model]"=Camry \ -d "payment_details[car_rental_data][0][vehicle][vehicle_identification_number]"=1HGBH41JXMN109186 \ -d "payment_details[car_rental_data][0][vehicle][odometer]"=25000 \ -d "payment_details[car_rental_data][0][affiliate][name]"="Travel Partner" \ -d "payment_details[car_rental_data][0][affiliate][code]"=TP001sk_test_BQokikJOvBiI2HlWgH4olfQ2
PaymentIntent の確定
PaymentIntent の確定時に payment_ を更新できます。payment_ の更新はすべてハッシュの完全置換であり、決済手段に対して有効である必要があります。各プロパティが何を表すかの詳細については、業種固有データの送信をご覧ください。
curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/confirm \ -u ":" \ -d "payment_details[car_rental_data][0][booking_number]"=BOOK123456 \ -d "payment_details[car_rental_data][0][days_rented]"=3 \ --data-urlencode "payment_details[car_rental_data][0][customer_service_phone_number]"="+18005551234" \ -d "payment_details[car_rental_data][0][renter_name]"="John Doe" \ -d "payment_details[car_rental_data][0][no_show_indicator]"=false \ -d "payment_details[car_rental_data][0][distance][amount]"=150 \ -d "payment_details[car_rental_data][0][distance][unit]"=miles \ -d "payment_details[car_rental_data][0][drivers][0][name]"="Jane Driver" \ -d "payment_details[car_rental_data][0][drivers][0][driver_identification_number]"=D12345678 \ -d "payment_details[car_rental_data][0][drivers][0][driver_tax_number]"=TN123456789 \ -d "payment_details[car_rental_data][0][pickup][address][line1]"="123 Main St" \ -d "payment_details[car_rental_data][0][pickup][address][postal_code]"=10001 \ -d "payment_details[car_rental_data][0][pickup][address][city]"="New York" \ -d "payment_details[car_rental_data][0][pickup][address][country]"=US \ -d "payment_details[car_rental_data][0][pickup][address][state]"=NY \ -d "payment_details[car_rental_data][0][pickup][address][line2]"="Apt 4B" \ -d "payment_details[car_rental_data][0][pickup][time]"=1768500000 \ -d "payment_details[car_rental_data][0][pickup][location_name]"="Downtown Garage" \ -d "payment_details[car_rental_data][0][drop_off][address][line1]"="456 Elm St" \ -d "payment_details[car_rental_data][0][drop_off][address][postal_code]"=02101 \ -d "payment_details[car_rental_data][0][drop_off][address][city]"=Boston \ -d "payment_details[car_rental_data][0][drop_off][address][country]"=US \ -d "payment_details[car_rental_data][0][drop_off][address][state]"=MA \ -d "payment_details[car_rental_data][0][drop_off][address][line2]"="Suite 101" \ -d "payment_details[car_rental_data][0][drop_off][time]"=1768777200 \ -d "payment_details[car_rental_data][0][drop_off][location_name]"="Airport Terminal" \ -d "payment_details[car_rental_data][0][total][amount]"=30000 \ -d "payment_details[car_rental_data][0][total][rate_per_unit]"=1500 \ -d "payment_details[car_rental_data][0][total][rate_unit]"=days \ -d "payment_details[car_rental_data][0][total][tax][tax_exempt_indicator]"=false \ -d "payment_details[car_rental_data][0][total][tax][taxes][0][rate]"=10 \ -d "payment_details[car_rental_data][0][total][tax][taxes][0][amount]"=3000 \ -d "payment_details[car_rental_data][0][total][tax][taxes][0][type]"="Sales Tax" \ -d "payment_details[car_rental_data][0][total][extra_charges][0][amount]"=2000 \ -d "payment_details[car_rental_data][0][total][extra_charges][0][type]"=gps \ -d "payment_details[car_rental_data][0][total][discounts][maximum_free_miles_or_kilometers]"=100 \ -d "payment_details[car_rental_data][0][total][discounts][corporate_client_code]"=CORP123 \ -d "payment_details[car_rental_data][0][total][discounts][coupon]"=SAVE20 \ -d "payment_details[car_rental_data][0][insurances][0][insurance_type]"=liability_supplement \ -d "payment_details[car_rental_data][0][insurances][0][amount]"=1500 \ -d "payment_details[car_rental_data][0][vehicle][vehicle_class]"=premium_economy \ -d "payment_details[car_rental_data][0][vehicle][type]"=compact \ -d "payment_details[car_rental_data][0][vehicle][make]"=Toyota \ -d "payment_details[car_rental_data][0][vehicle][model]"=Camry \ -d "payment_details[car_rental_data][0][vehicle][vehicle_identification_number]"=1HGBH41JXMN109186 \ -d "payment_details[car_rental_data][0][vehicle][odometer]"=25000 \ -d "payment_details[car_rental_data][0][affiliate][name]"="Travel Partner" \ -d "payment_details[car_rental_data][0][affiliate][code]"=TP001sk_test_BQokikJOvBiI2HlWgH4olfQ2
PaymentIntent のキャプチャー
PaymentIntent をキャプチャーする際に、payment_ を含めて更新できます。提供するデータは完全なものにしてください。PaymentIntent をキャプチャーした後は、payment_ を変更することはできません。各プロパティの意味については、業種固有データの送信を参照してください。
curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \ -u ":" \ -d "payment_details[car_rental_data][0][booking_number]"=BOOK123456 \ -d "payment_details[car_rental_data][0][days_rented]"=3 \ --data-urlencode "payment_details[car_rental_data][0][customer_service_phone_number]"="+18005551234" \ -d "payment_details[car_rental_data][0][renter_name]"="John Doe" \ -d "payment_details[car_rental_data][0][no_show_indicator]"=false \ -d "payment_details[car_rental_data][0][distance][amount]"=150 \ -d "payment_details[car_rental_data][0][distance][unit]"=miles \ -d "payment_details[car_rental_data][0][drivers][0][name]"="Jane Driver" \ -d "payment_details[car_rental_data][0][drivers][0][driver_identification_number]"=D12345678 \ -d "payment_details[car_rental_data][0][drivers][0][driver_tax_number]"=TN123456789 \ -d "payment_details[car_rental_data][0][pickup][address][line1]"="123 Main St" \ -d "payment_details[car_rental_data][0][pickup][address][postal_code]"=10001 \ -d "payment_details[car_rental_data][0][pickup][address][city]"="New York" \ -d "payment_details[car_rental_data][0][pickup][address][country]"=US \ -d "payment_details[car_rental_data][0][pickup][address][state]"=NY \ -d "payment_details[car_rental_data][0][pickup][address][line2]"="Apt 4B" \ -d "payment_details[car_rental_data][0][pickup][time]"=1768500000 \ -d "payment_details[car_rental_data][0][pickup][location_name]"="Downtown Garage" \ -d "payment_details[car_rental_data][0][drop_off][address][line1]"="456 Elm St" \ -d "payment_details[car_rental_data][0][drop_off][address][postal_code]"=02101 \ -d "payment_details[car_rental_data][0][drop_off][address][city]"=Boston \ -d "payment_details[car_rental_data][0][drop_off][address][country]"=US \ -d "payment_details[car_rental_data][0][drop_off][address][state]"=MA \ -d "payment_details[car_rental_data][0][drop_off][address][line2]"="Suite 101" \ -d "payment_details[car_rental_data][0][drop_off][time]"=1768777200 \ -d "payment_details[car_rental_data][0][drop_off][location_name]"="Airport Terminal" \ -d "payment_details[car_rental_data][0][total][amount]"=30000 \ -d "payment_details[car_rental_data][0][total][rate_per_unit]"=1500 \ -d "payment_details[car_rental_data][0][total][rate_unit]"=days \ -d "payment_details[car_rental_data][0][total][tax][tax_exempt_indicator]"=false \ -d "payment_details[car_rental_data][0][total][tax][taxes][0][rate]"=10 \ -d "payment_details[car_rental_data][0][total][tax][taxes][0][amount]"=3000 \ -d "payment_details[car_rental_data][0][total][tax][taxes][0][type]"="Sales Tax" \ -d "payment_details[car_rental_data][0][total][extra_charges][0][amount]"=2000 \ -d "payment_details[car_rental_data][0][total][extra_charges][0][type]"=gps \ -d "payment_details[car_rental_data][0][total][discounts][maximum_free_miles_or_kilometers]"=100 \ -d "payment_details[car_rental_data][0][total][discounts][corporate_client_code]"=CORP123 \ -d "payment_details[car_rental_data][0][total][discounts][coupon]"=SAVE20 \ -d "payment_details[car_rental_data][0][insurances][0][insurance_type]"=liability_supplement \ -d "payment_details[car_rental_data][0][insurances][0][amount]"=1500 \ -d "payment_details[car_rental_data][0][vehicle][vehicle_class]"=premium_economy \ -d "payment_details[car_rental_data][0][vehicle][type]"=compact \ -d "payment_details[car_rental_data][0][vehicle][make]"=Toyota \ -d "payment_details[car_rental_data][0][vehicle][model]"=Camry \ -d "payment_details[car_rental_data][0][vehicle][vehicle_identification_number]"=1HGBH41JXMN109186 \ -d "payment_details[car_rental_data][0][vehicle][odometer]"=25000 \ -d "payment_details[car_rental_data][0][affiliate][name]"="Travel Partner" \ -d "payment_details[car_rental_data][0][affiliate][code]"=TP001sk_test_BQokikJOvBiI2HlWgH4olfQ2
複数の旅行手段
1 つの payment_ オブジェクトに、複数種類の業界データを追加して、複数の移動区間を含む取引に関する情報を提供することもできます。各プロパティの意味については、業界別データの送信 を参照してください。
curl https://api.stripe.com/v1/payment_intents \ -u ":" \ -d amount=200 \ -d currency=usd \ -d "payment_method_types[0]"=card \ -d "payment_details[car_rental_data][0][booking_number]"=BOOK123456 \ -d "payment_details[car_rental_data][0][days_rented]"=3 \ --data-urlencode "payment_details[car_rental_data][0][customer_service_phone_number]"="+18005551234" \ -d "payment_details[car_rental_data][0][renter_name]"="John Doe" \ -d "payment_details[car_rental_data][0][no_show_indicator]"=false \ -d "payment_details[car_rental_data][0][distance][amount]"=150 \ -d "payment_details[car_rental_data][0][distance][unit]"=miles \ -d "payment_details[car_rental_data][0][drivers][0][name]"="Jane Driver" \ -d "payment_details[car_rental_data][0][drivers][0][driver_identification_number]"=D12345678 \ -d "payment_details[car_rental_data][0][drivers][0][driver_tax_number]"=TN123456789 \ -d "payment_details[car_rental_data][0][pickup][address][line1]"="123 Main St" \ -d "payment_details[car_rental_data][0][pickup][address][postal_code]"=10001 \ -d "payment_details[car_rental_data][0][pickup][address][city]"="New York" \ -d "payment_details[car_rental_data][0][pickup][address][country]"=US \ -d "payment_details[car_rental_data][0][pickup][address][state]"=NY \ -d "payment_details[car_rental_data][0][pickup][address][line2]"="Apt 4B" \ -d "payment_details[car_rental_data][0][pickup][time]"=1768500000 \ -d "payment_details[car_rental_data][0][pickup][location_name]"="Downtown Garage" \ -d "payment_details[car_rental_data][0][drop_off][address][line1]"="456 Elm St" \ -d "payment_details[car_rental_data][0][drop_off][address][postal_code]"=02101 \ -d "payment_details[car_rental_data][0][drop_off][address][city]"=Boston \ -d "payment_details[car_rental_data][0][drop_off][address][country]"=US \ -d "payment_details[car_rental_data][0][drop_off][address][state]"=MA \ -d "payment_details[car_rental_data][0][drop_off][address][line2]"="Suite 101" \ -d "payment_details[car_rental_data][0][drop_off][time]"=1768777200 \ -d "payment_details[car_rental_data][0][drop_off][location_name]"="Airport Terminal" \ -d "payment_details[car_rental_data][0][total][amount]"=30000 \ -d "payment_details[car_rental_data][0][total][rate_per_unit]"=1500 \ -d "payment_details[car_rental_data][0][total][rate_unit]"=days \ -d "payment_details[car_rental_data][0][total][tax][tax_exempt_indicator]"=false \ -d "payment_details[car_rental_data][0][total][tax][taxes][0][rate]"=10 \ -d "payment_details[car_rental_data][0][total][tax][taxes][0][amount]"=3000 \ -d "payment_details[car_rental_data][0][total][tax][taxes][0][type]"="Sales Tax" \ -d "payment_details[car_rental_data][0][total][extra_charges][0][amount]"=2000 \ -d "payment_details[car_rental_data][0][total][extra_charges][0][type]"=gps \ -d "payment_details[car_rental_data][0][total][discounts][maximum_free_miles_or_kilometers]"=100 \ -d "payment_details[car_rental_data][0][total][discounts][corporate_client_code]"=CORP123 \ -d "payment_details[car_rental_data][0][total][discounts][coupon]"=SAVE20 \ -d "payment_details[car_rental_data][0][insurances][0][insurance_type]"=liability_supplement \ -d "payment_details[car_rental_data][0][insurances][0][amount]"=1500 \ -d "payment_details[car_rental_data][0][vehicle][vehicle_class]"=premium_economy \ -d "payment_details[car_rental_data][0][vehicle][type]"=compact \ -d "payment_details[car_rental_data][0][vehicle][make]"=Toyota \ -d "payment_details[car_rental_data][0][vehicle][model]"=Camry \ -d "payment_details[car_rental_data][0][vehicle][vehicle_identification_number]"=1HGBH41JXMN109186 \ -d "payment_details[car_rental_data][0][vehicle][odometer]"=25000 \ -d "payment_details[car_rental_data][0][affiliate][name]"="Travel Partner" \ -d "payment_details[car_rental_data][0][affiliate][code]"=TP001 \ -d "payment_details[lodging_data][0][checkin_at]"=1771624800 \ -d "payment_details[lodging_data][0][checkout_at]"=1771869600 \ -d "payment_details[lodging_data][0][booking_number]"=HOTEL345678 \ -d "payment_details[lodging_data][0][fire_safety_act_compliance_indicator]"=true \ --data-urlencode "payment_details[lodging_data][0][customer_service_phone_number]"="+12025551234" \ -d "payment_details[lodging_data][0][renter_name]"="Jane Smith" \ -d "payment_details[lodging_data][0][renter_id_number]"=ID123456789 \ -d "payment_details[lodging_data][0][no_show_indicator]"=false \ --data-urlencode "payment_details[lodging_data][0][host][property_phone_number]"="+18005556789" \ -d "payment_details[lodging_data][0][total][amount]"=50000 \ -d "payment_details[lodging_data][0][total][prepaid_amount]"=25000 \ -d "payment_details[lodging_data][0][total][cash_advances]"=10000 \ -d "payment_details[lodging_data][0][total][tax][tax_exempt_indicator]"=false \ -d "payment_details[lodging_data][0][total][tax][taxes][0][rate]"=10 \ -d "payment_details[lodging_data][0][total][tax][taxes][0][amount]"=5000 \ -d "payment_details[lodging_data][0][total][tax][taxes][0][type]"="City Tax" \ -d "payment_details[lodging_data][0][total][extra_charges][0][amount]"=3000 \ -d "payment_details[lodging_data][0][total][extra_charges][0][type]"=mini_bar \ -d "payment_details[lodging_data][0][total][discounts][corporate_client_code]"=CORP456 \ -d "payment_details[lodging_data][0][total][discounts][coupon]"=WINTER10 \ -d "payment_details[lodging_data][0][accommodation][accommodation_type]"=suite \ -d "payment_details[lodging_data][0][accommodation][nights]"=3 \ -d "payment_details[lodging_data][0][accommodation][daily_rate_amount]"=15000 \ -d "payment_details[lodging_data][0][accommodation][rate_type]"=Standard \ -d "payment_details[lodging_data][0][accommodation][smoking_indicator]"=false \ -d "payment_details[lodging_data][0][accommodation][bed_type]"=King \ -d "payment_details[lodging_data][0][affiliate][name]"="Travel Network" \ -d "payment_details[lodging_data][0][affiliate][code]"=TN987sk_test_BQokikJOvBiI2HlWgH4olfQ2
テスト
統合が顧客に対して正しく機能することをテストします。サンドボックスキーを使用して、Stripe サンドボックスでの API コールをシミュレーションできます。詳細については、テストをご覧ください。
テスト中に、以下を確認できます。
- 業種メタデータが適切にフォーマットされ、API によって受け入れられている
- 決済手段 (カードまたは Klarna) に必須フィールドがあります
- PaymentIntent はメタデータを使用して正常に処理されます
サンドボックステストは、統合が技術的に正しいことを確認しますが、カードネットワークのインターチェンジ認定の判断や Klarna の承認率とリスク評価の結果はシミュレーションしません。