Händlerverwaltung
Verwalten Sie Onboarding-Entwürfe, Registrierungseinladungen, Händlerzugriffe und vertragliche Preise über Ihr Backend.
Verwalten Sie die Händler Ihrer Organisation über Ihr Backend. Jeder Aufruf verwendet Ihr Server Secret Token; bewahren Sie es daher auf Ihrem Server auf.
| Detail | Wert |
|---|---|
| Basis-URL | https://api.sandbox.tapaya.com für die Sandbox, https://api.tapaya.com für die Produktion |
| Authentifizierung | Server Secret Token in Authorization. Siehe Authentifizierung. |
| Beträge | Kleinste Währungseinheiten: 2500 mit EUR entspricht 25,00 EUR. Relative Gebühren in Basispunkten: 100 entspricht 1 %. |
| Zugehöriger Leitfaden | Händler-Onboarding |
Alle Operationen
| Operation | Zweck |
|---|---|
| Gespeichertes Onboarding lesen | Das Onboarding-Formular eines Händlers dort fortsetzen, wo er aufgehört hat. |
| Kanalauswahl speichern | Die von einem Händler gewählten Zahlungskanäle speichern, ohne sie zu übermitteln. |
| Mitglieder auflisten | Sehen, wer bereits Zugriff auf einen Händler hat. |
| Terminals auflisten | Die Terminals eines Händlers und ihre Geräte anzeigen. |
| E-Mail-Einladungen auflisten | Einmalige Einladungen an bekannte Empfänger nachverfolgen. |
| Wiederverwendbare Links auflisten | Kampagnenlinks nachverfolgen und sehen, ob sie pausiert sind. |
| Wiederverwendbaren Link erstellen | Eine Kampagne starten, über die sich viele Händler registrieren können. |
| Ablauf einer Einladung ändern | Eine Einladung verlängern oder verkürzen, auch eine abgelaufene. |
| Wiederverwendbaren Link pausieren oder reaktivieren | Neue Registrierungen vorübergehend stoppen, ohne den Link zu widerrufen. |
| Preissätze auflisten | Die Preissätze finden, aus denen Ihre Organisation Profile erstellen darf. |
| Provisionsprofile auflisten | Ein Profil auswählen, das einer Einladung zugewiesen wird. |
| Provisionsprofil erstellen | Händlern eine Preisliste anbieten, die auf einem Preissatz basiert. |
| Provisionsprofil aktualisieren | Ein Profil umbenennen oder seine Tarife ändern. |
| Provisionsprofil löschen | Ein Profil entfernen, das Sie nicht mehr anbieten. |
| Standardprofil festlegen | Das Profil wählen, das Einladungen ohne eigene Profilangabe verwenden. |
| Händlerpreise lesen | Die Tarife anzeigen, mit denen sich ein Händler registriert hat. |
Onboarding-Entwürfe
Mitglieder und Terminals
Registrierungseinladungen
Verwenden Sie eine E-Mail-Einladung für einen bekannten Empfänger oder einen wiederverwendbaren Link für eine Kampagne. Beide können Kanäle einschränken und Provisionsprofile zuweisen.
Provisionsprofile
Ein Provisionsprofil ist die Preisliste, die Sie Händlern anbieten. Erstellen Sie es aus einem Preissatz, für den Ihre Organisation autorisiert ist.
Händlerpreise
Fehler
Jede Operation antwortet mit diesen Statuscodes, wenn eine Anfrage fehlschlägt.
| Code | Beschreibung |
|---|---|
400 | Ungültige Kanaldaten, Profilauswahl, Filter oder Ablaufzeit; oder der Versuch, ein Standardprofil oder zugewiesenes Profil zu löschen. |
401 | Das Server Secret Token fehlt oder ist ungültig. |
404 | Die Ressource ist für Ihre Organisation nicht verfügbar, oder das gespeicherte Onboarding beziehungsweise die Preise existieren nicht. |
409 | Eine veraltete Profilrevision, ein widersprüchlicher Onboarding-Zustand oder eine verwendete beziehungsweise widerrufene Einladung. |