Zum Inhalt

getTaxInvoiceList

Ihre SecPaid Service-Fee-Rechnungen auflisten (monatliche Abrechnungen).

Request

POST /api/v2/getTaxInvoiceList

Headers

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

Body-Parameter

Feld Typ Erforderlich Standard Beschreibung
page integer Nein 1 Seitennummer für Paginierung
limit integer Nein 10 Ergebnisse pro Seite
search string Nein Suchfilter
date string Nein Filter nach Monat (YYYY-MM)

Antwort

Erfolg

{
  "data": [
    {
      "sf_id": "178",
      "user_id": "b44c4429-4a7b-4e27-85af-c1c2f43f4ffe",
      "company": "Muster GmbH",
      "name": "Max Mustermann",
      "street": "Musterstraße",
      "house_no": "1",
      "city": "Berlin",
      "country": "Germany",
      "zipcode": "10115",
      "invoice_id": "202604-sf-oS5TYzrGXF",
      "invoice_date": "2026-05-01",
      "service_month": "April 2026",
      "total_secpaid_fee": 10.38,
      "total_psp_fee": 245.15,
      "vat": 0,
      "created_at": "2026-05-01 03:01:05"
    }
  ],
  "totalRecords": 18,
  "ResponseCode": 1,
  "ResponseMsg": "List retrived successfully",
  "Result": "True",
  "ServerTime": "CEST"
}

Antwort-Felder (pro Eintrag)

Feld Typ Beschreibung
invoice_id string Rechnungsreferenz (Format: YYYYMM-sf-XXXXXXXXXX)
invoice_date string Ausstellungsdatum
service_month string Abrechnungszeitraum (z.B. "April 2026")
total_secpaid_fee number SecPaid-Servicegebühren für den Monat
total_psp_fee number Zahlungsanbieter-Gebühren für den Monat
vat number Mehrwertsteuer (0 bei Reverse-Charge)
company, name, street, etc. string Rechnungsadresse

totalRecords (Top-Level) gibt die Gesamtanzahl für Paginierung an.

Beispiele

curl -X POST https://app.secpaid.com/api/v2/getTaxInvoiceList \
  -H "Content-Type: application/json" \
  -H "token: IHR_API_KEY" \
  -d '{"page": 1, "limit": 12}'

Hinweise

  • Rechnungen werden monatlich für Service-Gebühren erstellt
  • Dieser Endpoint enthält totalRecords für Paginierung
  • date-Filter mit Format YYYY-MM für einen bestimmten Monat