Questions et réponses sur Checkout Flex et Checkout All‑in‑one

Vous obtiendrez ici des réponses aux questions concernant les mises à niveau, les transactions, les plug-ins et bien plus encore.

Aperçu

  • PostFinance Checkout propose plusieurs services de paiement. La pièce maîtresse est constituée par l’outil back-office PostFinance Checkout, qui permet les paiements via nos terminaux de paiement par carte PAX ou les plug-ins de boutique en ligne.

    Vous pouvez vous inscrire gratuitement à tout moment et tester notre solution en mode simulation. Inscrivez-vous sous La cible du lien s'ouvre dans une nouvelle fenêtre checkout.postfinance.ch.

    Si vous êtes intéressé(e) par nos terminaux de paiement physiques PAX, n’hésitez pas à consulter notre boutique de terminaux sous La cible du lien s'ouvre dans une nouvelle fenêtre terminal-shop.postfinance.ch.

    Cherchez un plug-in de paiement adapté à votre boutique en ligne, rendez-vous sur notre page GitHub La cible du lien s'ouvre dans une nouvelle fenêtre github.com/pfpayments. Nous prenons en charge des systèmes de boutique établis tels que WooCommerce, Shopify (intégration directe dans la boutique), Magento 2, Shopware, Prestashop, OXID, Gambio, OpenCart et quelques autres. Avec notre plug-in PostFinance Subscription pour WooCommerce, vous pouvez également proposer des produits d’abonnement (paiements récurrents) dans votre boutique. Vous pouvez télécharger directement les plug-ins et les installer dans votre boutique. Vous pourrez ensuite tester gratuitement notre check-out.

    En cas d’intégrations pour des développements individuels, nous proposons l’API PostFinance Checkout et divers SDK dans différents langages de programmation (PHP, Java, C#, Python, TypeScript, etc.). Pour cela, consultez notre documentation AP sur La cible du lien s'ouvre dans une nouvelle fenêtre checkout.postfinance.ch.

    Vous trouverez tous les liens de documentation vers les plug-ins et les instructions relatives aux terminaux de paiement par carte sur La cible du lien s'ouvre dans une nouvelle fenêtre checkout.postfinance.ch/doc.

Top 5 des questions

  • PostFinance (PostFinance Pay, e-finance de PostFinance)
    E-mail: checkout@postfinance.ch, téléphone: 0848 382 423 (max. CHF 0.08/min. en Suisse)

    Wallee/Snapswap (Visa, Mastercard, TWINT, PostFinance Pay)
    E-mail: info@wallee.com, téléphone: 044 505 13 60

    Worldline SIX (Visa, Mastercard, TWINT, China Union Pay, Diners)
    E-commerce
    E-Mail: cs.ecom@worldline.com, téléphone: 0848 83 20 00
    Point de vente (POS)
    E-Mail: customerservice@worldline.com, téléphone: 0848 83 20 00

    Concardis (Visa, Mastercard, Diners)
    E-mail: servicech@nets.eu, téléphone: 058 220 58 58

    FirstData (Visa, Mastercard, Diners, JCB, China Union Pay)
    E-mail: fde-service@fiserv.com, téléphone: 0800 550 014

    Swisscard (American Express)
    E-mail: partner.service@swisscard.ch, téléphone: 044 659 64 44

    PowerPay (MF Group, paiement sur facture)
    E-mail: partner@mfgroup.ch, téléphone: 058 806 06 31

    Boncard (WIR, Boncard, Swiss Pay, Gift Card, Lunch-Check, EKZ card)
    E-mail: pool@boncard.ch, téléphone: 0848 080 408

    TWINT SA (TWINT)
    E-mail: support@twint.ch, téléphone: 058 667 98 44

    PayPal
    Coordonnées sur La cible du lien s'ouvre dans une nouvelle fenêtre paypal.com

  • Vous trouverez l’aperçu actuel et la documentation sur La cible du lien s'ouvre dans une nouvelle fenêtre checkout.postfinance.ch.
  • Le produit Checkout All-in-One est basé sur une offre Collecting. Cela signifie que tous les modes de paiement (PostFinance Pay, Visa, Mastercard et TWINT) sont traités via un contrat. D’autres méthodes de paiement ne peuvent pas être ajoutées.

    Outre l’offre de collecte, vous disposez pour le produit Checkout Flex d’autres méthodes de paiement (p. ex. American Express ou cryptomonnaies) et de partenaires d’acceptation. Pour cela, un contrat séparé doit être conclu avec chaque partenaire d’acceptation. Avec Checkout Flex, vous avez également la possibilité d’effectuer des transactions récurrentes (p. ex. des abonnements).

    Vous pouvez vous inscrire gratuitement à tout moment sur La cible du lien s'ouvre dans une nouvelle fenêtre checkout.postfinance.ch. Après la création du compte, sélectionnez le produit souhaité et lancez le mode de simulation gratuit.

  • Nous prenons déjà en charge Apple Pay. Veuillez clarifier avec votre prestataire de services de paiement s’il prend également en charge le mode de paiement dans le traitement.

    Nous prenons également en charge les cryptomonnaies (Bitcoin Suisse) avec une connexion via le processeur Worldline.

    Checkout Flex fait l’objet d’un développement et d’une extension permanents. Les nouveaux modes de paiement disponibles peuvent être consultés sur La cible du lien s'ouvre dans une nouvelle fenêtre checkout.postfinance.ch. Vous voyez également ici quels partenaires d’acceptation prennent en charge quels modes de paiement par notre intermédiaire.

  • Suivez les instructions étape par étape pour configurer votre terminal PAX.

Questions générales

  • L’erreur 403 indique qu’un utilisateur ne dispose pas des autorisations nécessaires. En tant qu’utilisateur administrateur, vous pouvez autoriser d’autres collaborateurs à accéder à votre compte en créant des utilisateurs et en leur attribuant ces rôles et autorisations.

    Si vous n’attribuez pas de rôle ni d’autorisation à ces utilisateurs, ils ne pourront pas accéder à votre compte et recevront à la place la page d’erreur «Accès refusé – Code d’erreur: 403».

    Veillez à toujours attribuer les droits de lecture correspondants aux niveaux Space et Account. Les utilisateurs doivent donc au moins disposer des droits de lecture au niveau Space ou Account.

    La cible du lien s'ouvre dans une nouvelle fenêtre Documentation Concept d’autorisation sur checkout.postfinance.ch

  • Vérifiez avec quel mode de paiement la commande a été payée. Adressez-vous ensuite au partenaire d’acceptation compétent (cf. question ci-dessus «Quels sont les partenaires d’acceptation et les modes de paiement pris en charge?»).
  • Lors de l’inscription, un compte vous a été automatiquement attribué. Lorsque vous êtes dans l’aperçu de votre compte, vous voyez un numéro après le symbole «#» en haut à gauche. Il s’agit de votre AccountID unique.

    Votre compte permet de relier tous vos Spaces ainsi que votre abonnement Checkout actuel (Flex, tout-en-un).

    Vos espaces sont des liens vers vos plug-ins de paiement dans vos boutiques en ligne ou vers vos terminaux de paiement par carte PAX. Ici, vous pouvez configurer tout ce qui a trait à votre exploitation quotidienne en matière de paiements:

    • Mise en place de méthodes de paiement
    • Lien vers le plug-in de paiement dans vos systèmes e-commerce ou vers votre propre développement que vous avez programmé avec notre API REST
    • Lien vers vos terminaux de paiement PostFinance Checkout PAX
    • Consultation des transactions de paiement et de leur traitement (enregistrement comptable, remboursements, annulations)
    • Autres fonctions

    Lorsque vous êtes dans votre Space, vous voyez également l’ID du Space en haut à gauche après le symbole «#».

Abonnement

  • Un passage de All-in-one à Flex ou inversement peut être demandé auprès de checkout@postfinance.ch. Pour cela, indiquez votre AccountID et envoyez un e-mail à partir de l’adresse e-mail enregistrée dans Checkout.

  • Une résiliation de l’abonnement peut être effectuée à tout moment dans le back-office Checkout. Dans l’espace connecté, sélectionnez Account > Plan > Annuler le plan.

    Le contrat Checkout sera résilié pour votre prochaine facturation (max. 30 jours).

  • Checkout All-in-One: deux Spaces sont compris dans le prix. Nous recommandons d’utiliser un Space pour l’environnement de production et le deuxième pour votre environnement de test. Si vous souhaitez utiliser deux boutiques en ligne productives, vous devez conclure un contrat d’acceptation supplémentaire dans le menu Organisation.

    Checkout Flex: deux Spaces/boutiques en ligne sont compris(e)s dans les frais mensuels. Moyennant des frais mensuels, vous pouvez ouvrir autant de Spaces/boutiques en ligne que vous le souhaitez.

    Veuillez noter que de nouveaux contrats d’acceptation doivent être établis pour les modes de paiement souhaités pour chaque Space.

  • L’activation de l’abonnement PostFinance Checkout dure 1–2 jours ouvrés dès que vous avez signé le contrat en ligne. Pour ce faire, rendez-vous sur «Account» > «Plan» > «Activer l’abonnement Checkout».

    La durée d’activation des différents modes de paiement dépend du partenaire d’acceptation concerné (Worldline, PostFinance, Wallee/Snapswap, etc.).

  • Les frais d’activation ainsi que les frais mensuels sont toujours débités du compte commercial PostFinance ou de la carte de crédit enregistrés.
  • Non. Pour le débit des frais, vous pouvez inscrire une carte de crédit suisse comme alternative au compte commercial PostFinance. Le paiement est effectué sur le compte bancaire souhaité d’une banque suisse.

Plug-ins

  • PostFinance examine en permanence la situation actuelle du marché et élargit en continu le nombre de plug-ins.
  • Veuillez d’abord contacter le fournisseur de votre logiciel de boutique. Il se peut qu’une connexion API ait déjà été établie.

    PostFinance Checkout peut également être intégré via Web Services REST API. Vous trouverez de la documentation détaillée sur La cible du lien s'ouvre dans une nouvelle fenêtre checkout.postfinance.ch.

    Vous trouverez d’autres informations et conseils utiles à ce sujet sur La cible du lien s'ouvre dans une nouvelle fenêtre github.com/pfpayments.

  • Vous utilisez le module E-Payment pour Checkout pour accepter les paiements par carte dans votre boutique en ligne Shopify.

    Votre boutique en ligne est connectée au module E-Payment pour Checkout via une application. Bientôt, les paiements ne pourront plus être traités via l’application que vous utilisez actuellement, car Shopify ne supportera plus l’interface actuelle. Vous devrez donc passer à la nouvelle application de paiement Shopify d’ici le 31 mai 2024. Celle-ci est dès à présent disponible dans votre back-end Shopify.

    Ce changement ne prend que quelques minutes, il vous suffit de suivre les instructions:

    La cible du lien s'ouvre dans une nouvelle fenêtre Instructions pour passer à la nouvelle PostFinance Checkout App pour Shopify (PDF)

    Une fois le changement effectué, notre nouveau moyen de paiement PostFinance Pay est à votre disposition. Celui-ci remplacera désormais nos deux anciens moyens de paiement PostFinance Card et PostFinance E-Finance.

    En raison de cette adaptation nécessaire, des frais supplémentaires de 0,3% sur vos achats s’appliquent. Ils seront facturés via la méthode de paiement que vous avez enregistrée sur PostFinance Checkout (compte ou carte de crédit PostFinance). Ces frais nous sont facturés par Shopify, nous ne faisons que les transmettre à nos commerçantes et commerçants.

    Si vous avez déjà effectué le passage à la nouvelle application de paiement Shopify, vous n’avez rien à faire de plus.

    Si vous avez des questions, n’hésitez pas à vous tourner vers notre assistance (checkout@postfinance.ch ou 0848 382 423).

Propre développement via API/SDK

  • Success/Failed URL

    Les Success/Failed URL sont définies sur la transaction avant le paiement sur la Payment Page ou sur Lightbox/Iframe. En fonction de la réussite ou de l’échec de la transaction, l’acheteur est redirigé vers l’URL Success/Failed de votre boutique.

    Vous pouvez également extraire l’ID de transaction dans Response selon la méthode «Transaction Create» API/SDK (avant même la transmission pour paiement) et l’enregistrer temporairement dans vos systèmes (ou via session) afin qu’elle reste disponible sur la Success/Failed Page après le paiement du client. Cela peut s’avérer judicieux si l’on souhaite p. ex. lister les détails de la transaction pour l’acheteur sur la Success Page via la méthode «Transaction Read» API/SDK.

    Webhooks

    Les webhooks servent à transmettre des mises à jour de statut (p. ex. des transactions) à leurs systèmes internes (p. ex. leur back-end de boutique ou leur application ERP/CRM).

    Le Webhook envoyé à votre interface système contient notamment l’ID de l’entité (p. ex. de la transaction) ainsi que le statut dans le processus de signature du Webhook (p. ex. statut de transaction).

    Vous trouverez de plus amples informations sur les Webhooks sur La cible du lien s'ouvre dans une nouvelle fenêtre checkout.postfinance.ch.

  • Vous trouverez de la documentation détaillée sur La cible du lien s'ouvre dans une nouvelle fenêtre checkout.postfinance.ch.

  • Oui, vous pouvez activer l’option «Canal de vente via les cartes déposées».

    Vous trouverez des informations plus détaillées relatives à la mise en œuvre sur La cible du lien s'ouvre dans une nouvelle fenêtre checkout.postfinance.ch.

  • Lightbox

    L’utilisateur saisit les détails de paiement dans une fenêtre superposée. Le formulaire se superpose au site web du commerçant.

    La cible du lien s'ouvre dans une nouvelle fenêtre Documentation sur Lightbox sur checkout.postfinance.ch

    iFrame

    L’utilisateur saisit les détails de paiement sur une iFrame que nous hébergeons. L’iFrame peut elle-même être intégrée au site web du commerçant.

    La cible du lien s'ouvre dans une nouvelle fenêtre Documentation sur iFrame sur checkout.postfinance.ch

  • Oui, vous pouvez adapter individuellement le masque de paiement, les modèles d’e-mail et les modèles de facture.

    Pour des modifications simples, rendez-vous dans votre Space sous «Paramètres» > «Personnalisation» > «Paramètre des ressources». Vous pouvez effectuer des modifications sous les onglets E-mail, Web (pour les masques de paiement), Document (pour les modèles de facture).

    Pour les adaptations plus complexes, rendez-vous dans votre Space sous «Paramètres» > «Personnalisation» > «Editor de ressources». Dans l’éditeur, vous pouvez également personnaliser le masque de paiement (dossier «web»), les modèles d’e-mail (dossier «email») et les factures (dossier «document») avec un modèle TWIG. Vous pouvez également y supprimer des éléments individuels ou les ajouter individuellement en adaptant le code HTML et CSS (Style). Le code TWINT vous permet en outre d’ajouter des variables (p. ex. propriétés de transaction d’un paiement) à un modèle.

    Voir à ce sujet notre documentation TWIG sur La cible du lien s'ouvre dans une nouvelle fenêtre checkout.postfinance.ch.

Terminaux de paiement par carte PAX

    1. Commander un terminal sur La cible du lien s'ouvre dans une nouvelle fenêtre terminal-shop.postfinance.ch
    2. Sélectionner le produit et souscrire l’abonnement
    3. Configurer le terminal dans le space sur le dashboard, y compris la sélection des modes de paiement souhaités
    4. Dès qu’au moins un partenaire d’acceptation a le statut «Actif», un code d’activation s’affiche dans votre compte de Checkout.
    5. Saisie du code d’activation dans votre terminal
    6. Le terminal est opérationnel

    Vous trouverez de plus amples informations sur l’installation du terminal sur La cible du lien s'ouvre dans une nouvelle fenêtre 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)
  • En règle générale, notre mode de paiement PostFinance Card est activé dans les 10 jours ouvrables. L’activation des autres modes de paiement dépend du partenaire d’acceptation concerné.

  • Pour que les terminaux puissent être activés, un PostFinance Checkout Flex ou un PostFinance POS-Payment Flex est une condition préalable. En outre, un compte commercial PostFinance ou une carte de crédit doit être enregistré pour les frais d'abonnement mensuels.

  • Dans le Space, les terminaux peuvent être configurés selon vos besoins sous «Configurations». Dans ces paramètres, diverses modifications peuvent être effectuées, par exemple concernant les configurations de transactions, l’impression de justificatifs, l’en-tête de justificatif ou le pourboire.

Passage de PostFinance Card/PostFinance e-finance à PostFinance Pay pour les boutiques en ligne

  • Pour activer PostFinance Pay, rendez-vous sous «Space > Tâches manuelles» après la connexion à votre compte personnel et retrouvez le descriptif dans la tâche correspondante. Suivez les instructions: la migration s’effectue en quelques minutes.

    Vous trouverez des instructions détaillées étape par étape ici:

    La cible du lien s'ouvre dans une nouvelle fenêtre Instructions pour l’activation de PostFinance Pay (PDF)

    Remarque importante: vous recevrez cette information par courrier dès que PostFinance Pay et donc les tâches manuelles correspondantes seront disponibles dans votre back-office (uniquement pour les commerçants avec PSP Checkout). Les commerçants faisant appel à un autre PSP recevront les informations concernant l’activation de PostFinance Pay à une date ultérieure. La communication se fera en fonction du calendrier de chacun des PSP.

  • Pour désactiver les anciens modes de paiement PostFinance, rendez-vous sous «Space > Tâches manuelles» après la connexion à votre compte personnel et retrouvez les détails dans la tâche correspondante. La tâche manuelle apparaît automatiquement une fois l’activation de PostFinance Pay terminée.

    Vous trouverez des instructions détaillées étape par étape ici:

    La cible du lien s'ouvre dans une nouvelle fenêtre Instructions pour lʼactivation de PostFinance Pay et la désactivation des anciens modes de paiement PostFinance (PDF)

    Remarque importante: vous recevrez cette information par courrier dès que PostFinance Pay et donc les tâches manuelles correspondantes seront disponibles dans votre back-office (uniquement pour les commerçants avec PSP Checkout). Les commerçants faisant appel à un autre PSP recevront les informations concernant l’activation de PostFinance Pay à une date ultérieure. La communication se fera en fonction du calendrier de chacun des PSP.

  • Comme pour les modes de paiement actuels de PostFinance, PostFinance Pay prend en charge l’enregistrement du mode de paiement dans la boutique en ligne (token PostFinance Pay) pour les paiements récurrents et les paiements One Touch. Les acheteuses et acheteurs qui se sont déjà enregistrés avec le mode de paiement PostFinance Card dans leur boutique en ligne seront migrés automatiquement vers PostFinance Pay et ne devront pas s’enregistrer à nouveau. La condition est la suivante: la PostFinance Card enregistrée sous l’alias est encore valable et la cliente ou le client possède e-finance.

    Déroulement technique pour la migration des tokens:

    1. La migration des tokens d’alias débute automatiquement en arrière-plan dès l’activation du nouveau mode de paiement PostFinance Pay dans le back-office de votre prestataire de services de paiement (voir «Comment activer PostFinance Pay?»).
    2. La migration d’alias dure 24 heures. Par conséquent, il est important que vous ne désactiviez pas vos modes de paiement actuels pendant cette période.

    Demander la version token PostFinance Pay auprès de votre prestataire de services de paiement

    Afin que les tokens PostFinance Pay migrés de vos clients et clientes soient correctement affichés dans leur boutique en ligne, vous devez, en tant que commerçant, demander la nouvelle version du token PostFinance Pay auprès de votre prestataire de services de paiement pour tous les alias (déclencheur demande «Token Merchant Update»). Dans le cas d’un alias pour la PostFinance Card, la version du token apparaît comme un numéro de carte masqué avec une date d’échéance et une URL image vers le logo de la PostFinance Card. Dans le cas d’un token PostFinance Pay, la version du token apparaît comme un numéro IBAN masqué et contient une URL image vers le logo de PostFinance Pay.