Kontoverwaltung
https://checkout.postfinance.ch/user/login
Die Credentials (Postfinance Checkout Backoffice JAXForms) für das Login sind in Bitwarden hinterlegt.
Da diese Zugänge ohne einen aktiven Vertrag auslaufen, muss immer wieder ein neuer registriert werden:
- Neue E-Mail Adresse in Office365 auf bestehendem Konto postfinance_dev@jaxforms.ch eröffnen (postfinance_devXX@jaxforms.ch)
- Neuer Account mit der eröffneten E-Mail Adresse erfassen
- Credentials im Bitwarden aktualisieren
Zahlungsprozess
https://checkout.postfinance.ch/de-ch/doc/payment/transaction-process
Beispiel einer Zahlung
Grundsätzlich gibt es 2 Arten der Zahlungsseitenintegration
- Die Iframe-Integration , bei der der Kunde auf die Zahlungsseite von Postfinance mithilfe der Postfinance JavaScript-Integration in einen Iframe eingebettet wird.
- Die Lightbox-Integration, um eine nahtlose und PCI DSS-konforme Integration in unseren Checkout zu erreichen.
https://checkout.postfinance.ch/de-ch/doc/payment/payment-page
Aufruf Schnittstelle
Übergabe Parameter Transaktionserstellung
Pfad/Name | Datentyp | Beschreibung | Beispiel |
|---|---|---|---|
| lineItems.quantity | Integer | Artikel, Anzahl | 1 |
| lineItems.name | String | Artikel, Name | Auszug aus dem Geburtsregister (CIEC) (Formular 1.80) / Geburtsurkunde (Formular 1.2.3) |
| lineItems.amountIncludingTax | Float | Artikel, Betrag | 31.1 |
| lineItems.type | Enum (String) | Artikel, Typ | PRODUCT [SHIPPING, DISCOUNT, FEE, PRODUCT, TIP] |
| lineItems.uniqueId | String | Artikel, Id | 8f802614-68e7-4148-a15c-e0cd106bb4d7 |
| currency | String | Währung | CHF |
| merchantReference | String | Referenz | 8f802614-68e7-4148-a15c-e0cd106bb4d7 |
| language | String | Sprache | de |
| completionBehavior | Enum (String) | Abschlussverhalten | COMPLETE_DEFERRED [COMPLETE_IMMEDIATELY, COMPLETE_DEFERRED, USE_CONFIGURATION] |
| successUrl | String | Callback Erfolg | https:// |
| failedUrl | String | Callback Misserfolg | https:// |
Konfiguration PostFinance Checkout
Einrichtung API-Benutzer
Benötigte Berechtigungen/Rollen
Einrichtung Space für Gebrauch mit JAXForms-Integration
Einstellungen CompletionTimeout
Einstellungen CompletionType (Abschluss/Annulation)
