Zum Inhalt

getMyUnusedLinks

Ihre ausstehenden (unbezahlten) Payment Links auflisten.

Request

POST /api/v2/getMyUnusedLinks

Headers

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

Body-Parameter

Feld Typ Erforderlich Standard Beschreibung
limit integer Nein 10 Maximale Anzahl Ergebnisse
search string Nein Filter nach recipient_note (Teilübereinstimmung)

Antwort

Erfolg

{
  "data": [
    {
      "linktopay_id": "99290",
      "user_id": "b44c4429-4a7b-4e27-85af-c1c2f43f4ffe",
      "recipient_note": "Rechnung #1234",
      "amount": "25.00",
      "is_cancelled": "No",
      "recipients": null,
      "is_split_link": "false",
      "pay_link": "https://app.secpaid.com/payment?link_id=OTkyOTA=",
      "qr_img": "https://quickchart.io/chart?chl=https://app.secpaid.com/payment?link_id=OTkyOTA=&chs=300x300&cht=qr",
      "transaction_type": "Basic"
    }
  ],
  "ResponseCode": 1,
  "ResponseMsg": "List retrived successfully",
  "Result": "True",
  "ServerTime": "CEST"
}

Antwortfelder (pro Eintrag)

Feld Typ Beschreibung
linktopay_id string Link-ID
amount string Zahlungsbetrag
recipient_note string Notiz auf dem Link
is_split_link string "true" / "false"
pay_link string Zahlungs-URL
qr_img string QR-Code-Bild-URL
transaction_type string "Basic" oder "Split"

Beispiele

curl -X POST https://app.secpaid.com/api/v2/getMyUnusedLinks \
  -H "Content-Type: application/json" \
  -H "token: IHR_API_KEY" \
  -d '{"limit": 20, "search": "Rechnung"}'
$response = Http::withHeaders([
    'token' => 'IHR_API_KEY',
])->post('https://app.secpaid.com/api/v2/getMyUnusedLinks', [
    'limit' => 20,
    'search' => 'Rechnung',
]);

Hinweise

  • Gibt nur Links mit Status Unused zurück, die zu Ihrem Konto gehören
  • Ergebnisse nach Erstellungsdatum sortiert (neueste zuerst)
  • Keine Paginierungs-Metadaten — verwenden Sie limit zur Steuerung der Ergebnisgröße