FlowAlp

Transactions auflisten und abrufen

July 30, 2026

Transaktionen in FlowAlp Pay auflisten, filtern und einzeln per ID abrufen – mit allen Statuswerten der Merchant API im Überblick.

Jede über FlowAlp Pay abgewickelte Zahlung wird als Transaction gespeichert. Die Merchant API stellt für diese Ressource zwei lesende Endpoints bereit: eine filterbare Liste sowie den Abruf eines einzelnen Datensatzes über seine numerische ID. Verwenden Sie für neue Integrationen die API-Version v1.16 und authentifizieren Sie jeden Aufruf mit dem Header x-api-key, wie unter Authentifizierung beschrieben.

Transactions auflisten

GEThttps://api.pay.flowalp.com/v1.16/Transaction/v1.14 · v1.15 · v1.16

Der Listen-Endpoint liefert die Transaktionen Ihrer Instance, sortiert nach Erstellungszeit. Kombinieren Sie die UTC-Datumsfilter mit limit und offset, um grosse Ergebnismengen seitenweise zu laden. Ausser instance sind alle Parameter optional.

Request-Parameter

ParameterTypBeschreibung
instancestring (erforderlich)Name Ihrer Instance (Tenant). Bestimmt das Konto, für das die Anfrage ausgeführt wird.
filterDatetimeUtcGreaterThandateUntere Grenze in UTC im Format YYYY-MM-DD HH:MM:SS. Es werden nur Transaktionen zurückgegeben, die nach diesem Zeitpunkt erstellt wurden.
filterDatetimeUtcLessThandateObere Grenze in UTC, gleiches Format.
filterMyTransactionsOnlybooleanStandard false. Bei Wert 1 werden nur Transaktionen zurückgegeben, die mit dem für diese Anfrage verwendeten API-Key erstellt wurden.
orderByTimestringASC (Standard) oder DESC — Sortierung nach dem Zeitpunkt der Transaktion.
offsetintegerAnzahl zu überspringender Zeilen, für die Paginierung.
limitintegerMaximale Anzahl zurückgegebener Zeilen.
Transaktionen auflistenbash
curl "https://api.pay.flowalp.com/v1.16/Transaction/?instance=<tenant>&orderByTime=DESC&limit=20&offset=0" \
  -H "x-api-key: <api-secret>"
Transaktionen auflisten (PHP SDK)PHP
<?php
use FlowAlpPay\FlowAlpPay;
use FlowAlpPay\Models\Request\Transaction;

$client = new FlowAlpPay(
    getenv('FLOWALP_TENANT'),
    getenv('FLOWALP_API_SECRET'),
    FlowAlpPay::DEFAULT_COMMUNICATION_HANDLER,
    'pay.flowalp.com',
    '1.16'
);

$request = new Transaction();
$request->setFilterDatetimeUtcGreaterThan(new DateTime('2026-07-01 00:00:00'));
$request->setFilterDatetimeUtcLessThan(new DateTime('2026-07-31 23:59:59'));
$request->setOrderByTime('DESC');
$request->setLimit(20);

try {
    $transactions = $client->getAll($request);
    foreach ($transactions as $transaction) {
        echo $transaction->getId() . ': ' . $transaction->getStatus() . PHP_EOL;
    }
} catch (Exception $e) {
    error_log('Listing transactions failed: ' . $e->getMessage());
}

Eine Transaction abrufen

GEThttps://api.pay.flowalp.com/v1.16/Transaction/{id}/v1.14 · v1.15 · v1.16
ParameterTypBeschreibung
idinteger (erforderlich)Path-Parameter: numerische ID der abzurufenden Transaktion. Sie erhalten sie bei der Erstellung der Transaktion und in jeder Webhook-Benachrichtigung.
instancestring (erforderlich)Query-Parameter: Name Ihrer Instance (Tenant).
Eine Transaktion abrufenbash
curl "https://api.pay.flowalp.com/v1.16/Transaction/4712/?instance=<tenant>" \
  -H "x-api-key: <api-secret>"
Eine Transaktion abrufen (PHP SDK)PHP
<?php
use FlowAlpPay\Models\Request\Transaction;

// $client: gleicher Konstruktor wie im Listen-Beispiel oben
$request = new Transaction();
$request->setId(4712);

try {
    $transaction = $client->getOne($request);
    echo $transaction->getStatus();
} catch (Exception $e) {
    error_log('Transaction lookup failed: ' . $e->getMessage());
}

Response

Beide Endpoints antworten mit einem Feld status und einem Array data; der Einzelabruf liefert ein Array mit genau einem Element. Beträge werden in Minor Units angegeben (6250 = CHF 62.50). refundable und partiallyRefundable zeigen an, welche Rückerstattungen aktuell möglich sind, und payoutUuid verknüpft die Transaktion mit der Auszahlung, in der sie abgerechnet wurde.

Beispiel-ResponseJSON
{
  "status": "success",
  "data": [
    {
      "id": 4712,
      "uuid": "f384000b",
      "status": "confirmed",
      "time": "2026-07-12 09:41:27",
      "lang": "de",
      "psp": "Native_PSP",
      "pspId": 26,
      "mode": "LIVE",
      "referenceId": "ORDER-2026-0815",
      "pageUuid": "892dcf5c",
      "payment": {
        "brand": "visa",
        "wallet": null
      },
      "payoutUuid": "AB12CD34",
      "invoice": {
        "currencyAlpha3": "CHF",
        "products": [
          { "quantity": 1, "name": "Hoodie", "amount": 5900 }
        ],
        "discount": null,
        "shippingAmount": 350,
        "totalAmount": 6250,
        "customFields": null
      },
      "refundable": true,
      "partiallyRefundable": true,
      "contact": {
        "id": 16,
        "uuid": "9c9c0282",
        "firstname": "Anna",
        "lastname": "Keller",
        "email": "anna.keller@example.com",
        "country": "Switzerland",
        "countryISO": "CH"
      }
    }
  ]
}

Statuswerte der Transaction

Das Feld status zeigt, an welchem Punkt des Lebenszyklus sich eine Transaktion befindet:

StatusBeschreibung
waitingDie Zahlung wurde gestartet, ist aber noch nicht abgeschlossen.
confirmedDie Zahlung war erfolgreich, der Betrag wurde belastet.
authorizedDas Zahlungsmittel wurde erfolgreich tokenisiert; es wurde noch kein Betrag belastet.
reservedEin Betrag wurde über eine Pre-Authorization reserviert.
refundedDer gesamte Betrag wurde dem Kunden zurückerstattet.
partially-refundedEin Teil des Betrags wurde dem Kunden zurückerstattet.
refund_pendingEine Rückerstattung wird gerade verarbeitet.
cancelledDie Zahlung wurde vom Kunden abgebrochen.
declinedDie Zahlung scheiterte an 3-D Secure oder wurde von der kartenausgebenden Bank abgelehnt.
chargebackDer Karteninhaber hat den Betrag über seine Bank zurückgefordert.
disputedFür diese Transaktion wurde ein Dispute eröffnet.
errorBei der Verarbeitung ist ein technisches Problem aufgetreten.
expiredDie Zahlung wurde wegen Inaktivität abgebrochen.

Fehler

HTTP-StatusBedeutung
400Fehlerhafte Anfrage — das Feld message im Fehler-Body beschreibt das genaue Problem.
404Auf dieser Instance existiert keine Transaktion mit der angegebenen ID.

Fehler-Responses haben die Form {"status": "error", "message": "..."}.

Die Operationen nach der Zahlung — Charge, Capture, Refund und Storno — finden Sie unter Charge, Capture, Refund und Storno von Transactions. Wie bestätigte Transaktionen auf Ihr Bankkonto gelangen, erklärt die Payouts-API; Statusänderungen in Echtzeit erhalten Sie über Webhook-Ereignisse.