フリート実装ガイド
Issuing を使用してフリートの金融サービスの実装を構築します。
Stripe の Issuing を使用して、フリートオファリングを構築し、顧客のビジネスのカードを作成し、取引を処理します。
このガイドを最後までお読みいただくと、以下の方法について理解できます。
- ビジネス顧客を表す確認済みの連結アカウントを作成します。
- ビジネス顧客向けのカードを作成して、これらのカードを使って資金を使用します。
- 給油時や購入時に収集される、追加の車両固有のフィールドを理解します。
はじめに
- 登録して Stripe アカウントを作成します。
- ダッシュボードからサンドボックス環境で Issuing を有効にします。
- 自社の Connect プラットフォームのブランディング設定を行い、アイコンを追加します。
概要
Stripe Issuing を使用すると、フリート管理プラットフォームとオペレーターは、物理支払いカードまたは仮想支払いカードを使用して、カスタマイズされたフリートカードプログラムを作成し、管理できます。Issuing を使用すると、ユーザーは、クライアントの電気自動車または従来の燃料自動車に関連する経費を効率的に管理し、照合することができます。
Stripe のプラットフォームは、場所を問わず受け付けられるオープンループ型カード、購入時点でのリアルタイムの支出管理、Stripe の不正使用ツールとオーソリシグナルを利用した高度な不正防止、およびお客様のプログラムに固有のカード特典 (例: 燃料支出額の 1 % のキャッシュバック) を定義する機能など、高度な機能を提供します。フリートプロバイダーは、個人または車両のグループに関連付けられたカードを発行することもできます。これにより、正確な経費の追跡 (走行距離計の読み取りを含む) が容易になり、支出を承認されたドライバー、加盟店、または特定の購入カテゴリーのみに制限することができます。
Stripe のプラットフォームは、支出のパターン、利用量、メンテナンス、取引の詳細に含まれるインサイトを特定するためのデータアクセスを提供し、ビジネスがフリートプログラムをカスタマイズできるようにします。このアプローチにより、実現されたコスト削減だけでなく、燃料、修理、食事、宿泊施設などのカードに基づく経費を監視し、業務を効率化できます。
連結アカウントを作成する
連結アカウントを作成する
プラットフォームのビジネス顧客を表す連結アカウントを作成します。お客様のプラットフォームでは、各運送業者が 1 件の連結アカウントとして表されます。
Connect アカウントのタイプ
Issuing は、Stripe がホストするダッシュボードを使用せず、プラットフォームが要件の収集と損失に対する責任を負う連結アカウント (Custom 連結アカウントとも呼ばれる) のみをサポートします。詳しくは、Issuing と連携可能な連結アカウントの作成方法をご確認ください。既存のアカウントがこの設定に当てはまらない場合は、アカウントを再作成する必要があります。
以下のリクエストによって、アメリカを拠点とする連結アカウントが適切な設定で新規作成され、必須のケイパビリティがリクエストされます。
ユーザーのアカウント情報がレスポンスに表示されます。
{ ... "id": "{{CONNECTED_ACCOUNT_ID}}", "controller": { "stripe_dashboard": { "type": "none" }, "fees": { "payer": "application" }, "losses": { "payments": "application" }, "is_controller": true, "type": "application", "requirement_collection": "application" }, ... }
連結アカウントの id を書き留めておきます。この値を Stripe-Account ヘッダーでリクエストすることにより、連結アカウントとして認証します。
連結アカウントがすでに存在する場合は、リクエストで連結アカウントの id を指定することで、必要なケイパビリティを追加できます。
連結アカウントを確認する
次のアカウント登録オプションのいずれかを選択します。
この時点で、Stripe は Issuing と Treasury の使用に関連するケイパビリティが active に設定された連結アカウントを作成し、確認しています。
詳細については、以下をご覧ください。
カードを使用する
カードを使用して購入が行われると、オーソリリクエストが生成されます。このリクエストはリアルタイムで承認または拒否されます。
設定済みのフリートカードプログラムを使用すると、給油時または販売時に収集される追加の車両固有のフィールドにアクセスできます。これには、走行距離計の読み取り、ドライバーの識別、燃料の種類、給油量、およびカードのフリート固有のチップ構成によって有効化される項目別の非燃料製品の詳細が含まれます。このデータは、購入時点でオーソリが行われ、その後取引が処理されたときに利用可能になります。給油機によっては、一部オーソリが許可されています。
オーソリを作成する
関連付けられた残高へのカードアクティビティーの影響を確認するには、テストオーソリを生成します。
商用フリートカードプログラムのユーザーは、Authorization オブジェクトで特定の車両に関連するデータを受け取ります (購入の照合など)。
認証テストは、連結アカウントのダッシュボードの Issuing ページで作成するか、Authorizations API に対する以下のコールを使用して作成することができます。
承認後、Stripe はキャプチャーを待っている間に pending 状態の Authorization を作成します。
オーソリ済みの amount は、issuing_ Webhook へのレスポンスで別の部分的なオーソリ金額を指定していない限り、給油機取引でデフォルトで保留される金額です。
売上のキャプチャーに使用するオーソリの id を書き留めておきます。
{ "id": "iauth_1NvPyY2SSJdH5vn2xZQE8C7k", "object": "issuing.authorization", "amount": 10000, ... "fleet": { "cardholder_prompt_data": { "odometer": 42424, }, "purchase_type": "fuel_purchase", "service_type": "self_service", }, "status": "pending", "transactions": [], }
給油機の完了をシミュレートする
テスト環境では、以下のコードを使用して、燃料給油の完了をシミュレーションできます。
Authorization は、キャプチャーされるまで pending 状態のままになります。供給された燃料の合計量を反映するように金額が更新され、追加のフリート固有のフィールドが使用できるようになりました。
{ "id": "iauth_1NvPyY2SSJdH5vn2xZQE8C7k", "object": "issuing.authorization", "amount": 1000, ... "fleet": { "cardholder_prompt_data": { "odometer": 42424, }, "purchase_type": "fuel_purchase", "reported_breakdown": { "fuel": { "gross_amount_decimal": "10.0", }, "non_fuel": { "gross_amount_decimal": "0" }, "tax": { "local_amount_decimal": "0.03", "national_amount_decimal": null } }, "service_type": "self_service", }, "fuel": { "industry_product_code": "001", "quantity_decimal": "5.0", "type": "unleaded_regular", "unit": "us_gallon", "unit_cost_decimal": "200", }, "status": "pending", "transactions": [], }
売上をキャプチャーする
テスト環境では、以下のコードを使用して売上をキャプチャーできます。
オーソリがキャプチャーされると、Stripe は Issuing の取引を作成し、オーソリの status が closed に設定されます。
商用フリートカードプログラムのユーザーは、取引で特定の車両に関連するデータを受け取ります (購入の照合など)。
{ "id": "ipi_1MykXhFtDWhhyHE1UjsZZ3xQ", "object": "issuing.transaction", "amount": 1000, ... "purchase_details": { "fleet": { "cardholder_prompt_data": { "odometer": 42424, }, "purchase_type": "fuel_purchase", "reported_breakdown": { "fuel": { "gross_amount_decimal": "10.0", }, "non_fuel": { "gross_amount_decimal": "0" }, "tax": { "local_amount_decimal": "0.03", "national_amount_decimal": null } }, "service_type": "self_service", }, "fuel": { "industry_product_code": "001", "quantity_decimal": "5.0", "type": "unleaded_regular", "unit": "us_gallon", "unit_cost_decimal": "200", }, } }