フリート実装ガイド
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 に設定された連結アカウントを作成し、確認しています。
詳細については、以下をご覧ください。
カードを使用する
カードを使用して購入が行われると、オーソリリクエストが生成されます。このリクエストはリアルタイムで承認または拒否されます。
With a configured fleet card program, you’ll access additional fleet-specific fields gathered at the pump or point of sale. This includes odometer reading, driver identification, fuel type, gallons pumped, and itemized non-fuel product details, enabled by a fleet-specific chip configuration on the card. This data becomes available at the point of purchase during authorization, and later when the transaction is processed. Some fuel dispensers allow partial authorization.
オーソリを作成する
To observe the impact of card activity on the associated balance, generate a test authorization.
As a user with a Commercial Fleet card program, you receive specific fleet-related data on the Authorization object.
You can create a test mode authorization on the Issuing page of the Dashboard for the connected account, or with the following call to the Authorizations API:
After approval, Stripe creates an Authorization in a pending state while it waits for capture.
The authorized amount is the default amount held for a fuel dispenser transaction unless you’ve provided a different partial authorization amount in your response to the issuing_ webhook.
Make note of the authorization id that you’ll use to capture the funds:
{ "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": [], }
Simulate fuel dispenser completion
In test mode, you can simulate the completion of fuel being dispensed using the following code:
The Authorization remains in a pending state until it’s captured. The amount is updated to reflect the total amount of fuel dispensed, and additional fleet-specific fields are now available:
{ "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": [], }
売上をキャプチャーする
テスト環境では、以下のコードを使用して売上をキャプチャーできます。
After the authorization is captured, Stripe creates an Issuing Transaction, the status of the authorization is set to closed.
As a user with a Commercial Fleet card program, you receive specific fleet-related data on the Transaction, (for example, to reconcile purchases).
{ "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", }, } }