Einführung¶

SecPaid bietet eine REST-API, mit der Sie programmatisch Payment Links erstellen, Transaktionen verfolgen, Erstattungen auslösen und Echtzeit-Zahlungsbenachrichtigungen empfangen können.

Was ist SecPaid?¶

SecPaid ist ein Payment-Link-Service. Sie erstellen einen Link per API, senden ihn an Ihren Kunden und SecPaid übernimmt den Checkout. Wenn der Kunde bezahlt, werden Sie per Webhook benachrichtigt.

Kern-Workflow¶

sequenceDiagram
    participant Y as Ihr Server
    participant S as SecPaid API
    participant C as Kunde

    Y->>S: 1. POST /api/v2/createLink
    S-->>Y: pay_link + pay_id
    Y->>C: 2. pay_link teilen
    C->>S: 3. Öffnet Link & bezahlt
    S->>Y: 4. Webhook → payment_endpoint
    S->>C: 4. Redirect → callback_url

Schritt	Was passiert
1. Erstellen	`POST /api/v2/createLink` mit einem Betrag aufrufen
2. Teilen	Kunden zum zurückgegebenen `pay_link` weiterleiten
3. Bezahlen	Kunde schließt Zahlung auf SecPaids Checkout-Seite ab
4. Benachrichtigen	SecPaid ruft Ihren `payment_endpoint` auf und leitet via `callback_url` weiter

API auf einen Blick¶

Eigenschaft	Wert
Protokoll	Nur HTTPS
Methode	Alle Endpoints verwenden `POST`
Auth	`token`-Header mit Ihrem API Key
Format	JSON Request & Response
Zeitzone	Server gibt `CEST` / `UTC` zurück

Basis-URLs¶

Umgebung	Basis-URL	Zweck
Produktion	`https://app.secpaid.com/api/v2/`	Live-Zahlungen
Entwicklung	`https://app.dev.secpaid.com/api/v2/`	Test & Integration

Interaktive API

Testen Sie Endpoints live unter api.secpaid.com — unsere Swagger UI mit allen v2-Endpoints.

Nächste Schritte¶

Authentifizierung

Richten Sie Ihren API-Schlüssel ein und verstehen Sie den token-Header.

Auth-Guide
Schnellstart

Erstellen Sie Ihren ersten Payment Link in unter 5 Minuten.

Schnellstart
Antwortformat

Verstehen Sie das Standard-Response-Format und Fehlercodes.

Fehler & Antworten
Dashboard & Einstellungen

Navigieren Sie die Plattform-UI, finden Sie Ihren API-Key und konfigurieren Sie Webhooks.

Dashboard