# Issuing für Agenten Erfahren Sie, wie Sie Karten für Agenten ausstellen. Mit Issuing für Agenten können Sie virtuelle Karten ausstellen, die Agenten nutzen können, um eigenständig Käufe zu tätigen, mit Ausgabenkontrollen, Autorisierungsentscheidungen in Echtzeit und voller Transaktionstransparenz. Bevor Ihr Agent einen Kauf tätigt, können Sie entscheiden, was er wofür und in welcher Höhe ausgeben darf. Die Karten sind durch Finanzkonten gedeckt und werden über Stripe Issuing-APIs ausgestellt. ## „Issuing für Agenten“-Produkte Sie können Issuing für Agenten mit den folgenden Issuing-Produkten verwenden: | Produkt | Beschreibung | Zugriff anfordern | | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | | Karten für Ihr eigenes Unternehmen | Verwenden Sie Issuing, um jedem Agenten eine eigene virtuelle Karte mit individuellen Ausgabenlimits, Händlerkategorie-Kontrollen und benutzerdefinierten Autorisierungsregeln zuzuweisen. Häufige Anwendungsfälle umfassen den Kauf von Inventar zum Weiterverkauf, die Deckung von Betriebsausgaben und Käufe zur Ausführung einer Dienstleistung. | [Im Stripe-Dashboard anwenden](https://dashboard.stripe.com/issuing/overview) | | Karten für Ihre Plattform | Wenn Sie eine Plattform betreiben, z. B. FinTech, Vertical SaaS oder einen Marktplatz, können Sie Agenten mithilfe von Issuing ermöglichen, im Namen von Unternehmen oder Verbraucher/innen auf Ihrer Plattform Ausgaben tätigen lassen. Stellen Sie gewerbliche Karten für Geschäftskunden aus, die Ausgaben verwalten, oder Verbraucherkarten für Privatpersonen, die private Käufe tätigen. Ihre Karteninhaber/innen konfigurieren ihre eigenen Ausgabenlimits, Einschränkungen für Händlerkategorien und Autorisierungsregeln. Sie behalten die Transparenz auf Transaktionsebene über alle von Ihrer Plattform ausgestellten Karten bei. | [Stripe kontaktieren](https://stripe.com/contact/embedded-finance) | ## „Issuing für Agenten“-Funktionen | Funktion | Beschreibung | | ----------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [Einmalkarten](https://docs.stripe.com/issuing/controls/lifecycle-controls.md) | Stellen Sie virtuelle Karten für eine einzelne Aufgabe oder Sitzung aus. Die Karten werden nach der Nutzung automatisch ungültig. | | [Autorisierungen in Echtzeit](https://docs.stripe.com/issuing/controls/real-time-authorizations.md) | Mithilfe von Webhooks können Sie jede Transaktion genehmigen oder ablehnen. Treffen Sie Autorisierungsentscheidungen auf der Grundlage der Unternehmensdaten und der Metadaten der Karte. Die Integration der Autorisierung liegt in Ihrer Verantwortung. | | [Ausgabenkontrollen](https://docs.stripe.com/issuing/controls/spending-controls.md#limit-a-cardholders-monthly-spend-across-all-of-their-cards) | Legen Sie Limits dafür fest, wie viel und wie oft Verbraucher/innen Geld ausgeben können und welche Händlerkategorien zulässig sind. Sie können Kontrollen auf Karten- oder Karteninhaberebene festlegen. | | [Vollständige Transparenz von Transaktionen](https://docs.stripe.com/issuing/purchases/transactions.md) | Verfolgen Sie jede Transaktion, einschließlich Erfassungen, Rückerstattungen, anteilige Erfassungen, Übererfassungen und erzwungenen Erfassungen, und gleichen Sie diese mithilfe von Metadaten mit der ursprünglichen Karte und dem Kauf ab. | | [Erweiterte Betrugssignale](https://docs.stripe.com/issuing/controls/advanced-fraud-tools.md#get-started-with-advanced-fraud-tooling) | Erhalten Sie durch maschinelles Lernen generierte Risikobewertungen zu jeder Autorisierung, einschließlich Betrugsrisiko, Risiko von Händlerstreitfällen und Kartentests. Die Aktivierung erfolgt im Stripe-Dashboard. | ## Virtuelle Karten Virtuelle Karten sind die häufigste Kartenart für agentenbasierte Anwendungsfälle. Sie bestehen nur aus Kartennummer, Gültigkeitsdatum (Gültig bis) und CVC, ohne physische Darstellung. Wenn Sie eine ausstellen, kann ein Agent sofort Käufe tätigen. Da sie digital sind, können Sie die Funktionalität der Karte vor der Nutzung durch den Agenten auf ein einzelnes Unternehmen, eine einzelne Transaktion oder einen bestimmten Betrag beschränken. Verwenden Sie zunächst diesen Aufruf, um eine virtuelle Karte auszustellen, die auf eine bestimmte Händlerkategorie und ein bestimmtes Ausgabenlimit beschränkt ist: ```curl curl https://api.stripe.com/v1/issuing/cards \ -u "{{SECRET_KEY}}:" \ -d "cardholder"="ich_123" \ -d "currency"="usd" \ -d "type"="virtual" \ -d "status"="active" \ -d "spending_controls[allowed_categories][]"="computer_software_stores" \ -d "spending_controls[spending_limits][0][amount]"=50000 \ -d "spending_controls[spending_limits][0][interval]"="monthly" ``` Rufen Sie anschließend die Kartennummer und die CVC ab und geben Sie diese beim Bezahlvorgang an Ihren Agenten weiter: ```curl curl -G https://api.stripe.com/v1/issuing/cards/ic_123 \ -u "{{SECRET_KEY}}:" \ -d "expand[]"=number \ -d "expand[]"=cvc ``` Die Antwort enthält die Kartenanmeldedaten, die Ihr Agent benötigt, um einen Kauf abzuschließen: ```json { "id": "ic_123", "number": "4242424242424242", "cvc": "123", "exp_month": 12, "exp_year": 2027, "status": "active" } ``` ## Einmalkarten Für einmalige Käufe, wie z. B. eine Lieferantenzahlung, eine Ausführungsbestellung oder eine Kundentransaktion, können Sie eine Karte ausstellen, die nach dem Clearing einer einzigen Autorisierung automatisch storniert wird. Das bedeutet, dass die Kartenanmeldedaten, selbst wenn sie nach dem Kauf kompromittiert werden, nicht erneut verwendet werden können. Verwenden Sie Metadaten, um jede Karte mit der spezifischen Aufgabe, Bestellung oder dem Agenten zu verknüpfen, der sie ausgelöst hat. Verwenden Sie zunächst diese Methode, um eine Karte auszustellen, die sich nach einer erfolgreichen Abbuchung in einer bestimmten Höhe selbst storniert: ```curl curl https://api.stripe.com/v1/issuing/cards \ -u "{{SECRET_KEY}}:" \ -d "cardholder"="ich_123" \ -d "currency"="usd" \ -d "type"="virtual" \ -d "status"="active" \ -d "lifecycle_controls[cancel_after][payment_count]"=1 \ -d "spending_controls[spending_limits][0][amount]"=7500 \ -d "spending_controls[spending_limits][0][interval]"="per_authorization" \ -d "metadata[agent_id]"="agent_fulfillment_01" \ -d "metadata[customer_order_id]"="order_8821" \ -d "metadata[supplier]"="supplier_logistics_co" ``` Rufen Sie anschließend die Kartenanmeldedaten ab und geben Sie sie beim Bezahlvorgang an Ihren Agenten weiter: ```curl curl -G https://api.stripe.com/v1/issuing/cards/ic_123 \ -u "{{SECRET_KEY}}:" \ -d "expand[]"=number \ -d "expand[]"=cvc ``` ## Ausgabenkontrollen Bevor ein Agent einen Kauf tätigt, können Sie festlegen, was er wo und wie oft ausgeben darf. Diese Kontrollen werden bei der Kartenerstellung eingerichtet und können jederzeit aktualisiert werden. Sie können sie verschärfen, wenn sich der Umfang einer Aufgabe ändert, sie lockern, wenn mehr Budget genehmigt wird, oder sie für vertrauenswürdige Agenten mit weitreichenden Befugnissen aufheben. Händlerkategorie-Kontrollen beschränken die Karte auf bestimmte Arten von Unternehmen. Ein Reisebuchungsagent sollte beispielsweise nur Zahlungen bei Fluggesellschaften und Hotels abbuchen können, jedoch nicht in Restaurants oder im Einzelhandel: ```curl curl https://api.stripe.com/v1/issuing/cards \ -u "{{SECRET_KEY}}:" \ -d "cardholder"="ich_123" \ -d "currency"="usd" \ -d "type"="virtual" \ -d "status"="active" \ -d "spending_controls[allowed_categories][]"="airlines_air_carriers" \ -d "spending_controls[allowed_categories][]"="hotels_motels_and_resorts" ``` Ausgabenlimits legen fest, mit welchem Betrag die Karte belastet werden darf – entweder pro Transaktion oder über einen rollierenden Zeitraum: ```curl curl https://api.stripe.com/v1/issuing/cards/ic_123 \ -u "{{SECRET_KEY}}:" \ -d "spending_controls[spending_limits][0][amount]"=100000 \ -d "spending_controls[spending_limits][0][interval]"="monthly" \ -d "spending_controls[spending_limits][1][amount]"=10000 \ -d "spending_controls[spending_limits][1][interval]"="per_authorization" ``` ## Autorisierung in Echtzeit Nachdem Sie eine Karte an einen Agenten übergeben haben, löst jeder Kaufversuch eine Echtzeit-Autorisierungsanfrage aus, bevor die Abbuchung durchgeht. So können Sie die Transaktion basierend auf Ihren Ausgabenregeln, Betrugssignalen, Händlerkategorie-Einschränkungen oder dem Kontext der dem Agenten zugewiesenen Aufgabe genehmigen oder ablehnen. Achten Sie zunächst auf die Ereignisse `issuing_authorization.request`. Jedes Ereignis enthält das Unternehmen, den Betrag und alle Metadaten, die Sie der Karte bei der Ausstellung beigefügt haben. Es gibt ein Standard-Zeitlimit von 2 Sekunden für die Beantwortung, bevor Stripe auf die Standardregeln der Karte zurückgreift: ```json { "type": "issuing_authorization.request", "data": { "object": { "id": "iauth_123", "amount": 9900, "merchant_data": { "name": "Acme Supplies", "category_code": "5045", "city": "San Francisco", "country": "US" }, "card": { "metadata": { "agent_id": "agent_fulfillment_01", "customer_order_id": "order_8821", "allowed_merchant": "supplier_acme" } } } } } ``` Verwenden Sie anschließend das Autorisierungs-Payload, um alle Prüfungen durchzuführen, die Ihr Unternehmen vor der Genehmigung verlangt. Zu den gängigen Mustern gehören: - **Unternehmensabgleich**: Überprüfen Sie, ob der Unternehmensname oder die Kategorie mit der Aufgabe des Agenten übereinstimmt. - **Betragsbestätigung**: Bestätigen Sie, dass die Zahlung innerhalb des erwarteten Budgets für die Bestellung oder Aufgabe liegt. - **Geschwindigkeitsprüfung**: Markieren Sie, ob der Agent in einem kurzen Zeitraum eine ungewöhnliche Anzahl von Transaktionen versucht hat. - **Betrugssignale**: Gleichen Sie das Land, die IP-Adresse oder die Kategorie des Unternehmens mit bekannten Betrugsmustern ab. Wenn die Transaktion legitim aussieht, genehmigen Sie sie. Wenn etwas ungewöhnlich erscheint, lehnen Sie die Transaktion ab und melden Sie sie beim Agenten oder bei einer menschlichen Prüfperson. Sie können die erweiterten Betrugsbekämpfungstools von Stripe nutzen, um Ihren eigenen Prozess der Entscheidungsfindung zu verbessern. Stripe bewertet jede Autorisierung auf Betrugssignale und erstellt eine Risikobewertung, die Sie in Ihre Genehmigungslogik einbeziehen können: ```json { "type": "issuing_authorization.request", "data": { "object": { "id": "iauth_123", "amount": 9900, "fraud_challenges": [], "network_risk_score": 23, "merchant_data": { "name": "Acme Supplies", "category_code": "5045" }, "verification_data": { "address_line1_check": "match", "postal_code_check": "match", "cvc_check": "match" } } } } ``` Eine niedrige Risikobewertung in Kombination mit erfolgreichen Adressen- und CVC-Prüfungen ist ein Signal für die Genehmigung. Eine hohe Risikobewertung, insbesondere in Kombination mit einer nicht übereinstimmenden Adresse oder einem unbekannten Land des Unternehmens, ist ein Signal für die Ablehnung und Prüfung der Zahlung, bevor der Agent fortfahren kann. ## Transaktionen des Agenten überwachen Jede von Ihrem Agenten getätigte Transaktion ist nachverfolgbar. Nutzen Sie die Webhooks und Transaktionsdaten von Stripe, um Ausgaben zu verfolgen, Anomalien zu erkennen, Käufe abzugleichen und überhöhte Abbuchungen automatisch anzufechten, ohne dass eine manuelle Aufsicht erforderlich ist. ### Ungewöhnliche Ausgaben erkennen Agenten können den Transaktionsverlauf kontinuierlich überprüfen, um ungewöhnliche Käufe zu erkennen, z. B. Abbuchungen von unbekannten Unternehmen, Transaktionen, die übliche Beträge überschreiten, oder Aktivitäten außerhalb der erwarteten Zeiten. Wenn ein Agent eine verdächtige Transaktion erkennt, kann er die Karte automatisch sperren oder zur Prüfung vormerken. Ziehen Sie zunächst per Pull-Methode die aktuellen Transaktionen für eine/n Karteninhaber/in heran, um Ihrem Agenten ein Aktivitätsfenster zur Überprüfung zu geben: ```curl curl -G https://api.stripe.com/v1/issuing/transactions \ -u "{{SECRET_KEY}}:" \ -d "cardholder"="ich_123" \ -d "limit"=100 ``` Übergeben Sie anschließend die Transaktionsliste an Ihren Agenten. Kennzeichnen Sie jede Transaktion, bei der die Händlerkategorie außerhalb des erwarteten Bereichs liegt oder bei der der Betrag deutlich über dem historischen Durchschnitt des/der Karteninhabers/-inhaberin liegt: ```json { "transactions": [ { "amount": 42000, "merchant_data": { "category_code": "5999", "name": "Unknown Merchant" }, "card": { "metadata": { "agent_id": "agent_finance_01", "cost_center": "engineering" } } } ] } ``` Wenn der Agent eine Transaktion meldet, sperren Sie die Karte sofort, während das Problem untersucht wird: ```curl curl https://api.stripe.com/v1/issuing/cards/ic_123 \ -u "{{SECRET_KEY}}:" \ -d "status"="inactive" ``` ### Ausgaben anhand von Budgets nachverfolgen Jede Karte kann mit einem Ausgabenlimit – einem monatlichen Höchstbetrag, einem Höchstbetrag pro Transaktion oder beidem – versehen sein. Agenten können in Echtzeit überwachen, wie viel von diesem Budget verwendet wurde, und Maßnahmen ergreifen, bevor ein Limit erreicht wird, indem sie die Karteninhaber/innen benachrichtigen, eine Budgeterhöhung beantragen oder neue Käufe blockieren, bis der nächste Zeitraum zurückgesetzt wird. Abonnieren Sie zunächst `issuing_authorization.created`, um jeden Kauf bei dessen Genehmigung zu erfassen: ```json { "type": "issuing_authorization.created", "data": { "object": { "amount": 15000, "card": { "spending_controls": { "spending_limits": [{ "amount": 50000, "interval": "monthly" }] }, "metadata": { "agent_id": "agent_finance_01" } } } } } ``` Sobald Autorisierungen eingehen, addieren Sie diese zum monatlichen Limit der Karte. Wenn die Ausgaben einen Schwellenwert überschreiten (z. B. 80 %), benachrichtigen Sie die Karteninhaber/innen oder passen Sie das Limit an: ```curl curl https://api.stripe.com/v1/issuing/cards/ic_123 \ -u "{{SECRET_KEY}}:" \ -d "spending_controls[spending_limits][0][amount]"=40000 \ -d "spending_controls[spending_limits][0][interval]"="monthly" ``` ### Einkäufe automatisch abgleichen Nachdem ein Einkauf abgerechnet wurde – in der Regel innerhalb von 1–2 Tagen nach der ursprünglichen Autorisierung – erstellt Stripe einen Transaktionsdatensatz mit dem endgültigen Betrag und den Unternehmensdetails. Agents können damit Abbuchungen automatisch den Aufgaben oder Bestellungen zuordnen, die sie ausgelöst haben, Abweichungen zwischen dem abgerechneten Betrag und dem autorisierten kennzeichnen, und Ihre Buchhaltung ohne manuellen Eingriff aktuell halten. Abonnieren Sie zunächst `issuing_transaction.created`, um jedes Mal eine Benachrichtigung zu erhalten, wenn eine Abbuchung vollständig abgerechnet wird: ```json { "type": "issuing_transaction.created", "data": { "object": { "amount": 7500, "merchant_data": { "name": "Logistics Co", "category_code": "4215" }, "card": { "metadata": { "customer_order_id": "order_8821", "agent_id": "agent_fulfillment_01" } } } } } ``` Verwenden Sie die Metadaten der Transaktion, um sie der ursprünglichen Bestellung oder Aufgabe in Ihrem System zuzuordnen. Wenn der abgerechnete Betrag vom ursprünglich autorisierten abweicht, merken Sie ihn zur Prüfung vor: ```curl curl https://api.stripe.com/v1/issuing/transactions \ -u "{{SECRET_KEY}}:" \ -d "cardholder"="ich_123" \ -d "created[gte]"=1672531200 ``` ### Überhöhte Abbuchungen erkennen und anfechten Wenn eine Karte verwendet wird, erstellt Stripe zunächst eine Autorisierung für den erwarteten Betrag. Sobald die Abbuchung vollständig abgerechnet ist, erstellt Stripe eine Transaktion – und die beiden Beträge stimmen nicht immer überein. Ein Restaurant könnte ein Trinkgeld hinzufügen, ein Lieferant könnte eine Teilbestellung versenden, aber den vollen Betrag berechnen, oder ein Unternehmen könnte den falschen Betrag abwickeln. Agenten können automatisch vergleichen, was autorisiert wurde und was tatsächlich abgebucht wurde, und in Ihrem Namen einen Streitfall einreichen, wenn es eine Abweichung gibt. Wenn eine Transaktion abgerechnet wird, rufen Sie die ursprüngliche Autorisierung ab, um die Beträge zu vergleichen: ```curl curl https://api.stripe.com/v1/issuing/authorizations/iauth_123 \ -u "{{SECRET_KEY}}:" ``` Ihr Agent vergleicht den autorisierten Betrag mit dem abgerechneten Transaktionsbetrag. Wenn die Differenz einen von Ihnen definierten Schwellenwert überschreitet, wird die Transaktion gemeldet und ein Streitfall eingeleitet: ```json { "authorization_amount": 7500, "transaction_amount": 9200, "delta": 1700, "card": { "metadata": { "customer_order_id": "order_8821", "agent_id": "agent_fulfillment_01" } } } ``` Sie können auch direkt einen Streitfall gegen die Transaktion einleiten: ```curl curl https://api.stripe.com/v1/issuing/disputes \ -u "{{SECRET_KEY}}:" \ -d "transaction"="ipi_123" \ -d "evidence[reason]"="canceled" \ -d "evidence[incorrect_amount][dispute_amount]"=7500 \ -d "evidence[incorrect_amount][original_transaction]"="ipi_123" ``` Abonnieren Sie anschließend `issuing_dispute.updated`, um den Status offener Streitfälle zu verfolgen und den Karteninhaber/die Karteninhaberin zu benachrichtigen, wenn ein Streitfall gelöst und der Betrag zurückerstattet wurde: ```json { "type": "issuing_dispute.updated", "data": { "object": { "status": "won", "amount": 1700, "transaction": "ipi_123" } } } ``` ## See also - [Issuing für Ihr Unternehmen](https://docs.stripe.com/issuing/for-your-business.md) - [Issuing für Ihre Plattform](https://docs.stripe.com/issuing.md) - [Agenten-Ausgaben für persönliche Aufwendungen](http://link.com/agents)