# Flotten-Integrationsleitfaden Erstellen Sie mit Issuing eines Integration für Flotten-Finanzdienste. Lesen Sie unseren Einführungsleitfaden zur Verwendung [von Embedded Finance für SaaS-Plattformen](https://stripe.com/guides/introduction-to-embedded-finance). Erstellen Sie ein Flottenangebot mit Stripe [Issuing](https://docs.stripe.com/issuing.md), 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. ## Before you begin 1. Registrieren Sie sich für ein [Stripe-Konto](https://dashboard.stripe.com/register). 1. [Issuing](https://dashboard.stripe.com/issuing/activate) in einer *Sandbox* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes)-Umgebung vom Dashboard aus aktivieren. 1. Konfigurieren Sie Ihre [Branding-Einstellungen der Connect-Plattform](https://dashboard.stripe.com/settings/connect/stripe-dashboard/branding) 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 > > Ausstellen unterstützt nur verbundene Konten, die kein von Stripe gehostetes Dashboard verwenden und bei denen Ihre Plattform für die Erfassung der Anforderungen verantwortlich ist und die Verlusthaftung trägt. Diese Konten werden auch als verbundene Custom-Konten bezeichnet. Erfahren Sie, wie Sie [verbundene Konten erstellen](https://docs.stripe.com/connect/interactive-platform-guide.md?connect-charge-type=direct&connect-loss-liability-owner=platform), die mit dieser Konfiguration funktionieren. Wenn Ihre bestehenden Konten nicht mit dieser ü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: ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d country=US \ -d "controller[stripe_dashboard][type]=none" \ -d "controller[fees][payer]=application" \ -d "controller[losses][payments]=application" \ -d "controller[requirement_collection]=application" \ -d "capabilities[transfers][requested]=true" \ -d "capabilities[card_issuing][requested]=true" \ -d "capabilities[us_bank_account_ach_payments][requested]=true" ``` Die Kontoinformationen der Nutzerin/des Nutzers werden in der Antwort angezeigt: ```json { ... "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](https://docs.stripe.com/connect/authentication.md), 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: ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \ -u "<>:" \ -d "controller[stripe_dashboard][type]=none" \ -d "controller[fees][payer]=application" \ -d "controller[losses][payments]=application" \ -d "controller[requirement_collection]=application" \ -d country=US \ --data-urlencode "email=jenny.rosen@example.com" \ -d "capabilities[transfers][requested]=true" \ -d "capabilities[card_issuing][requested]=true" ``` ### Verbundenes Konto verifizieren Wählen Sie eine der folgenden Onboarding-Optionen: #### Von Stripe gehostetes Onboarding Das von [Stripe gehostete Onboarding](https://docs.stripe.com/connect/hosted-onboarding.md) ist ein von Stripe gehostetes Webformular mit dem Namen, der Farbe und dem Symbol Ihrer Marke. Das von Stripe gehostete Onboarding nutzt die [Accounts API](https://docs.stripe.com/api/accounts.md), um die Anforderungen zu lesen und ein Onboarding-Formular mit robuster Datenvalidierung zu generieren, das für alle von Stripe unterstützten Länder lokalisiert ist. Bevor Sie Connect Onboarding verwenden, müssen Sie den Namen, die Farbe und das Symbol Ihrer Marke im Abschnitt „Branding“ in den [Connect-Einstellungen](https://dashboard.stripe.com/test/settings/connect) angeben. Sie können gehostetes Onboarding verwenden, um verbundenen Konten zu gestatten, ein `external_account` (das für Auszahlungen erforderlich ist) zu verknüpfen, indem es über Ihre [Onboarding-Einstellungen für Connect](https://dashboard.stripe.com/settings/connect) verknüpft wird. Verwenden Sie die [Account Links API](https://docs.stripe.com/api/account_links/create.md), um einen Onboarding-Link für das verbundene Konto zu erstellen. ```curl curl https://api.stripe.com/v1/account_links \ -u "<>:" \ -d account={{CONNECTED_ACCOUNT_ID}} \ --data-urlencode "refresh_url=https://example.com/reauth" \ --data-urlencode "return_url=https://example.com/return" \ -d type=account_onboarding ``` > Senden Sie aus Sicherheitsgründen keine Konto-Link-URLs per E-Mail, Textnachricht oder direkt an Ihr verbundenes Konto. Wir empfehlen, die Konto-Link-URL über Ihre Plattform zu versenden, wo alle Konten authentifiziert sind. Die Antwort, die Sie erhalten, enthält den Parameter `url` mit dem Link für Ihr verbundenes Konto zum Onboarding auf Ihre Plattform. ```json { "object": "account_link", "created": 1612927106, "expires_at": 1612927406, "url": "https://connect.stripe.com/setup/s/…" } ``` #### Eingebettetes Onboarding Die Nutzeroberfläche des eingebetteten Onboardings hat nur wenig Stripe-Branding und kann an Ihre Marke angepasst werden. Ihre Plattform bettet die [Komponente für Konto-Onboarding](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md) in Ihre Anwendung ein und Ihre verbundenen Konten interagieren mit der eingebetteten Komponente, ohne Ihre Anwendung verlassen zu müssen. Das eingebettete Onboarding verwendet die [Accounts API](https://docs.stripe.com/api/accounts.md), um Anforderungen zu ermitteln und ein Onboarding-Formular mit zuverlässiger Datenvalidierung zu generieren, das für alle von Stripe unterstützten Länder lokalisiert ist. Mit eingebettetem Onboarding erhalten Sie einen angepassten Onboarding-Ablauf ohne die Komplexität und den Pflegeaufwand, die mit der Aktualisierung Ihrer Onboarding-Integration bei sich ändernden Compliance-Anforderungen verbunden sind. #### API-Onboarding Wenn Sie lieber ein benutzerdefiniertes Onboarding für Ihr verbundenes Konto erstellen möchten, verwenden Sie die [Accounts Update API](https://docs.stripe.com/api/accounts/update.md) und die [Persons Update API](https://docs.stripe.com/api/persons/update.md), um die entsprechenden Objekte `Account` und `Person` mit den erforderlichen Informationen zu aktualisieren. Sie müssen die [erforderlichen Vereinbarungen für Issuing](https://docs.stripe.com/issuing/compliance-us.md#issuing-terms) anzeigen und die Annahme von verbundenen Konten über den [Issuing TOS-Annahme](https://docs.stripe.com/api/accounts/object.md#account_object-settings-card_issuing-tos_acceptance)-Hash erfassen. ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}} \ -u "<>:" \ -d business_type=company \ -d "business_profile[mcc]=5999" \ --data-urlencode "business_profile[url]=https://www.wesellsocks.com" \ -d "business_profile[estimated_worker_count]=100" \ -d "business_profile[annual_revenue][amount]=1000000" \ -d "business_profile[annual_revenue][currency]=usd" \ -d "business_profile[annual_revenue][fiscal_year_end]=2023-12-31" \ -d "company[name]=Rocket Rides" \ -d "company[tax_id]=11-3456789" \ -d "company[address][line1]=123 Main St" \ -d "company[address][city]=San Francisco" \ -d "company[address][state]=CA" \ -d "company[address][postal_code]=94111" \ -d "company[address][country]=US" \ -d "settings[card_issuing][tos_acceptance][ip]=192.168.123.132" \ -d "settings[card_issuing][tos_acceptance][date]=1696634647" ``` ```curl curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}}/persons \ -u "<>:" \ -d first_name=Jenny \ -d last_name=Rosen \ -d "dob[day]=12" \ -d "dob[month]=11" \ -d "dob[year]=1978" \ -d "address[line1]=510 Townsend Street" \ -d "address[city]=San Francisco" \ -d "address[state]=CA" \ -d "address[postal_code]=94111" \ -d "address[country]=US" \ -d id_number=123456789 \ --data-urlencode "email=jenny.rosen@example.com" \ -d "relationship[representative]=true" \ -d "relationship[owner]=true" \ -d "relationship[percent_ownership]=0.75" ``` Unter [Verarbeitung der Verifizierung mit der API](https://docs.stripe.com/connect/handling-api-verification.md) finden Sie weitere Informationen zur Erfüllung der Onboarding-Anforderungen. Stripe hat inzwischen das verbundene Konto erstellt und verifiziert. Die relevanten Funktionen sind `active` und das Konto kann nun mit Issuing und Treasury für Plattformen verwendet werden. Weitere Informationen finden Sie unter: - [Issuing- und Connect-Integration einrichten](https://docs.stripe.com/issuing/connect.md) - [Von Stripe gehostetes Onboarding für verbundene Konten](https://docs.stripe.com/connect/custom/hosted-onboarding.md) - [Verbundene Konten erstellen und verwenden](https://docs.stripe.com/connect/interactive-platform-guide.md?connect-charge-type=direct&connect-loss-liability-owner=platform) - [Identitätsprüfung bei verbundenen Konten](https://docs.stripe.com/connect/identity-verification.md) ## Karteninhaber/innen und Karten erstellen #### Eingebettet Bei [der Karteninhaberin/dem Karteninhaber](https://docs.stripe.com/api/issuing/cardholder/object.md) handelt es sich um den einzelnen Fahrer/die einzelne Fahrerin (d. h. der/die Mitarbeiter/in oder der/die Auftragnehmer/in), der/die von Ihrer Geschäftskundin/Ihrem Geschäftskunden autorisiert wurde, Karteneinzahlungen über den zugehörigen Saldo abzuwickeln. Das `Cardholder`-Objekt enthält relevante Details, wie z. B. einen [Namen](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-name), der auf den Karten angezeigt werden soll und eine [Rechnungsadresse](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-billing). Bei letzterer handelt es sich in der Regel um die Geschäftsadresse des verbundenen Kontos oder Ihrer Plattform. Verwenden Sie die eingebettete [Komponente der Liste der Issuing-Karten](https://docs.stripe.com/connect/supported-embedded-components/issuing-cards-list.md), um es Ihren verbundenen Konten zu ermöglichen, eine [Karte](https://docs.stripe.com/api/issuing/cards/object.md) für eine/n Karteninhaber/in zu erstellen und sie mit dem Finanzkonto zu verknüpfen. Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production. Aktivieren Sie [beim Erstellen einer Kontositzung](https://docs.stripe.com/api/account_sessions/create.md) die Komponente Kartenliste in Issuing, indem Sie `issuing_cards_list` im Parameter `components` angeben. Sie können einzelne Funktionen der Komponente Kartenliste in Issuing aktivieren oder deaktivieren, indem Sie den Parameter `features` unter `issuing_cards_list` angeben. ```curl curl https://api.stripe.com/v1/account_sessions \ -u "<>:" \ -d "account={{CONNECTEDACCOUNT_ID}}" \ -d "components[issuing_cards_list][enabled]=true" \ -d "components[issuing_cards_list][features][card_management]=true" \ -d "components[issuing_cards_list][features][cardholder_management]=true" \ -d "components[issuing_cards_list][features][card_spend_dispute_management]=true" \ -d "components[issuing_cards_list][features][spend_control_management]=true" ``` Nachdem die Kontositzung erstellt und [ConnectJS initiiert wurde](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions), können Sie die Komponente „Kartenliste in Issuing“ im Frontend anzeigen: #### JavaScript ```js // Include this element in your HTML const issuingCardsList = stripeConnectInstance.create('issuing-cards-list'); issuingCardsList.setShowSpendControls(true); container.appendChild(issuingCardsList); ``` Jetzt können Nutzer/innen auf **Karte erstellen** klicken, um mit der Erstellung einer neuen Karteninhaberin/eines neuen Karteninhabers und einer neuen Karte zu beginnen. Die Karte kann auf Nutzerseite während der Erstellung oder im Anschluss daran aktiviert werden. Zu diesem Zeitpunkt ist der Karteninhaberin/dem Karteninhaber und dem Finanzkonto eine aktive Karte zugeordnet. Auf der [Issuing-Seite](https://dashboard.stripe.com/issuing/overview) des verbundenen Kontos können Sie Informationen zu der Karte und der Karteninhaberin/dem Karteninhaber einsehen. Weitere Informationen finden Sie unter: - [Virtuelle Karten mit Issuing](https://docs.stripe.com/issuing/cards/virtual.md) - [Physische Karten](https://docs.stripe.com/issuing/cards/physical.md) - [Verwenden Sie das Dashboard für Issuing mit Connect](https://docs.stripe.com/issuing/connect.md#using-dashboard-issuing) - [Karten mit der API erstellen](https://docs.stripe.com/api/issuing/cards.md) #### API ### Karteninhaber/in erstellen Der/die [Karteninhaber/in](https://docs.stripe.com/api/.md#issuing_cardholder_object) ist die Einzelperson (d. h. Mitarbeiter/in oder Auftragnehmer/in), die befugt ist, Kartenfinanzierung durch das Issuing-Guthaben zu nutzen. Das Objekt `Cardholder` enthält relevante Details, wie einen auf Karten anzuzeigenden [Namen](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-name) und eine [Abrechnungs-](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-billing)Adresse, bei der es sich in der Regel um die Adresse des verbundenen Kontos oder Ihrer Plattform handelt. Mit dem folgenden API-Aufruf wird ein neuer `Cardholder` erstellt: ```curl curl https://api.stripe.com/v1/issuing/cardholders \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "name=Jenny Rosen" \ --data-urlencode "email=jenny.rosen@example.com" \ --data-urlencode "phone_number=+18008675309" \ -d status=active \ -d type=individual \ -d "individual[first_name]=Jenny" \ -d "individual[last_name]=Rosen" \ -d "individual[dob][day]=1" \ -d "individual[dob][month]=11" \ -d "individual[dob][year]=1981" \ -d "billing[address][line1]=123 Main Street" \ -d "billing[address][city]=San Francisco" \ -d "billing[address][state]=CA" \ -d "billing[address][postal_code]=94111" \ -d "billing[address][country]=US" ``` Stripe gibt ein `Cardholder`-Objekt zurück, das die von Ihnen angegebenen Informationen enthält und das Webhook-Ereignis `issuing_cardholder.created` sendet. ### Karte erstellen Erstellen Sie eine Karte und ordnen Sie diese der/dem `Cardholder` zu, die autorisierte Nutzerin bzw. der autorisierter Nutzer der Karte werden soll. In den folgenden Beispielen zeigen wir Ihnen, wie Sie eine [virtuelle Karte](https://docs.stripe.com/issuing/cards/virtual.md) erstellen. Im Live-Modus können Sie dann auch [physische Karten](https://docs.stripe.com/issuing/cards/physical.md) erstellen und an die Karteninhaber/innen versenden. ```curl curl https://api.stripe.com/v1/issuing/cards \ -u "<>:" \ -d currency=usd \ -d type=virtual \ -d "cardholder={{ISSUINGCARDHOLDER_ID}}" ``` Stripe gibt bei der Erstellung ein `Card`-Objekt zurück und übermittelt das Webhook-Ereignis `issuing_card.created`: ```json { "id": "ic_1NvPjF2SSJdH5vn2OVbE7r0b", "object": "issuing.card", "brand": "Visa", ... "status": "inactive", "type": "virtual" } ``` Sie müssen die Karte aktivieren, bevor ein/e Nutzer/in sie verwenden kann. Während Sie virtuelle Karten in demselben API-Aufruf aktivieren können, mit dem Sie sie erstellt haben, müssen Sie physische Karten separat aktivieren. Wenn Sie bereit sind, aktivieren Sie die Karte, indem Sie den `status` auf `active` festlegen: ```curl curl https://api.stripe.com/v1/issuing/cards/ic_1NvPjF2SSJdH5vn2OVbE7r0b \ -u "<>:" \ -d status=active ``` Zu diesem Zeitpunkt ist der Karteninhaberin/dem Karteninhaber eine aktive Karte zugeordnet. Auf der [Issuing-Seite](https://dashboard.stripe.com/issuing/overview) können Sie Informationen zu der Karte und der Karteninhaberin/dem Karteninhaber einsehen. ```json { "id": "ic_1NvPjF2SSJdH5vn2OVbE7r0b", "object": "issuing.card", "brand": "Visa", ... "status": "active", "type": "virtual" } ``` Weitere Informationen finden Sie unter: - [Virtuelle Karten](https://docs.stripe.com/issuing/cards/virtual.md) - [Physische Karten](https://docs.stripe.com/issuing/cards/physical.md) - [Verwenden Sie das Dashboard für Issuing mit Connect](https://docs.stripe.com/issuing/connect.md#using-dashboard-issuing) - [Karten mit der API erstellen](https://docs.stripe.com/api/issuing/cards.md) ## Karte verwenden Bei der Verwendung einer Karte für einen Kauf wird eine Autorisierungsanfrage erstellt, die in Echtzeit genehmigt oder abgelehnt werden kann: (See full diagram at https://docs.stripe.com/issuing/integration-guides/fleet) 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](https://docs.stripe.com/issuing/purchases/authorizations.md#handling-other-authorizations). ### 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](https://docs.stripe.com/api/issuing/authorizations/object.md)-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](https://docs.stripe.com/api/issuing/authorizations.md) erstellen: ```curl curl https://api.stripe.com/v1/test_helpers/issuing/authorizations \ -u "<>:" \ -d "card={{ISSUINGCARD_ID}}" \ -d amount=100 \ -d authorization_method=chip \ -d "fleet[cardholder_prompt_data][odometer]=42424" \ -d "fleet[purchase_type]=fuel_purchase" \ -d "fleet[service_type]=self_service" \ -d "merchant_data[category]=automated_fuel_dispensers" \ -d is_amount_controllable=true ``` Nach der Genehmigung erstellt Stripe eine `Authorization` im Status `pending`, während auf die [Erfassung](https://docs.stripe.com/issuing/purchases/transactions.md) gewartet wird. Der autorisierte `amount` ist der Standardbetrag, der für eine [Transaktion an Zapfsäulen](https://docs.stripe.com/issuing/purchases/authorizations.md#fuel-dispenser-authorizations) zurückgehalten wird, es sei denn, Sie haben in Ihrer Antwort auf den Webhook `issuing_authorization.request` einen anderen Teilautorisierungsbetrag angegeben. Notieren Sie sich die Autorisierungs-`id`, die Sie zur Erfassung der Gelder verwenden: ```json {"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: ```curl curl https://api.stripe.com/v1/test_helpers/issuing/authorizations/{{ISSUINGAUTHORIZATION_ID}}/finalize_amount \ -u "<>:" \ -d final_amount=1000 \ -d "fleet[cardholder_prompt_data][odometer]=42424" \ -d "fleet[purchase_type]=fuel_purchase" \ -d "fleet[reported_breakdown][fuel][gross_amount_decimal]=10.0" \ -d "fleet[reported_breakdown][non_fuel][gross_amount_decimal]=0" \ -d "fleet[reported_breakdown][tax][local_amount_decimal]=0.03" \ -d "fleet[service_type]=self_service" \ -d "fuel[industry_product_code]=001" \ -d "fuel[quantity_decimal]=5.0" \ -d "fuel[type]=unleaded_regular" \ -d "fuel[unit]=us_gallon" \ -d "fuel[unit_cost_decimal]=200" ``` Die `Authorization` verbleibt im Status `pending`, bis sie [erfasst](https://docs.stripe.com/issuing/purchases/transactions.md) wurde. Der Betrag wird aktualisiert, um die Gesamtmenge des ausgegebenen Kraftstoffs widerzuspiegeln, und zusätzliche flottenspezifische Felder sind jetzt verfügbar: ```json {"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: ```curl curl https://api.stripe.com/v1/test_helpers/issuing/authorizations/{{ISSUINGAUTHORIZATION_ID}}/capture \ -u "<>:" \ -d "purchase_details[fleet][cardholder_prompt_data][odometer]=42424" \ -d "purchase_details[fleet][purchase_type]=fuel_purchase" \ -d "purchase_details[fleet][reported_breakdown][fuel][gross_amount_decimal]=10.0" \ -d "purchase_details[fleet][reported_breakdown][non_fuel][gross_amount_decimal]=0" \ -d "purchase_details[fleet][reported_breakdown][tax][local_amount_decimal]=0.03" \ -d "purchase_details[fleet][service_type]=self_service" \ -d "purchase_details[fuel][industry_product_code]=001" \ -d "purchase_details[fuel][quantity_decimal]=5.0" \ -d "purchase_details[fuel][type]=unleaded_regular" \ -d "purchase_details[fuel][unit]=us_gallon" \ -d "purchase_details[fuel][unit_cost_decimal]=200" ``` Nachdem die Autorisierung erfasst wurde, erstellt Stripe eine [Transaktion](https://docs.stripe.com/issuing/purchases/transactions.md) in Issuing, deren `status` auf `closed` gesetzt wird. Als Nutzer/in mit einem kommerziellen Flottenkartenprogramm erhalten Sie bestimmte flottenbezogene Daten über die [Transaktion](https://docs.stripe.com/api/issuing/transactions.md), die beispielsweise für den Abgleich von Einkäufen erforderlich sind. ```json { "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" } } } ``` ## See also - [Ausgabenkontrollen](https://docs.stripe.com/issuing/controls/spending-controls.md) - [Autorisierungen in Issuing](https://docs.stripe.com/issuing/purchases/authorizations.md) - [Transaktionen in Issuing](https://docs.stripe.com/issuing/purchases/transactions.md) - [Arbeit mit Issuing-Karten und Treasury für Plattformen](https://docs.stripe.com/treasury/connect/account-management/issuing-cards.md) - [Transaktionsbetrug bekämpfen](https://docs.stripe.com/issuing/manage-fraud.md)