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.