Auszahlungen und Abstimmung

Wenn ein Kunde über FlowAlp Pay bezahlt, landet das Geld nicht sofort auf Ihrem Bankkonto: Es wird zunächst in Ihrem FlowAlp Pay Guthaben gesammelt und dann als Auszahlung (Payout) an Sie überwiesen. Dieser Guide erklärt, wie diese Abwicklung funktioniert, was eine Auszahlung enthält und wie Sie Auszahlungen mit Ihren Bestellungen und dem Bankauszug abstimmen — manuell im Dashboard oder automatisiert über die API.

So werden Ihre Einnahmen abgewickelt#

Jede bestätigte Zahlung erhöht Ihr Guthaben um den Transaktionsbetrag abzüglich der Transaktionsgebühr. Zum Auszahlungszeitpunkt bündelt FlowAlp Pay die aufgelaufene Aktivität in einer einzigen konsolidierten Auszahlung und überweist sie auf das für Ihr Konto hinterlegte Bankkonto (IBAN). Eine Auszahlung umfasst deshalb in der Regel viele Transaktionen plus die zugehörigen Gebührenpositionen und trägt einen statement-Text, der auf Ihrem Bankauszug erscheint, ein Auszahlungsdatum (date), eine currency sowie die Zielkontodaten (destination) — alles, was Sie zum Abgleich der Bankgutschrift brauchen.

Der Lebenszyklus einer Auszahlung#

Was eine Auszahlung enthält#

In einer Auszahlung finden Sie eine Liste von Transfers. Die meisten Einträge sind vom Typ transaction: Sie führen den Bruttobetrag der Zahlung und die abgezogene Transaktionsgebühr als getrennte Items auf, dazu die uuid und die reference_id der Transaktion (Ihre Bestellnummer). Weitere Transfer-Typen decken Auszahlungsgebühren, Korrekturen, Disputes und Reserven ab. Alle Beträge sind in Minor Units, und die Items eines Transfers summieren sich immer zu seinem Nettobetrag — eine Zahlung über CHF 300.00 mit CHF 3.00 Gebühr erscheint als 30000 und -300 und trägt 29700 zur Auszahlung bei.

Auszahlungen mit der Buchhaltung abstimmen#

1. Listen Sie die Auszahlungen der Periode über die Payouts-API auf und wählen Sie die Auszahlung, die zur Bankgutschrift passt (gleiches Datum, gleicher Betrag, gleicher statement-Text).
2. Laden Sie ihre Transfers seitenweise über den Details-Endpoint — empfohlen ist eine Seitengrösse von 100 Einträgen.
3. Ordnen Sie jeden transaction-Transfer über reference_id oder die Transaktions-uuid einer Bestellung in Ihrem System zu.
4. Verbuchen Sie die Gebührenpositionen (transaction-fee, payout-fee) separat, damit Bruttoumsatz und Kosten unterscheidbar bleiben.
5. Prüfen Sie, dass die Summe aller Transfers dem amount der Auszahlung und der Gutschrift Ihrer Bank entspricht.

Die Verknüpfung funktioniert auch in der Gegenrichtung: Jede abgerechnete Transaktion trägt eine payoutUuid, sodass Sie von einer Bestellung ausgehend die zugehörige Auszahlung finden — siehe Transactions auflisten und abrufen. Für manuelle Kontrollen zeigt Ihr FlowAlp Pay Dashboard unter https://pay.flowalp.com dieselben Auszahlungsdaten.

curl "https://api.pay.flowalp.com/v1.16/Payout/C6B438B9/details?instance=<tenant>&limit=100&offset=0" \
  -H "x-api-key: <api-secret>"

Auszahlungen automatisiert überwachen#

Statt zu pollen, lassen Sie sich von FlowAlp Pay benachrichtigen: Webhook-Benachrichtigungen werden versendet, wenn eine Auszahlung die Status processing, sent oder failed erreicht (für initiated, pending und under-review werden keine gesendet). Das ist der einfachste Auslöser für einen automatisierten Abstimmungslauf — siehe Webhooks konfigurieren.