Flotten-Integrationsleitfaden
Erstellen Sie mit Issuing eines Integration für Flotten-Finanzdienste.
Erstellen Sie ein Flottenangebot mit Stripe Issuing, um Karten zu erstellen und Transaktionen für die Unternehmen Ihrer Kundinnen und Kunden zu verarbeiten.
In diesem Leitfaden lernen Sie Folgendes:
- Erstellen Sie verifizierte verbundene Konten, die Ihre Geschäftskundinnen und -kunden darstellen.
- Erstellen Sie Karten für Ihre Geschäftskundinnen und -kunden und verwenden Sie diese Karten, um Gelder auszugeben.
- Verstehen Sie die zusätzlichen flottenspezifischen Felder, die an der Zapfsäule oder am Verkaufsort erfasst werden.
Bevor Sie loslegen
- Registrieren Sie sich für ein Stripe-Konto.
- Aktivieren Sie den Issuing-Test-Modus im Dashboard.
- Konfigurieren Sie Ihre Branding-Einstellungen der Connect-Plattform für Ihr Unternehmen und fügen Sie ein Symbol hinzu.
Übersicht
Stripe Issuing ermöglicht Flottenmanagement-Plattformen und Betreibern, maßgeschneiderte Flottenkartenprogramme mit physischen oder virtuellen Zahlungskarten zu erstellen und zu verwalten. Issuing ermöglicht es Nutzern und Nutzerinnne, Ausgaben im Zusammenhang mit den Elektro- oder herkömmlichen Kraftstoffflotten ihrer Kundinnen und Kunden effizient zu kontrollieren, zu verwalten und abzustimmen.
Die Plattform von Stripe bietet erweiterte Funktionen mit Open-Loop-Karten, die überall akzeptiert werden, Echtzeit-Ausgabenkontrollen am Verkaufsort, fortschrittlichen Betrugsschutz, der die Betrugsbekämpfungstools und Autorisierungssignale von Stripe nutzt, und die Möglichkeit, Kartenvorteile zu definieren, die für Ihr Programm einzigartig sind, wie zum Beispiel 1 % Cashback auf Kraftstoffausgaben. Flottenanbieter können auch Karten ausstellen, die an einzelne Fahrzeuge oder Gruppen von Fahrzeugen gebunden sind, was eine genaue Ausgabenverfolgung (einschließlich Kilometerstand) erleichtert und die Ausgaben auf autorisierte Fahrer/innen, Händler oder bestimmte Einkaufskategorien beschränkt.
Die Plattform von Stripe bietet Datenzugriff, um Einblicke in Ausgabenmuster, Kilometerstand, Wartung und Transaktionsdetails zu erhalten, sodass Unternehmen ihr Flottenprogramm verbessern können. Dieser Ansatz bietet eine größere betriebliche Effizienz mit realisierten Kosteneinsparungen sowie eine Übersicht über die kartenbasierten Ausgaben für Kraftstoff, Reparaturen, Lebensmittel, Unterkunft und mehr.
Verbundene Konten erstellen
Verbundenes Konto erstellen
Erstellen Sie ein verbundenes Konto, um eine Geschäftskundin/einen Geschäftskunden auf Ihrer Plattform darzustellen. Für Ihre Plattform würde jeder Flottenbetreiber als ein verbundenes Konto dargestellt.
Connect-Kontoarten
Issuing unterstützt nur verbundene Konten, die kein von Stripe gehostetes Dashboard verwenden und bei denen Ihre Plattform für die Erfassung von Anforderungen und die Verlusthaftung verantwortlich ist, auch als verbundenes Custom-Konto bezeichnet. Erfahren Sie, wie Sie verbundene Konten erstellen, die mit Issuing kompatibel sind. Wenn Ihre bestehenden Konten nicht mit dieser Konfiguration übereinstimmen, müssen Sie sie neu erstellen.
Über die folgende Anfrage wird ein verbundenes Konto mit der korrekten Konfiguration in den USA erstellt, und die erforderlichen Funktionen werden angefordert:
Die Kontoinformationen der Nutzerin/des Nutzers werden in der Antwort angezeigt:
{ ... "id": "{{CONNECTED_ACCOUNT_ID}}", "controller": { "stripe_dashboard": { "type": "none" }, "fees": { "payer": "application" }, "losses": { "payments": "application" }, "is_controller": true, "type": "application", "requirement_collection": "application" }, ... }
Notieren Sie sich die id des verbundenen Kontos. Sie geben diesen Wert an, um sich als das verbundene Konto zu authentifizieren, indem Sie ihn in Anfragen im Stripe-Account-Header übergeben.
Wenn bereits ein verbundenes Konto vorhanden ist, können Sie die erforderlichen Funktionen hinzufügen, indem Sie die id des verbundenen Kontos in der API-Anfrage angeben:
Verbundenes Konto verifizieren
Wählen Sie eine der folgenden Onboarding-Optionen:
Stripe hat inzwischen das verbundene Konto erstellt und verifiziert. Die relevanten Funktionen sind active und das Konto kann nun mit Issuing und Treasury verwendet werden.
Weitere Informationen finden Sie unter:
Karte verwenden
Bei der Verwendung einer Karte für einen Kauf wird eine Autorisierungsanfrage erstellt, die in Echtzeit genehmigt oder abgelehnt werden kann:
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.
Autorisierung erstellen
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": [], }
Gelder erfassen
Im Test-Modus können Sie die Gelder mit dem folgenden Code erfassen:
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", }, } }