Zum Hauptinhalt springen
POST
Die Authentifizierung ist neu. Diese Endpoints werden vom Issuer Ihrer Anwendung bereitgestellt, zum Beispiel https://<name>.auth.didit.me, und akzeptieren niemals Ihren Didit-API-Schlüssel.
Die Query-Parameter step_up und status in Ihrem return_to signalisieren Ihrer Anwendung nur, dass sie nachsehen soll. Bevor Sie handeln, rufen Sie den Step-up mit Einen Step-up abrufen ab und fahren Sie nur fort, wenn status den Wert approved hat.

Autorisierungen

Authorization
string
header
erforderlich

Das Access Token der Person von POST /token/: ein ES256-JWT mit dem Header typ: at+jwt, gültig für maximal 5 Minuten. Nicht Ihr Didit-API-Schlüssel.

Body

application/json

Die sensible Aktion, die die Person gerade ausführen möchte.

action
enum<string>
erforderlich

payout (eine Auszahlung oder Überweisung), bank (Hinzufügen oder Ändern eines Bankkontos) oder contact (Ändern einer E-Mail-Adresse oder Telefonnummer). Bei einer Auszahlung greift zusätzlich die Regel für neue Geräte.

Verfügbare Optionen:
payout,
bank,
contact
return_to
string
erforderlich

Wohin die Person nach der Verifizierung zurückkehrt, ergänzt um step_up=<id>&status=approved. Wenn eine Regel greift, muss es eine der Weiterleitungs-URIs der Anwendung sein; wenn keine greift, wird dies nicht geprüft.

Maximum string length: 2048
Beispiel:

"https://app.example.com/payouts/confirm"

amount
string

Erforderlich für payout: der Betrag, bis zu zwei Dezimalstellen. Eine JSON-Zahl wird ebenfalls akzeptiert.

Pattern: ^[0-9]{1,16}(\.[0-9]{1,2})?$
Beispiel:

"900.00"

currency
string

ISO 4217-Code von amount. Standardmäßig die Währung der Auszahlungsregel; eine Auszahlung in einer anderen Währung wird immer geprüft.

Pattern: ^[A-Z]{3}$
Beispiel:

"USD"

Antwort

Keine Regel greift.

Keine Regel greift: Fahren Sie mit der Aktion fort.

required
enum<boolean>
erforderlich
Verfügbare Optionen:
false
Zuletzt geändert am 7. November 2026