Fragen und Antworten zu Checkout Flex und Checkout All‑in‑one

Hier erhalten Sie Antworten auf Fragen zu Upgrades, Transaktionen, Plugins und mehr.

Übersicht

  • PostFinance Checkout bietet mehrere Zahlungsdienstleistungen an. Das Kernstück bildet dabei das PostFinance Checkout Backoffice-Tool, welches Zahlungen über unsere PAX-Kartenterminals oder E-Commerce Shop Plugins ermöglicht.

    Sie können sich jederzeit kostenlos anmelden und unsere Lösung im Simulationsmodus testen. Registrieren Sie sich unter Der Link öffnet sich in einem neuen Fenster checkout.postfinance.ch.

    Falls Sie Interesse an unseren physischen PAX-Kartenterminals haben, können Sie gerne unseren Terminal Shop unter Der Link öffnet sich in einem neuen Fenster terminal-shop.postfinance.ch besuchen.

    Suchen Sie ein passendes Zahlungsplugin für Ihren E-Commerce Shop, besuchen Sie gerne unsere GitHub Seite Der Link öffnet sich in einem neuen Fenster github.com/pfpayments. Wir unterstützen etablierte Shopsysteme wie WooCommerce, Shopify (Direktintegration im Shop), Magento 2, Shopware, Prestashop, OXID, Gambio, OpenCart und einige mehr. Mit unserem PostFinance Subscription Plugin für WooCommerce, können Sie auch Abo-Produkte (wiederkehrende Zahlungen) in Ihrem Shop anbieten. Plugins können Sie direkt herunterladen und in Ihrem Shop installieren. Anschliessend können Sie unser Checkout kostenlos testen.

    Bei Integrationen für Eigenentwicklungen, bieten wir die PostFinance Checkout API und diverse SDK’s in verschiedenen Programmiersprachen (PHP, Java, C#, Python, TypeScript etc.) an. Schauen Sie sich hierfür unsere API Dokumentation unter Der Link öffnet sich in einem neuen Fenster checkout.postfinance.ch an.

    Alle Dokumentationslinks zu den Plugins und Anleitung der PAX-Kartenterminals finden Sie auf Der Link öffnet sich in einem neuen Fenster checkout.postfinance.ch/doc.

Top-5 Fragen

  • PostFinance (PostFinance Pay, PostFinance E-Finance)
    E-Mail: checkout@postfinance.ch, Telefon: 0848 382 423 (im Inland max. CHF 0.08/Min.)

    Wallee/Snapswap (Visa, Mastercard, TWINT, PostFinance Pay)
    E-Mail: info@wallee.com, Telefon: 044 505 13 60

    Worldline SIX (Visa, Mastercard, TWINT, China Union Pay, Diners)
    E-Commerce
    E-Mail: cs.ecom@worldline.com, Telefon: 0848 83 20 00
    Präsenzgeschäft (POS)
    E-Mail: customerservice@worldline.com, Telefon: 0848 83 20 00

    Concardis (Visa, Mastercard, Diners)
    E-Mail: servicech@nets.eu, Telefon: 058 220 58 58

    FirstData (Visa, Mastercard, Diners, JCB, China Union Pay)
    E-Mail: fde-service@fiserv.com, Telefon: 0800 550 014

    Swisscard (American Express)
    E-Mail: partner.service@swisscard.ch, Telefon: 044 659 64 44

    PowerPay (MF Group, Zahlen auf Rechnung)
    E-Mail: partner@mfgroup.ch, Telefon: 058 806 06 31

    Boncard (WIR, Boncard, Swiss Pay, Gift Card, Lunch-Check, EKZ card)
    E-Mail: pool@boncard.ch, Telefon: 0848 080 408

    TWINT AG (TWINT)
    E-Mail: support@twint.ch, Telefon: 058 667 98 44

    PayPal
    Kontaktangaben auf Der Link öffnet sich in einem neuen Fenster paypal.com

  • Die aktuelle Übersicht und Dokumentationen finden Sie auf Der Link öffnet sich in einem neuen Fenster checkout.postfinance.ch.
  • Das Produkt Checkout All-in-One basiert auf einem Collecting Angebot. Das heisst, alle Zahlungsarten (PostFinance Pay, Visa, Mastercard und TWINT) werden über einen Vertrag abgewickelt. Weitere Zahlungsmethoden können nicht hinzugefügt werden.

    Für das Produkt Checkout Flex stehen Ihnen neben dem Collecting-Angebot auch weitere Zahlungsmethoden (z. B. American Express oder Kryptowährungen) und Akzeptanzpartner zur Verfügung. Hierzu muss mit jedem Akzeptanzpartner ein separater Vertrag abgeschlossen werden. Mit Checkout Flex haben Sie die Möglichkeit auch wiederkehrende Transaktionen durchführen (z. B. Abonnemente).

    Sie können sich jederzeit auf Der Link öffnet sich in einem neuen Fenster checkout.postfinance.ch registrieren. Nach der Erstellung des Accounts wählen Sie das gewünschte Produkt aus und starten mit dem kostenlosen Simulationsmodus.

  • Apple Pay wird von uns bereits unterstützt. Bitte klären Sie mit Ihrem Payment Service Provider ab, ob dieser die Zahlart auch in der Verarbeitung unterstützt.

    Wir unterstützen ebenfalls Kryptowährungen (Bitcoin Suisse) mit Anbindung über den Verarbeiter Worldline.

    Checkout Flex wird stetig weiterentwickelt und ausgebaut. Neu verfügbare Zahlungsarten sind auf Der Link öffnet sich in einem neuen Fenster checkout.postfinance.ch einsehbar. Sie sehen hier auch, mit welchen Akzeptanzpartnern, welche Zahlungsarten über uns unterstützt werden.

  • Folgen Sie der Schritt-für-Schritt-Anleitung um ihr PAX-Terminal einzurichten.

Allgemeine Fragen

  • Der Fehler 403 weist auf fehlende Berechtigungen eines Benutzers hin. Als Adminbenutzer können Sie anderen Mitarbeitenden Zugriff auf Ihr Konto gewähren, indem Sie Benutzer anzulegen und diesen Rollen und Berechtigungen zuzuweisen.

    Wenn Sie diesen Benutzern keine Rollen und Berechtigungen zuweisen, können sie nicht auf Ihr Konto zugreifen und erhalten stattdessen eine Fehlerseite «Zugriff verweigert – Fehlercode: 403».

    Achten Sie darauf, dass Sie der Space- und Account-Ebene immer den entsprechenden READ-Zugriff zuweisen. Die Benutzer müssen also mindestens Leserechte auf Space- oder Account-Ebene haben.

    Der Link öffnet sich in einem neuen Fenster Dokumentation Berechtigungskonzept auf checkout.postfinance.ch

  • Überprüfen Sie, mit welcher Zahlungsart die Bestellung bezahlt wurde. Wenden Sie sich anschliessend an den zuständigen Akzeptanzpartner (siehe obenstehende Frage «Welche Akzeptanzpartner und Zahlungsarten werden unterstützt?»).
  • Beim Registrieren wurde Ihnen automatisch ein Account zugewiesen. Wenn Sie in der Übersicht Ihres Accounts sind, sehen Sie oben Links eine Nummer nach dem «#» Symbol. Dies ist Ihre eindeutige AccountID.

    Über Ihren Account sind all Ihre Spaces verknüpft sowie Ihr aktuelles Checkout Abonnement (Flex, All-In-One).

    Ihre Spaces sind die Verlinkung zu Ihren Zahlungsplugins in ihren Shops oder zu Ihren PAX-Kartenterminals. Hier können Sie alles einrichten, was mit ihrem Tagesgeschäft, bezüglich Zahlungen zu tun hat:

    • Einrichten von Zahlungsmethoden
    • Verlinkung zum Zahlungsplugin in ihren E-Commerce Systemen oder zu Ihrer Eigenentwicklung, welche Sie mit unserer REST API programmiert haben
    • Verlinkung zu Ihren PostFinance Checkout PAX-Kartenterminals
    • Einsehen der Zahlungstransaktionen sowie deren Bearbeitung (Verbuchung, Rückerstattungen, Stornierungen)
    • Weitere Funktionen

    Wenn Sie in Ihrem Space sind, sehen Sie die Space ID ebenfalls oben Links nach dem «#» Symbol.

Abonnement

  • Ein Wechsel von All-in-One zu Flex oder umgekehrt kann gerne bei checkout@postfinance.ch in Auftrag gegeben werden. Geben Sie hierfür Ihre AccountID an und senden Sie eine Email von Ihrer bei Checkout registrierten Emailadresse.

  • Eine Kündigung des Abo kann jederzeit im Checkout-Backoffice ausgeführt werden. Wählen Sie im eingeloggten Bereich «Account» > «Abo» > «Abo kündigen».

    Der Checkout-Vertrag wird auf Ihren nächsten Rechnungslauf (max. 30 Tage) aufgehoben.

  • Checkout All-in-One: Im Preis inbegriffen sind zwei Spaces. Wir empfehlen ein Space für die Produktivumgebung zu nutzen und den zweiten für Ihre Testumgebung. Falls Sie zwei produktive Onlineshops nutzen möchten, müssen Sie einen zusätzlichen Akzeptanzvertrag abschliessen im Menü Organisation.

    Checkout Flex: Zwei Spaces/Onlineshops sind in den monatlichen Gebühren inbegriffen. Sie können gegen eine monatliche Gebühr beliebig viele weitere Spaces/Onlineshops eröffnen.

    Beachten Sie, dass für jeden Space neue Akzeptanzverträge für die gewünschten Zahlungsarten eingerichtet werden müssen.

  • Die Liveschaltung des PostFinance Checkout Abos dauert 1–2 Arbeitstage, sobald Sie den Vertrag online signiert haben. Gehen Sie hierfür auf «Account» > «Abo» > «Registrierung abschliessen».

    Die Dauer der Aktivierung der verschiedenen Zahlungsarten ist vom jeweiligen Akzeptanzpartner (Worldline, PostFinance, Wallee/Snapswap etc.) abhängig.

  • Die Aufschaltgebühren sowie die monatlichen Gebühren werden jeweils dem hinterlegten PostFinance-Geschäftskonto oder der Kreditkarte belastet.
  • Nein. Für die Gebührenbelastung können Sie als Alternative zum PostFinance-Geschäftskonto eine Schweizer Kreditkarte eintragen. Die Auszahlung erfolgt auf das gewünschte Bankkonto einer schweizerischen Bank.

Plugins

  • PostFinance prüft stetig die aktuelle Marktsituation und erweitert laufend die Anzahl Plugins.
  • Bitte nehmen Sie zuerst Kontakt mit dem Anbieter Ihrer Shopsoftware auf. Es kann sein, dass bereits eine API-Verbindung hergestellt wurde.

    PostFinance Checkout kann alternativ via Web Services REST API integriert werden. Eine ausführliche Dokumentation finden Sie auf Der Link öffnet sich in einem neuen Fenster checkout.postfinance.ch.

    Weitere hilfreiche Informationen und Tipps zum Thema finden Sie auf Der Link öffnet sich in einem neuen Fenster github.com/pfpayments.

  • Sie nutzen das E-Payment-Modul für Checkout für die Akzeptanz von Kartenzahlungen in Ihrem Shopify-Webshop.

    Ihr Webshop wird über eine App mit dem E-Payment-Modul für Checkout verknüpft. Bald können über diese App, die Sie aktuell nutzen, keine Zahlungen mehr verarbeitet werden, weil Shopify die heutige Schnittstelle nicht mehr unterstützen wird. Deshalb ist bis zum 31. Mai 2024 ein Wechsel auf die neue Shopify Zahlungs-App, die ab sofort in Ihrem Shopify-Backend verfügbar ist, notwendig.

    Ein Wechsel ist innert weniger Minuten möglich, folgen Sie dafür einfach der Anleitung:

    Der Link öffnet sich in einem neuen Fenster Anleitung für den Wechsel zur neuen PostFinance Checkout App für Shopify (PDF)

    Nach dem Wechsel steht Ihnen unsere neue Zahlungsart PostFinance Pay zur Verfügung, die unsere beiden bisherigen Zahlungsarten PostFinance Card und PostFinance E-Finance ablösen wird.

    Durch diese notwendige Anpassung fällt mit der neuen App eine zusätzliche Gebühr von 0,3% auf Ihren Verkäufen an, die über Ihre bei PostFinance Checkout hinterlegte Zahlungsmethode (PostFinance-Konto oder Kreditkarte) verrechnet wird. Diese Gebühr wird uns von Shopify verrechnet, wir geben sie an unsere Händler weiter.

    Falls Sie den Wechsel auf die neue Shopify Zahlungs-App bereits vorgenommen haben, müssen Sie nichts unternehmen.

    Bei Fragen wenden Sie sich gerne an unseren Support (checkout@postfinance.ch oder 0848 382 423).

Eigenentwicklung via API/SDK

  • Success/Failed URL

    Die Success/Failed URL werden auf der Transaktion definiert, bevor auf der Payment Page oder Lightbox/iFrame bezahlt wird. Je nach erfolgreichen oder fehlgeschlagenen Transaktionen wird der Käufer dann auf die Success/Failed URL ihres Shops weitergeleitet.

    Sie können auch nach der «Transaction Create» API/SDK Methode (noch vor der Weiterleitung zur Bezahlung) im Response die Transaktion ID extrahieren und diese in ihren Systemen (oder via Session) zwischenspeichern, damit diese nach der Bezahlung des Kunden auf der Success/Failed Page verfügbar bleibt. Dies kann sinnvoll sein, wenn man z. B. auf der Success Page die Transaktionsdetails für den Käufer auflisten möchte über die «Transaction Read» API/SDK Methode.

    Webhooks

    Webhooks dienen dazu Status Updates (z. B. der Transaktionen) an ihre internen Systeme weiterzuleiten (z. B. ihr Shop Backend oder ihre ERP/CRM Applikation).

    Der gesendete Webhook an Ihre System-Schnittstelle beinhaltet u.a. jeweils die ID der Entität (z. B. der Transaktion) sowie im Webhook Signatur Prozess den Status (z. B. Transaktionsstatus).

    Weitere Informationen zu Webhooks finden Sie auf Der Link öffnet sich in einem neuen Fenster checkout.postfinance.ch.

  • Eine ausführliche Dokumentation finden Sie auf Der Link öffnet sich in einem neuen Fenster checkout.postfinance.ch.

  • Ja, unter «Features» können Sie die Option «Token» aktivieren.

    Genauere Informationen für die Implementierung finden Sie auf Der Link öffnet sich in einem neuen Fenster checkout.postfinance.ch.

  • Lightbox

    Der Benutzer gibt die Zahlungsdetails in einem Overlay ein. Das Formular überlagert die Webseite des Händlers.

    Der Link öffnet sich in einem neuen Fenster Dokumentation zu Lightbox auf checkout.postfinance.ch

    iFrame

    Der Benutzer gibt die Zahlungsdetails in einem iFrame ein, das von uns gehostet wird. Das iFrame selbst kann in die Webseite des Händlers eingebettet werden.

    Der Link öffnet sich in einem neuen Fenster Dokumentation zu iFrame auf checkout.postfinance.ch

  • Ja, Sie können die Zahlungsmaske, E-Mailvorlagen und Rechnungsvorlagen individuell anpassen.

    Für einfache Anpassungen gehen Sie in ihrem Space unter «Einstellungen» > «Anpassung» > «Ressourcen-Einstellungen». Unter den Tabs «E-Mail», «Web» (für Zahlungsmasken), «Dokument» (für Rechnungsvorlagen) können Sie Anpassungen vornehmen.

    Für komplexere Anpassungen gehen Sie in ihrem Space unter «Einstellungen» > «Anpassungen» > «Ressourcen-Editor». Im Editor können Sie die Zahlungsmaske (Ordner «web»), E-Mailtemplates (Ordner «email») und Rechnungen (Ordner «document») auch mit einer TWIG-Vorlage individualisieren. Dort können Sie auch einzelne Elemente entfernen oder individuell hinzufügen, durch die Anpassung von HTML & CSS (Style) Code. Durch TWIG Code können Sie zudem Variablen (z. B. Transaktionseigenschaften einer Bezahlung) einem Template hinzufügen.

    Siehe hierzu unsere TWIG Dokumentation auf Der Link öffnet sich in einem neuen Fenster checkout.postfinance.ch.

PAX-Kartenterminal

    1. Terminal bestellen unter Der Link öffnet sich in einem neuen Fenster terminal-shop.postfinance.ch
    2. Produkt auswählen und Abo abschliessen
    3. Terminal konfigurieren im Space auf dem Dashboard inklusive Auswahl der gewünschten Zahlungsmethoden
    4. Sobald mindestens ein Akzeptanzpartner den Status «Aktiv» hat, wird Ihnen ein Aktivierungscode in Ihrem Checkout Account angezeigt.
    5. Eingabe des Aktivierungscode in Ihrem Terminal
    6. Terminal ist einsatzbereit

    Weitere Informationen zum Einrichten des Terminals finden Sie auf Der Link öffnet sich in einem neuen Fenster checkout.postfinance.ch.

    • PostFinance (PostFinance Card)
    • Worldline (Mastercard, Visa, Maestro, Vpay, TWINT, China Union Pay)
    • Swisscard (American Express)
    • Concardis (Mastercard, Visa, Maestro, Vpay)
    • Wallee/Snapswap (Visa, Mastercard, PostFinance Card, TWINT)
  • Unsere Zahlungsart PostFinance Card wird in der Regel innert 10 Arbeitstagen aktiviert. Die Aktivierung der anderen Zahlungsarten sind vom jeweiligen Akzeptanzpartner abhängig.

  • Damit die Terminals aktiviert werden können, ist ein aktives Abo für PostFinance Checkout Flex oder PostFinance POS-Payment Flex eine Voraussetzung. Zusätzlich werden für die monatlichen Abonnementsgebühren ein PostFinance Geschäftskonto oder eine Kreditkarte verlangt.

  • Im Space können die Terminals unter «Konfigurationen» nach Ihren Bedürfnissen konfiguriert werden. In diesen Einstellungen können diverse Anpassungen wie zum Beispiel zu den Transaktionskonfigurationen, Belegdruck, Belegkopf oder Trinkgeld vorgenommen werden.

Wechsel von PostFinance Card/PostFinance E-Finance zu PostFinance Pay für Onlineshops

  • Das Vorgehen zur Aktivierung von PostFinance Pay finden Sie nach dem Login mit Ihrem persönlichen Account unter «Space» > «Manuelle Tasks» im zugehörigen Task beschrieben. Folgen Sie den Anweisungen und die Umstellung ist in wenigen Minuten durchgeführt.

    Eine detaillierte Schritt-für-Schritt-Anleitung finden Sie hier:

    Der Link öffnet sich in einem neuen Fenster Anleitung für die Aktivierung PostFinance Pay (PDF)

    Wichtiger Hinweis: Sie erhalten per Brief die Information, sobald PostFinance Pay und somit die zugehörigen manuellen Tasks bei Ihnen im Backoffice zur Verfügung stehen (nur für Händler mit dem PSP Checkout). Händler mit einem anderen PSP erhalten die Informationen zur Aktivierung von PostFinance Pay zu einem späteren Zeitpunkt. Die Kommunikation erfolgt in Abhängigkeit zur Timeline des jeweiligen PSP.

  • Das Vorgehen zur Deaktivierung der bisherigen PostFinance-Zahlungsarten finden Sie nach dem Login mit Ihrem persönlichen Account unter «Space» > «Manuelle Tasks» im zugehörigen Task beschrieben. Der manuelle Task erscheint automatisch, wenn die Aktivierung von PostFinance Pay abgeschlossen ist.

    Eine detaillierte Schritt-für-Schritt-Anleitung finden Sie hier:

    Der Link öffnet sich in einem neuen Fenster Anleitung für die Deaktivierung der bisherigen PostFinance-Zahlungsarten (PDF)

    Wichtiger Hinweis: Sie erhalten per Brief die Information, sobald PostFinance Pay und somit die zugehörigen manuellen Tasks bei Ihnen im Backoffice zur Verfügung stehen (nur für Händler mit dem PSP Checkout). Händler mit einem anderen PSP erhalten die Informationen zur Aktivierung von PostFinance Pay zu einem späteren Zeitpunkt. Die Kommunikation erfolgt in Abhängigkeit zur Timeline des jeweiligen PSP.

  • Analog zu den bisherigen PostFinance-Zahlungsarten unterstützt PostFinance Pay die Registration der Zahlungsart im Onlineshop (PostFinance Pay Token) für wiederkehrende Zahlungen und One-Touch-Zahlungen. Haben sich Shopper:innen in Ihrem Onlineshop bereits mit der Zahlungsart PostFinance Card registriert, werden sie automatisch auf PostFinance Pay migriert und müssen sich nicht erneut registrieren. Vorausgesetzt, die beim Alias hinterlegte PostFinance Card ist noch gültig und die Kund:in hat E-Finance.

    Technischer Ablauf für die Token-Migration:

    1. Die Alias-Token-Migration startet mit der Aktivierung der neuen Zahlungsart PostFinance Pay im Backoffice Ihres Payment Service Providers automatisch im Hintergrund (siehe «Wie kann ich PostFinance Pay aktivieren?»).
    2. Die Alias-Migration dauert 24 Stunden. Wichtig ist deshalb, dass Sie während dieser Zeit die bisherigen Zahlungsarten nicht deaktivieren.

    PostFinance Pay Token-Version bei Ihrem Payment Service Provider anfragen

    Damit die migrierten PostFinance Pay Token Ihrer Kund:innen korrekt in Ihrem Onlineshop angezeigt werden, müssen Sie als Händler die neue Version der PostFinance Pay Token bei Ihrem Payment Service Provider für alle Aliase anfragen (Trigger Request «Token Merchant Update») und den Shopper:innen entsprechend darstellen. Bei einem Alias für die PostFinance Card erscheint die Token-Version als eine maskierte Kartennummer mit Ablaufdatum und einer Image-URL zum PostFinance-Card-Logo. Bei einem PostFinance Pay Token wird die Token-Version als maskierte IBAN angezeigt und enthält eine Image-URL zum PostFinance-Pay-Logo.