Änderungen in Version v1.0.0

Übersicht

Thema	Änderung	Zeile
Gegenstand der Änderung	Beschreibung & Begründung	Welcher Parameter ist betroffen?
		Zeile 3 - 7
		Zeile 17 - 19
		Zeile 208
		Zeile 424
		Zeile 490
		Zeile 513 - 523
		Zeile 527 - 534
		ZZeile 582
		Zeile 588
		Zeile 594
		Zeile 596
		Zeile 607
		Zeile 619
		Zeile 632 - 633
		Zeile 635 - 636

Details

Nachfolgend sind alle Änderung als Auszug aus der .yaml-Datei detailliert gelistet. Zusätzlich finden Sie unter jedem Auszug eine entsprechende Erklärung der veränderten Passage im Vergleich zur Vorgängerversion.

Zeile 3 - 7

title: XBezahldienste API
  description: '<h1>Standardisierte Schnittstelle für Bezahldienste im Portalverbund</h1>
    <p>Diese Seite enthält nur die Schnittstellenspezifikation im OpenAPI3 Format. Diese wird bereit gestellt mit dem Tool Swagger.io.
    Weitere Dokumentation zur Schnittstelle finden Sie im <a href="https://docs.fitko.de/xbezahldienste/">Entwicklungsportal der FITKO</a>.</p>
    <h2>Ansprechpartner</h2>

→ Änderung: xxx

Zeile 17 - 19

url: "https://docs.fitko.de/xbezahldienste/API-License/"
  version: 1.0.0
  termsOfService: "https://docs.fitko.de/xbezahldienste/API-TermsOfService/"

→ Änderung: xxx

Zeile 208

<li>INITIAL - der Antrag hat einen Payment-Request ausgelöst und eine Payment-Transaction wurde angelegt. Der Nutzer hat aber im Bezahldienst noch keine Wirkung erzeugt. Der Benutzer kann mit dem Link zum Bezahldienst weitergeleitet werden. NEUE / Eränzende Info: Solange der Benutzer eine bestimmte Zahlart ausgewählt und abgebrochen hat - aber noch die Option hat, stattdessen eine andere Zahlart zu verwenden, so bleibt der Status auf INITIAL</li>

→ Änderung: xxx

Zeile 424

description: 'Soll nur existieren, wenn isOrganization == true'

→ Änderung: xxx

Zeile 490

example: 'https://docs.fitko.de/xbezahldienste/API-SystemResponse/'

→ Änderung: xxx

Zeile 513 - 523

functionalCode:
  type: string
  enum:
    - NO_VALID_ORIGINATOR_OR_DESTINATION
    - NO_VALID_ORIGINATOR_OR_ENDPOINT
    - PAYMENT_EXISTS
    - CALCULATION_ERROR
    - BOOKING_DATA_MISSING
    - VALIDATION_ERROR
    - UNSPECIFIED
    - FORBIDDEN

→ Änderung: xxx

Zeile 527 - 534

<li>NO_VALID_ORIGINATOR_OR_DESTINATION - Deprecated - siehe nächsten Punkt.</li>
<li>NO_VALID_ORIGINATOR_OR_ENDPOINT - Der Mandant kann anhand OriginatorID und EndPointID nicht ermittelt werden.</li>
<li>PAYMENT_EXISTS - Mit dieser Transaktions-ID wurde bereits ein PaymentRequest platziert.</li>
<li>CALCULATION_ERROR - Die Summe des PaymentRequests passt nicht zu den Positionen - z.B. fehlerhafter grosAmount.</li>
<li>BOOKING_DATA_MISSING - Notwendige Daten für die Verbuchung (in bookingData) fehlen - genaue Beschreibung im functionalText.</li>
<li>VALIDATION_ERROR - Andere Validierungsfehler / semantische Fehler wie z.B. nicht unterstützte Währung.</li>
<li>UNSPECIFIED - Alle Fehler, die hier aktuell nicht konkret definiert sind.</li>
<li>FORBIDDEN - Fehlende Authentisierungsdaten oder keine Authorisierung in diesem Kontext.</li>

→ Änderung: xxx

Zeile 582

type: 'https://docs.fitko.de/xbezahldienste/API-SystemResponse/#200healthy'

→ Änderung: xxx

Zeile 588

description: Bad request - Syntaktischer oder semantischer Fehler

→ Änderung: xxx

Zeile 594

type: 'https://docs.fitko.de/xbezahldienste/API-SystemResponse/#400error'

→ Änderung: xxx

Zeile 596

title: 'Bad Request'

→ Änderung: xxx

Zeile 607

type: 'https://docs.fitko.de/xbezahldienste/API-SystemResponse/#403error'

→ Änderung: xxx

Zeile 619

type: 'https://docs.fitko.de/xbezahldienste/API-SystemResponse/#404error'

→ Änderung: xxx

Zeile 632 - 633

type: 'https://docs.fitko.de/xbezahldienste/API-SystemResponse/#503error'

status: 503

→ Änderung: xxx

Zeile 635 - 636

detail: "Interner temporärer Server Fehler"
            functionalCode: "UNSPECIFIED"