Nexi Germany Nexi Germany
    • Überblick POS-Produkte
      Keine Transaktionsgebühren

      Nur für kurze Zeit: Gebühren je Transaktion sparen.

      Zur Aktion

    • SmartPay
      Keine Transaktionsgebühren

      Nur für kurze Zeit: Gebühren je Transaktion sparen.

      Zur Aktion

    • Nexi SoftPOS
      0€ Terminalmiete für 6 Monate

      Jetzt neu:
      Nexi SoftPOS!

      Jetzt mehr erfahren

    • Kassenlösungen
      Partner werden

      Mit Nexi haben Sie den richtigen Payment-Partner an Ihrer Seite

      Partner werden

    • Zusatzleistungen
      Nexi Financing

      Finanzieren Sie Ihr Unternehmen mit Ihren Transaktionen von morgen.

      Jetzt mehr erfahren

    • E-Commerce
    • Kartenlesegeräte
      Keine Transaktionsgebühren

      Nur für kurze Zeit: Gebühren je Transaktion sparen.

      Zur Aktion

    • Zahlungsmethoden
      Keine Transaktionsgebühren

      Nur für kurze Zeit: Gebühren je Transaktion sparen.

      Zur Aktion

    • Branchenüberblick
      Branchen

      Wir haben für jede Branche die passende Lösung!

      Angebot anfordern

    • Einzelhandel
      Branchen

      Wir haben für jede Branche die passende Lösung!

      Angebot anfordern

    • Gastronomie
      Branchen

      Wir haben für jede Branche die passende Lösung!

      Angebot anfordern

    • Lebensmitteleinzelhandel
      Branchen

      Wir haben für jede Branche die passende Lösung!

      Angebot anfordern

    • KFZ-Service
      Branchen

      Wir haben für jede Branche die passende Lösung!

      Angebot anfordern

    • Hotel
      Branchen

      Wir haben für jede Branche die passende Lösung!

      Angebot anfordern

    • Nexi Alliance
      Partner werden

      Mit Nexi haben Sie den richtigen Payment-Partner an Ihrer Seite

      Partner werden

    • Partnerschaft
      Partner werden

      Mit Nexi haben Sie den richtigen Payment-Partner an Ihrer Seite

      Partner werden

    • Nexi Partner Portal
      Partner werden

      Mit Nexi haben Sie den richtigen Payment-Partner an Ihrer Seite

      Partner werden

    • E-Commerce
      eCom-Partner werden

      Gemeinsam den E-Commerce vorantreiben.

      Partner werden

    • SmartPOS
      Partner werden

      Mit Nexi haben Sie den richtigen Payment-Partner an Ihrer Seite

      Partner werden

    • Login
    • Kundenservice
      Bargeldloses Bezahlen im Geschäft

      Unsere Kundenservice-Hotline

      Kontakt aufnehmen

    • FAQ
      Bargeldloses Bezahlen im Geschäft

      Unsere Kundenservice-Hotline

      Kontakt aufnehmen

    • Download Center
      Bargeldloses Bezahlen im Geschäft

      Unsere Kundenservice-Hotline

      Kontakt aufnehmen

    • Newsletter-Anmeldung
      Bargeldloses Bezahlen im Geschäft

      Unsere Kundenservice-Hotline

      Kontakt aufnehmen

    • Änderungen mitteilen
      Bargeldloses Bezahlen im Geschäft

      Unsere Kundenservice-Hotline

      Kontakt aufnehmen

    • Sie wollen kündigen?
      Bargeldloses Bezahlen im Geschäft

      Unsere Kundenservice-Hotline

      Kontakt aufnehmen

    • Autorisierungsservice
      Bargeldloses Bezahlen im Geschäft

      Unsere Kundenservice-Hotline

      Kontakt aufnehmen

    • Leitfäden zum Terminaltausch
      Bargeldloses Bezahlen im Geschäft

      Unsere Kundenservice-Hotline

      Kontakt aufnehmen

    • App-Portal
    • E-Invoicing
    • Änderungen mitteilen
      Bargeldloses Bezahlen im Geschäft

      Unsere Kundenservice-Hotline

      Kontakt aufnehmen

  • Onlineshop
Login
API
  • Bewerbungsstatus
  • Zulässige API Calls
  • Onboarding Sequenz
  • API-Calls Übersicht
API Reseller
Dokumentation

API Repository

Unser Repository beinhaltet umfassende technische Spezifikationen, darunter detaillierte Endpoint-Definitionen, Request-Strukturen und API-Call-Referenzen. Die nachfolgenden Abschnitte skizzieren die Kernprozesse und kritischen Interaktionsparameter. Nach Vertragsabschluss erhalten Sie Zugang zum vollständigen Repository sowie eine dedizierte Onboarding-Session mit unserem Integrations-Team zur effizienten Implementierung.

Status Sequenz

Dieser Abschnitt bietet eine detaillierte Übersicht der sequenziellen Zustände und Validierungsprozesse, die ein Händlerantrag von der initialen Einreichung bis zur Aktivierung durchläuft. Der mehrstufige Workflow umfasst sowohl starre automatisierte Prüfmechanismen als auch manuelle Verifizierungsschritte. Diese beginnen mit der Syntaxvalidierung und enden in umfassenden KYC- und AML-Compliance-Checks. Diese strukturierte Progression gewährleistet eine gründliche Authentifizierung und Validierung der Händlerdaten, wodurch eine sichere und effiziente Integration in die Nexi-Dienstleistungsinfrastruktur sichergestellt wird.

Zulässige API-Calls


Abhängig vom Status eines Antrags sind spezifische API-Calls zulässig. Die möglichen API-Interaktionen für jede Phase des Händlerantragszyklus werden nachfolgend dargestellt.

Onboarding Sequenz

Dieses Sequenzdiagramm illustriert die API-Call-Abfolge des Händler-Onboarding-Prozesses. Es bietet eine prägnante Übersicht der kritischen Interaktionspunkte, während detaillierte Fehlerdokumentationen in den entsprechenden Sektionen der technischen Spezifikation verfügbar sind. Diese Darstellung dient als Leitfaden zur Optimierung Ihrer Integrationsabläufe, um eine effiziente Fehlerbehandlung und -remediation zu gewährleisten. Die systematische Visualisierung ermöglicht eine proaktive Implementierung robuster Fehlerbehandlungsmechanismen und unterstützt Sie bei der Entwicklung resilienter Integrationsszenarien.

Nachfolgend sind die verfügbaren API-Calls einleitend beschrieben. Einen Zugang zum vollumfänglichen Repository und eine entsprechende Einführung mit unserem Integration-Team erhalten Sie nach Vertragsabschluss.

Anhang

Die Aktualisierung von über die API übermittelten Datensätzen ist an spezifische, statusabhängige Regeln gebunden. Im Status „Prospect“ können Änderungen vorgenommen werden, indem das Attribut „ExternalOutletId“ angegeben wird. Diese muss eindeutig definiert sein, um Duplikate bei erneuter Übermittlung zu vermeiden. Sollte die Geschäftspartner-ID beim initialen API-Aufruf nicht zurückgegeben worden sein, kann die Payload mit derselben „ExternalOutletId“ erneut gesendet werden. Für Anträge im Status „Pending“ oder „Active“ sind direkte Änderungen über die API nicht möglich. In diesen Fällen müssen Änderungsanfragen über das Nexi Onboarding-Team eingereicht werden. Insbesondere im Status „Pending“, da sich der Antrag in einem Compliance-Verfahren befindet, sind API-basierte Modifikationen ausgeschlossen und Datenänderungen können ausschließlich vom Nexi Onboarding-Team durchgeführt werden. Diese Regelungen gewährleisten die Integrität des Onboarding-Prozesses sowie die Einhaltung aller regulatorischen Anforderungen. Sie stellen sicher, dass die Datenintegrität über alle Phasen hinweg gewahrt bleibt.

Stufe 1: Validierungsfehler

Fehler der Stufe 1 treten auf Endpunktebene auf, wenn die übermittelten Daten nicht den definierten Akzeptanzkriterien entsprechen. Diese Fehler resultieren aus Validierungsprüfungen, die unmittelbar bei der Datenübermittlung durchgeführt werden. Die spezifischen Fehlercodes, zusammen mit den zugehörigen Anforderungen und Feldvalidierungskriterien, sind detailliert in der API-Dokumentation aufgeführt. Diese präzise Dokumentation ermöglicht eine effiziente Fehlerbehandlung und unterstützt Entwickler bei der Implementierung robuster Datenvalidierungsroutinen auf Client-Seite.

Stufe 2: Fehlermeldungen

Fehler der Stufe 2 werden als Tickets (Cases) innerhalb des get.status-Aufrufs dargestellt. Diese Struktur ermöglicht eine granulare und typsichere Fehlerbehandlung, wobei für jeden auftretenden Fehler ein separates Ticket generiert wird.

  1. IBAN-Validierung fehlgeschlagen: Die angegebene IBAN %IBAN% ist nicht gültig. Bitte reichen Sie den Antrag mit einer gültigen IBAN erneut ein.
  2. Validierung der Adresse fehlgeschlagen: Eine angegebene Adresse ist nicht gültig.  Bitte reichen Sie den Antrag mit einer gültigen Adresse erneut ein. 
  3. Technischer Fehler: Es ist ein technischer Fehler aufgetreten und der Antrag konnte nicht empfangen werden. Bitte reichen Sie den Antrag erneut ein.
  4. E-Mail-Duplikat: Die angegebene E-Mail-Adresse ist bereits im System registriert. Dieser Fall wurde erfasst und wird intern bearbeitet. Bitte reichen Sie den Antrag nicht erneut ein. Sie können den Bewerbungsstatus abrufen, um Aktualisierungen des Lösungsfortschritts abzurufen.

Alle Adressen müssen durch den Partner validiert werden, bevor diese übermittelt werden, um eine optimale Durchlaufzeit des Antrags zu gewährleisten. Es wird empfohlen, einen automatischen Adressvervollständigungsdienst in die Händlerdatenerfassung zu integrieren.

Jede Adresse muss Straße, Hausnummer, Postleitzahl und Ort beinhalten. Bei Validierungsfehlern werden die betroffenen Adressen samt Fehlerbeschreibung in einem Case zurückgegeben, der über den get.status-Aufruf abrufbar ist.

Solange der Antragsstatus "Prospect" ist, können Händlerdaten ausschließlich über die API mittels der Update-Funktion modifiziert werden. Bei Unklarheiten steht das Nexi Onboarding Team zur Verfügung. Nach Behebung aller Fehler wechselt der Antrag automatisch in den Status "Pending" und ist nicht mehr modifizierbar.

Die einzureichenden Dokumente hängen von der Unternehmensart des Händlers ab. Jedes Dateiformat wird akzeptiert. PDF oder JPEG werden allerdings empfohlen. Die maximal zulässige Dateigröße beträgt 5 MB. Für andere juristische Personen, die als „Soletrader“ und „GBR“ bezeichnet werden, sind keine Dokumente für die Einreichung des Antrags erforderlich. Der Antrag für „Soletrader“ und „GbR“ bleibt im Status „Prospect“, bis die Dokumente eingereicht werden.

    ÜBER UNS
  • ÜBER NEXI
  • PRESSE UND MEDIEN
  • BLOG
  • KARRIERE
  • STANDORTE
  • NEWSLETTER
    SUPPORT
  • FAQ
  • DOWNLOAD CENTER
  • DATENSICHERHEIT
  • KUNDEN WERBEN KUNDEN
  • WÄHRUNGSUMRECHNER
  • BESCHWERDEFORMULAR
    KONTAKT & SERVICE
  • KUNDENSERVICE
  • SALES
  • PARTNER
  • STATEMENT
  • ÄNDERUNGEN MITTEILEN
  • KÜNDIGUNGEN
NEXI GERMANY GMBH

Helfmann-Park 7
65760 Eschborn
GERMANY

  • Impressum
  • Datenschutz
  • Sitemap
  • Cookies
  • Barrierefreiheit
  • Hinweisgebersystem
© Nexi Germany GmbH | 2023 - 2025
Sprache auswählen
Deutsch
English