Skip to content
ONE LOOP / Documentation / Apps & connections

The source documentation is currently available in German. No English translation is implied.

Apps & connections

Stripe: Kauf abgeschlossen

Verstehe produktbezogene bezahlte Käufe, ihre vollständigen Variablen und die Regeln für Beträge in kleinster Währungseinheit.

Vorbereitete Anleitung auf Basis des Implementierungsstands. Die vollständige Verbindung und Ausführung im vorgesehenen Standort sind noch nicht allgemein bestätigt. Nutze diese Schritte erst, wenn die App und ihre Funktionen für deinen Standort ausdrücklich bereitstehen.

Ein positiver erfolgreich bezahlter Vorgang mit belastbaren Produkt-/Preispositionen löst Purchase aus. One-time Checkout, erste Abozahlung, Verlängerung und bezahlte Produktrechnung sind zu unterscheiden. Ein produktloser PaymentIntent ist kein produktbezogener Kauf. Nullbeträge, unbezahlter verzögerter Checkout, Setup, reine Autorisierung und Fehlzahlung lösen diesen Zahlung/Kaufpfad nicht aus.

Daten und Einheiten

Alle Stripe-Amountfelder dieses Vertrags sind Integer in kleinster Währungseinheit (amountUnit=minor). Zur Anzeige in der Hauptwährung die korrekte Währungsregel verwenden; nicht pauschal dieselbe Dezimalstellenzahl für jede Währung annehmen. Die currency gehört zum Betrag. Quellenzeit und Beobachtungszeit getrennt verwenden.

Alle Variablen des direkten Vertrags

Das registrierte Sample ist eine Feldvorlage. Optionale Werte sind nicht bei jedem Ereignis vorhanden.

Variable

Typ

Bedeutung / sichere Verwendung

locationId

Text

Zugeordneter Standort.

stripeAccountId

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

stripeAccountName

Text

Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen.

stripeCustomerId

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

customerEmail

Text

Verfügbare Käufer-E-Mail; kann leer sein.

customerName

Text

Verfügbarer Käufername; nicht als sichere Identität verwenden.

livemode

Wahr/Falsch

Kennzeichnet den tatsächlichen Live-Modus.

stripeMode

Text

live, test oder sandbox; getrennt behandeln.

purchaseType

Text

Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen.

checkoutSessionId

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

paymentIntentId

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

chargeId

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

invoiceId

Text; optional/leer möglich

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

subscriptionId

Text; optional/leer möglich

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

currency

Text

Währung des Belegs oder Ereignisses.

amountUnit

Text

minor: Beträge sind in kleinster Währungseinheit.

amountSubtotal

Zahl

Betragswert gemäß der auf dieser Seite beschriebenen Einheit.

amountDiscount

Zahl

Betragswert gemäß der auf dieser Seite beschriebenen Einheit.

amountTax

Zahl

Betragswert gemäß der auf dieser Seite beschriebenen Einheit.

amountTotal

Zahl

Betragswert gemäß der auf dieser Seite beschriebenen Einheit.

amountRefunded

Zahl

Erstatteter Betrag in kleinster Währungseinheit.

amountNetAfterRefund

Zahl

Betrag nach Erstattungen in kleinster Währungseinheit.

productCount

Zahl

Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen.

productIds

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

productNames

Text

Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen.

priceIds

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

quantities

Text

Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen.

itemsJson

Text

Positionsdaten als JSON-Text; vor Einzelpositionszugriff parsen.

matchedProductId

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

matchedProductName

Text

Benannter Ereignis-/Dokumentwert; anhand des konkreten Laufs prüfen, optionale Werte nicht voraussetzen.

matchedPriceId

Text

Technische Referenz des benannten Objekts; keine sichtbare Nummer.

purchasedAt

Text

Datums-/Zeitwert des benannten Vorgangs; vor Anzeige passend formatieren.

payloadVersion

Text

Version der Ereignisdaten; direkten und älteren Vertrag unterscheiden.

sourceEventId

Text

Originale Ereigniskennung.

sourceEventType

Text

Ursprünglicher Ereignistyp.

sourceObjectId

Text

Referenz des Quellobjekts.

sourceOccurredAt

Text

Zeitpunkt des Quellereignisses.

observedAt

Text

Zeitpunkt des autoritativen Abgleichs.

canonicalPaymentId

Text

Gemeinsame wirtschaftliche Zahlungsreferenz.

amountReceived

Zahl

Tatsächlich erhaltener Betrag in kleinster Währungseinheit.

Weiterverarbeitung

itemsJson, eventItemsJson oder subscriptionItemsJson nur bei tatsächlichem Bedarf parsen. Produkt-IDs/Namen/Preis-Summaries nicht positionsweise miteinander verknüpfen; für Positionen die kanonischen Items verwenden. customerEmail kann leer sein. Verwende Sourceereignis und wirtschaftliche Zahlungsreferenz für Zuordnung, ohne daraus eine pauschale Exactly-once-Garantie abzuleiten.

Sicher mit Variablen arbeiten

Wähle jede Variable im Variablen-Picker des konkreten Workflow-Schritts. Technische IDs sind für Verknüpfungen, sichtbare Belegnummern für Nachrichten. Keine selbst geratenen Schrittnummern oder Zugangsdaten in Felder kopieren. Prüfe leere Werte und Datentypen vor Folgeaktionen.

Fehler und Wiederholung

Prüfe bei einem Fehler zuerst Standort, Verbindung, Pflichtfelder, Kundenzuordnung, Währung und Steuerdaten. Ein Timeout beweist nicht, dass kein Dokument entstanden ist. Bei unklarem externem Ergebnis zuerst den bestehenden Lauf und den Beleg abgleichen; nicht mit neuer Vorgangskennung nochmals erstellen. Für denselben Vorgang denselben stabilen Schlüssel verwenden. Support benötigt Zeitpunkt, Standort, Action/Trigger, Request- oder Ereigniskennung und Fehlermeldung, niemals API-Schlüssel oder Tokens.

← Back to articles