Zum Inhalt

getPayInTransactions

Eingehende Zahlungstransaktionen auflisten (von Kunden empfangenes Geld).

Request

POST /api/v2/getPayInTransactions

Headers

Header Erforderlich Beschreibung
token Ja Ihre API Key
Content-Type Ja application/json

Body-Parameter

Feld Typ Erforderlich Standard Beschreibung
limit integer Nein 200 Maximale Ergebnisse (max: 1000)
search string Nein — Suche nach recipient_note oder pay_id
date string Nein — Filter nach Datum (YYYY-MM-DD)
since integer Nein — Transaktionen der letzten N Tage
pay_id integer Nein — Spezifische Transaktion abrufen

Antwort

Erfolg

{
  "data": [
    {
      "pay_id": "99250",
      "creator_id": "b44c4429-4a7b-4e27-85af-c1c2f43f4ffe",
      "user_id": "b44c4429-4a7b-4e27-85af-c1c2f43f4ffe",
      "amount": "70.96",
      "net_amount": "68.60",
      "service_fee": "0.70",
      "service_fee_psp": "1.66",
      "status": "Success",
      "recipient_note": "Bestellung #ORD_20260512",
      "payout_status": "InProgress",
      "created_at": "2026-05-12 20:10:17",
      "is_split_link": "true",
      "is_dispute": "false",
      "is_refund": "false",
      "payment_method": null,
      "transaction_type": "Split"
    }
  ],
  "ResponseCode": 1,
  "ResponseMsg": "List retrived successfully",
  "Result": "True",
  "ServerTime": "CEST"
}

Antwort-Felder (pro Eintrag)

Feld Typ Beschreibung
pay_id string Payment-Link-ID
creator_id string Interne User-ID des Link-Erstellers
user_id string Interne User-ID des Empfängers (Sie)
amount string Ihr Brutto-Anteil
net_amount string Betrag nach allen Gebühren
service_fee string Plattform-Gebühr (SecPaid)
service_fee_psp string PSP-Gebühr (Zahlungsabwicklung)
status string "Success"
payout_status string "Pending", "InProgress" oder "Approved"
payment_method string Verwendete Zahlungsmethode (z.B. null für Karte, "Bank Transfer" für Banküberweisung)
transaction_type string "Basic" oder "Split"

Beispiele

curl -X POST https://app.secpaid.com/api/v2/getPayInTransactions \
  -H "Content-Type: application/json" \
  -H "token: IHR_API_KEY" \
  -d '{"limit": 50, "since": 30}'

Filterung

  • date: Exakte Datumsübereinstimmung (YYYY-MM-DD)
  • since: Relativ — letzte N Tage ab heute
  • pay_id: Einzelne spezifische Transaktion
  • search: Teiltext-Suche in recipient_note

Filter können kombiniert werden (UND-Logik).