Stripe-Transaktionen in Envoix

Envoix erfasst automatisch alle Stripe-Transaktionen. Die weitere Verarbeitung – insbesondere die Übertragung ins Buchhaltungssystem – hängt jedoch vom Status der Transaktion in Stripe ab.

Wann wird eine Transaktion verbucht?

Ausschlaggebend ist die Balance Transaction (die tatsächliche Bewegung auf dem Stripe-Konto). Erst wenn diese den Status «available» (verfügbar) hat, wird:

• ✅ Ein Wertstellungsdatum vergeben.
• ✅ Die Transaktion ins Buchhaltungssystem übertragen.

---

Beispiel: Balance Transaction (JSON)

Im folgenden Beispiel hat die Transaktion noch den Status «pending» (ausstehend). Solange dieser Status nicht auf «available» wechselt, wird die Transaktion nicht verbucht.

{
  "id": "txn_3SP9oKRqvWc6M8Pc1uBgXNZY",
  "object": "balance_transaction",
  "amount": 36423,          // Bruttobetrag (in Cent, z. B. 364,23 €)
  "available_on": 1762387200, // Zeitstempel: Wann der Betrag verfügbar ist
  "balance_type": "payments",
  "created": 1762122704,    // Erstellungsdatum (Unix-Timestamp)
  "currency": "eur",
  "exchange_rate": 0.867204, // Wechselkurs (falls Währungsumrechnung)
  "fee": 1937,              // Gesamtgebühren (19,37 €)
  "fee_details": [
    {
      "amount": 1209,       // Stripe-Transaktionsgebühr (12,09 €)
      "description": "Stripe processing fees",
      "type": "stripe_fee"
    },
    {
      "amount": 728,        // Währungsumrechnungsgebühr (7,28 €)
      "description": "Stripe currency conversion fee",
      "type": "stripe_fee"
    }
  ],
  "net": 34486,            // Nettobetrag nach Gebühren (344,86 €)
  "reporting_category": "charge",
  "source": "ch_3SP9oKRqvWc6M8Pc14VSuwXE", // Verknüpfte Charge-ID
  "status": "pending",     // ⚠️ WICHTIG: Nur "available" wird verbucht!
  "type": "charge"
}

---

Wichtige Felder im Überblick

Feld	Bedeutung
status	Muss «available» sein, damit die Transaktion verbucht wird.
available_on	Zeitstempel, wann der Betrag verfügbar ist (Wertstellungsdatum).
net	Der tatsächliche Betrag nach Gebühren (wird gebucht).
fee_details	Aufschlüsselung der Stripe-Gebühren (z. B. Transaktionskosten, Währungsumrechnung).

---

Warum ist das wichtig?

• «Pending»-Transaktionen sind noch nicht endgültig – sie könnten noch storniert oder rückgängig gemacht werden.
• Nur «available»-Transaktionen sind sicher verbuchbar.
• Envoix überträgt automatisch alle Transaktionen, sobald sie diesen Status erreichen.

---

Falls Fragen auftauchen oder eine Transaktion ungewöhnlich lange im Status «pending» bleibt, prüfen Sie bitte den Stripe-Dashboard-Verlauf oder kontaktieren Sie den Support.