コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成サインイン
導入方法
決済管理
売上管理
プラットフォームとマーケットプレイス
資金管理
開発者向けリソース
API & SDKヘルプ
概要
Stripe Payments について
構築済みのシステムをアップグレード
決済分析
オンライン決済
概要ユースケースを見つけるManaged Payments を使用する
Payment Links を使用する
事前構築済みの決済ページを使用する
Elements を使用したカスタム統合の構築
アプリ内実装を構築
対面決済
Terminal
決済手段
決済手段を追加
決済手段を管理
Link による購入の迅速化
決済シナリオ
複数の通貨を扱う
カスタムの決済フロー
    概要
    既存の顧客の支払い
    支払いのオーソリとキャプチャーを分離する
    2 段階決済フローを構築
    インテントを作成する前に支払いの詳細を収集
    サーバーで支払いを確定する
    通信販売 / 電話販売 (MOTO) の受け付け
    アメリカとカナダのカード
    サードパーティーの API エンドポイントにカード情報を転送する
    支払い項目
    業種メタデータ
柔軟なアクワイアリング
オーケストレーション
決済以外の機能
会社を設立する
暗号資産
エージェント型コマース
Financial Connections
Climate
不正利用について
Radar の不正防止
不審請求の申請の管理
本人確認
アメリカ
日本語
ホーム決済管理Custom payment flows

メモ

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

業種メタデータ公開プレビュー

旅行およびエンターテインメントの購入に固有のデータを提供する方法をご紹介します。

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

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

業種メタデータは、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_details パラメーターを使用して業種固有のデータを送信します。

payment_details ハッシュには、car_rental_data、lodging_data、および flight_data の各業種(業種)のハッシュの配列が含まれます。

これらの配列の各ハッシュは、個人のレンタカー、宿泊、航空券を表します。

データの受け渡しの詳細については、PaymentIntentの作成を参照してください。

配列の処理動作

支払い方法は複数の予約を異なる方法で処理します。

  • カード: 各アレイの_最初のエントリー_ (car_rental_data[0]、lodging_data[0]、flight_data[0]) のみがカードネットワークに送信されます。それ以降のエントリーは無視され、クレジットカードネットワークの法令遵守には使用されません。

  • Klarna:各アレイの_すべてのエントリー_が処理され、Klarna のリスク評価とオーソリの決定に使用されます。

複数の予約を含むクレジットカード取引(複数のホテル宿泊やレンタカーなど)の場合は、予約ごとに個別の PaymentIntents を作成し、すべての取引データがカードネットワークに正しく送信されるようにします。

このセクションは、各業種の 3 つのプロパティカテゴリで構成されています。

  1. サポートされている一般的なプロパティ: すべての支払い方法がサポートするベース フィールド。これらのフィールドは、コア API 構造を定義します。
  2. カードでサポートされる追加プロパティ: 一般的なプロパティに加えて、カードネットワークワークが使用する追加フィールド。カード支払いを処理する際は、「一般」と「カード」の両方のカテゴリのフィールドを使用します。
  3. Klarna でサポートされる追加プロパティ: 一般的なプロパティに加えて Klarna が使用する追加フィールド。Klarna 支払いを処理する際は、「General」セクションと「Klarna」セクションの両方のフィールドを使用します。

カードと Klarna では、異なるプロパティと検証ルールが使用されます。サポートされていない支払い方法に送信されたプロパティは無視されます。

次のタブでは、car_rental_data、lodging_data、および flight_data ハッシュについて説明します。

サポートされる一般的なプロパティ

Stripe API は、すべてのクレジットカードおよび Klarna 取引で使用される次のプロパティをサポートしています。

メモ

以下のフィールドは、payment_details.car_rental_data の下にネストされています。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.address.line1文字列車の受け取り先住所の最初の行 (番地、私書箱、会社)
  • 必須プロパティ
  • 英数字
  • 最大長: 99 文字
pickup.address.postal_code文字列車の受け取り住所の郵便番号
  • 必須プロパティ
  • 英数字
  • 最大長: 10 文字
pickup.address.city文字列車の受け取り住所の市区町村、地区、郊外、町、または村
  • 必須プロパティ
  • 英数字
  • 最大長: 99 文字
pickup.address.country文字列車のピックアップ住所の国コード
  • 必須プロパティ
  • 有効な ISO 3166-1 alpha-2 国コードである必要があります
pickup.timeタイムスタンプ車のピックアップ時間
  • 必須プロパティ
  • Unix エポックからの経過秒数
  • 今から 2 年前~ 2 年後である必要があります
drop_off.address.line1文字列車の返却先住所の 1 行目 (通り名、私書箱、または会社名)
  • 必須プロパティ
  • 英数字
  • 最大長: 99 文字
drop_off.address.postal_code文字列レンタカーの返却先住所郵便番号
  • 必須プロパティ
  • 英数字
  • 最大長: 10 文字
drop_off.address.city文字列車の返却先住所の市区町村、地区、郊外、町、または村
  • 必須プロパティ
  • 英数字
  • 最大長: 99 文字
drop_off.address.country文字列車の返却先住所の国コード
  • 必須プロパティ
  • 有効な ISO 3166-1 alpha-2 国コードである必要があります
drop_off.timeタイムスタンプ車の返却時間
  • 必須プロパティ
  • Unix エポックからの経過秒数
  • 今から 2 年前~ 2 年後である必要があります
total.amount整数 最小通貨単位 でのレンタカー全体の価格
  • 必須プロパティ
  • 最小: 0
pickup.address.state文字列車の受け取り住所の州、郡、州、地域
  • カードに必要
  • 条件付きの検証 1
  • 英数字
  • 最大長: 99 文字
drop_off.address.state文字列車の返却先住所の州、郡、州、地域
  • カードに必要
  • 条件付きの検証 2
  • 英数字
  • 最大長: 99 文字
pickup.address.line2文字列車の受け取り住所の 2 行目 (番地、私書箱、会社)
  • 英数字
  • 最大長: 99 文字
drop_off.address.line2文字列車の返却先住所の 2 行目 (番地、私書箱、会社)
  • 英数字
  • 最大長: 99 文字
carrier_name文字列レンタカー会社の名前
  • 英数字
  • 最大長: 255 文字
vehicle.vehicle_class文字列レンタル車両の段階
  • economy、premium_economy、business、または first_class のいずれか
affiliate.name文字列購入を開始した関連会社の名前
  • 英数字
  • 最大長: 255 文字

1 クレジットカード取引では、pickup.address.state が pickup.address.country の有効な州である必要があります。

2 drop_off.address.state はクレジットカード取引の drop_off.address.country で有効な州である必要があります。

カードでサポートされるその他のプロパティ

カードは、サポートされている一般的なプロパティをサポートし、以下のプロパティも使用します。Klarna はこれらのプロパティを表示せず、Klarna 取引のオーソリ率やリスク評価を改善しません。

プロパティ名タイプ説明形式
booking_number文字列レンタカーの予約確認番号
  • カードに必要
  • 英数字
  • 最大長: 255 文字
days_rented整数レンタカーの日数
  • カードに必要
  • 最小: 1
  • 最大: 999
customer_service_phone_number文字列レンタカー会社の顧客サービスの電話番号
  • カードに必要
  • 有効な電話番号である必要があります (数字のみ)。テスト環境ではすべてゼロ (0000000000) にすることもできます
  • アメリカ以外の電話番号はプラス記号 (+) で始める必要があります
renter_name文字列レンタカーの貸出者の氏名
  • カードに必要
  • 最大長: 198 文字
vehicle.type文字列車両のクラスを示すコード
  • カードに必要
  • mini、subcompact、economy、compact、midsize、intermediate、standard、full_size、luxury、premium、minivan、twelve_passenger_van、moving_van、fifteen_passenger_van、cargo_van、twelve_foot_truck、twenty_foot_truck、twenty_four_foot_truck、twenty_six_foot_truck、moped、stretch、regular、unique、exotic、small_medium_truck、large_truck、small_suv、medium_suv、large_suv、exotic_suv、four_wheel_drive、special、taxi、または miscellaneous のいずれか
vehicle.make文字列レンタルされた車のブランド
  • カードに必要
  • 英数字
  • 最大長: 40 文字
vehicle.model文字列レンタカーの車種
  • カードに必要
  • 英数字
  • 最大長: 40 文字
distance.amount整数レンタカー期間中の走行距離
  • 条件付きの必須プロパティ 1
  • 最小: 0
distance.unit文字列移動距離の単位
  • 条件付きの必須プロパティ 1
  • miles または kilometers のいずれか
no_show_indicatorブール値顧客が予約に現れなかったかどうかを示す
  • true または false
pickup.location_name文字列レンタカーの受け取り場所
  • 英数字
  • 最大長: 38 文字
drop_off.location_name文字列レンタカーの返却場所
  • 英数字
  • 最大長: 38 文字
drivers[].driver_identification_number文字列レンタカー契約で許可された運転者に属する運転免許証または身分証明書番号
  • 英数字
  • 最大長: 20 文字
  • この個人を特定できるプロパティは必須ではありません
drivers[].driver_tax_number文字列レンタカー契約で課税される認定運転者に課される納税者番号
  • 英数字
  • 最大長: 20 文字
  • この個人を特定できるプロパティは必須ではありません
total.rate_per_unit整数距離または移動時間ごとに請求されるレート
  • 最小: 0
total.rate_unit文字列移動単位あたりのレートの計算に使用される単位
  • miles、kilometers、days、weeks、months のいずれか
total.tax.tax_exempt_indicatorブール値レンタカーが非課税するであったか、税金が徴収されなかったかを示します
  • true または false
total.tax.taxes[].rate整数この税額の計算に使用された割合
  • 最小: 0
total.tax.taxes[].amount整数レンタカーに課されるこの税額
  • 最小: 0
total.tax.taxes[].type文字列レンタカーに適用される税金の種類
  • 英数字
  • 最大長: 40 文字
total.extra_charges[].amount整数レンタカー中に発生した追加料金の金額
  • 最小: 0
total.extra_charges[].type文字列レンタカー中に発生する追加料金の種類
  • one_way_drop_off、regular_mileage、extra_mileage、late_charge、parking、towing、gps、phone、gas、 または other のいずれか
total.discounts.maximum_free_miles_or_kilometers整数レンタカー中に許可された無料のマイル数またはキロ数
  • 最小: 0
  • 最大: 9999
total.discounts.corporate_client_code文字列法人料金または割引に使用される法人に割り当てられたコード
  • 英数字
  • 最大長: 20 文字
total.discounts.coupon文字列レンタカー契約の料金の割引に使用されるクーポン
  • 最大長: 25 文字
vehicle.vehicle_identification_number文字列レンタル車両の登録番号
  • 英数字
  • 最大長: 20 文字
vehicle.odometer整数貸出時の走行距離計の読み取り
  • 最小: 0
affiliate.code文字列購入を開始した関連会社のコード
  • 英数字
  • 最大長: 20 文字

1 distance プロパティはオプションです。distance を指定する場合は、distance.amount と distance.unit が必要です。

Klarna がサポートするその他のプロパティ

Klarna はサポートされている一般的なプロパティをサポートし、次のプロパティも使用します。カードネットワークはこれらのプロパティを認識せず、クレジットカード取引のクレジットカードネットワーク要件の法令遵守に影響しません。

プロパティ名タイプ説明形式
drivers[].name文字列レンタカー契約に記載されている認定運転者の氏名
  • 条件付きで必須1
  • 英数字
  • 最大長: 198 文字
drivers[].date_of_birth.day整数レンタカー契約に記載されている認定運転者の生年月日
  • 条件付きで必須2
  • 最小: 1
  • 最大: 31
  • date_of_birth は過去の有効な日付である必要があります
drivers[].date_of_birth.month整数レンタカー契約に記載されている認定運転者の生年月日
  • 条件付きで必須2
  • 最小: 1
  • 最大: 12
  • date_of_birth は過去の有効な日付である必要があります
drivers[].date_of_birth.year整数レンタカー契約に記載されている認定運転者の生年月日
  • 条件付きで必須2
  • 最小: 1901
  • date_of_birth は過去の有効な日付である必要があります
carrier_name文字列レンタカー会社の名前
  • 英数字
  • 最大長: 255 文字
total.currency文字列レンタカー全体の価格の通貨
  • 有効な ISO 4217 3-letter code である必要があります
insurances[].insurance_type文字列レンタカーに適用される保険の種類
  • 条件付きで必須3
  • liability_supplement、loss_damage_waiver、partial_damage_waiver、personal_accident、personal_effects、または other のいずれか
insurances[].amount整数 最小通貨単位 でのレンタカーに適用される保険の価格
  • 条件付きで必須3
  • 最小: 0
insurances[].currency文字列レンタカーに対して提供される保険の通貨
  • 有効な ISO 4217 3-letter code である必要があります
insurances[].insurance_company_name文字列レンタカーの保険を提供する会社の名前
  • 最大長: 255 文字

1 drivers 配列はオプションです。drivers[].name は、指定された各ドライバーに必須です。

2 drivers[].date_of_birth プロパティはオプションです。drivers[].date_of_birth が指定されている場合、drivers[].date_of_birth.day、drivers[].date_of_birth.month、および drivers[].date_of_birth.year はすべて必須です。

3 insurances 配列はオプションです。指定された保険ごとに insurances[].insurance_type と insurances[].amount が必要です。

メモ

一部のプロパティでは、さまざまなプロパティサイズを受け入れるさまざまな決済手段要件に準拠するために、長さが切り詰められる場合があります。

PaymentIntent を使用する

PaymentIntent を 作成、更新、確定、または キャプチャーする際に payment_details データを含めます。

下記のステップでは、PaymentIntent のライフサイクル全体での payment_details の更新方法を示すために、手動での確定とキャプチャーを示しています。payment_details は、自動確定や自動キャプチャーのユースケースでも指定できます。

PaymentIntent を作成する

payment_details を含む、未確認・未キャプチャーの PaymentIntent を作成します。PaymentIntent を確定する前に、update メソッドを使って payment_details を更新してください。すべての payment_details の更新はハッシュ全体の置き換えとなり、利用する決済手段に対して有効である必要があります。

Command Line
cURL
No results
curl https://api.stripe.com/v1/payment_intents \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -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

PaymentIntent の確定

PaymentIntent の確定時に payment_details を更新できます。payment_details の更新はすべてハッシュの完全置換であり、決済手段に対して有効である必要があります。各プロパティが何を表すかの詳細については、業種固有データの送信をご覧ください。

Command Line
cURL
No results
curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/confirm \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -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

PaymentIntent のキャプチャー

PaymentIntent をキャプチャーする際に、payment_details を含めて更新できます。提供するデータは完全なものにしてください。PaymentIntent をキャプチャーした後は、payment_details を変更することはできません。各プロパティの意味については、業種固有データの送信を参照してください。

Command Line
cURL
No results
curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -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

複数の旅行手段

1 つの payment_details オブジェクトに、複数種類の業界データを追加して、複数の移動区間を含む取引に関する情報を提供することもできます。各プロパティの意味については、業界別データの送信 を参照してください。

Command Line
cURL
No results
curl https://api.stripe.com/v1/payment_intents \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -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]"=TN987

テスト

統合が顧客に対して正しく機能することをテストします。サンドボックスキーを使用して、Stripe サンドボックスでの API コールをシミュレーションできます。詳細については、テストをご覧ください。

テスト中に、以下を確認できます。

  • 業種メタデータが適切にフォーマットされ、API によって受け入れられている
  • 決済手段 (カードまたは Klarna) に必須フィールドがあります
  • PaymentIntent はメタデータを使用して正常に処理されます

サンドボックステストは、統合が技術的に正しいことを確認しますが、カードネットワークのインターチェンジ認定の判断や Klarna の承認率とリスク評価の結果はシミュレーションしません。

このページはお役に立ちましたか。
はいいいえ
  • お困りのことがございましたら 、サポートにお問い合わせください。
  • 変更ログをご覧ください。
  • ご不明な点がございましたら、お問い合わせください。
  • LLM ですか?llms.txt を読んでください。
  • Powered by Markdoc