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.
- Issuing in einer Sandbox-Umgebung vom Dashboard aus aktivieren.
- 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:
Mit einem konfigurierten Flottenkartenprogramm greifen Sie auf zusätzliche flottenspezifische Felder zu, die an der Pumpe oder am Point of Sale erfasst werden. Dazu gehören Kilometerstand, Fahreridentifikation, Kraftstoffart, die getankten Liter (Gallonen) und detaillierte Angaben zu Nicht-Kraftstoff-Produkten, die durch eine flottenspezifische Chipkonfiguration auf der Karte ermöglicht werden. Diese Daten werden am Verkaufsort während der Autorisierung und später bei der Verarbeitung der Transaktion verfügbar. Einige Zapfsäulen erlauben eine teilweise Autorisierung.
Autorisierung erstellen
Generieren Sie eine Testautorisierung, um zu erfahren, wie sich die Kartenaktivität auf den zugehörigen Saldo auswirkt.
Als Nutzer/in mit einem kommerziellen Flottenkartenprogramm erhalten Sie bestimmte flottenbezogene Daten im Autorisierungs-Objekt.
Sie können eine Testautorisierung auf der Issuing-Seite des Dashboards für das verbundene Konto oder mit dem folgenden Aufruf der Authorizations API erstellen:
Nach der Genehmigung erstellt Stripe eine Authorization im Status pending, während auf die Erfassung gewartet wird.
Der autorisierte amount ist der Standardbetrag, der für eine Transaktion an einer Zapfsäule einbehalten wird, es sei denn, Sie haben in Ihrer Antwort auf den Webhook issuing_ einen anderen Teilautorisierungsbetrag angegeben.
Notieren Sie sich die Autorisierungs-id, die Sie zur Erfassung der Gelder verwenden:
{ "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": [], }
Abschluss an der Zapfsäule simulieren
In Testumgebungen können Sie mit dem folgenden Code die Beendigung der Kraftstoffabgabe simulieren:
Die Authorization verbleibt im Status pending, bis sie erfasst wurde. Der Betrag wird aktualisiert, um die Gesamtmenge des ausgegebenen Kraftstoffs widerzuspiegeln, und zusätzliche flottenspezifische Felder sind jetzt verfügbar:
{ "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
In Testumgebungen können Sie die Gelder mit dem folgenden Code erfassen:
Nachdem die Autorisierung erfasst wurde, erstellt Stripe eine Transaktion in Issuing, deren status auf closed gesetzt wird.
Als Nutzer/in mit einem kommerziellen Flottenkartenprogramm erhalten Sie bestimmte flottenbezogene Daten über die Transaktion, die beispielsweise für den Abgleich von Einkäufen erforderlich sind.
{ "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", }, } }