PostFinance Pay

Pays & devises

Pays pris en charge

• Autriche
• Belgique
• Bulgarie
• Croatie
• Chypre
• République tchèque
• Danemark
• Estonie
• Finlande
• France
• Allemagne
• Grèce
• Hongrie
• Irlande
• Italie
• Lettonie
• Lituanie
• Luxembourg
• Malte
• Pays-Bas
• Pologne
• Portugal
• Roumanie
• Slovaquie
• Slovénie
• Espagne
• Suède
• Suisse
• Royaume-Uni

Devises prises en charge

• Swiss franc (CHF)

Intégration

Redirigez vos clients vers l'application PostFinance Pay via les modes d'intégration Hosted Checkout Page ou Server-to-server. Retrouvez une vue d'ensemble dans le chapitre "Cinématique".

Ajoutez les propriétés suivantes à votre requête de paiement CreateHostedCheckout/CreatePayment :

{ 
    ""order"": { 
        ""amountOfMoney"": { 
            ""amount"": 100, 
            ""currencyCode"": ""CHF"" 
        } 
    }, 
    ""hostedCheckoutSpecificInput"": { 
        ""returnUrl"": ""https://yourRedirectionUrl.com""
    }, 
    ""redirectPaymentMethodSpecificInput"": { 
        ""paymentProductId"": 3203, 
        ""requiresApproval"": false 
    } 
}

Cinématique

En fonction du type d'appareil utilisé par vos clients, des différences s'appliquent :

• Avec un ordinateur et un appareil mobile
• Avec un appareil mobile

Avec un ordinateur et un appareil mobile

1. Vos clients finalisent une commande dans votre boutique et sélectionnent PostFinance Pay.
2. Vous adressez une requête de paiement CreateHostedCheckout/CreatePayment à notre plateforme.
3. Vous redirigez vos clients via le redirectUrl (pour les demandes CreateHostedCheckout) ou merchantAction.redirectData.redirectURL (pour les demandes CreatePayment) vers le portail PostFinance Pay.
4. Vos clients scannent le QR code affiché avec leur appareil mobile/tablette.
5. L'appareil mobile/tablette ouvre l'application PostFinance Pay. Vos clients confirment le paiement dans l'application.
6. Nous recevons le résultat de la transaction.
7. L'appareil mobile/tablette affiche le résultat de la transaction dans l'application PostFinance Pay. Nous redirigeons vos clients vers votre returnURL.
8. Vous demandez le résultat de la transaction à notre plateforme via l'opération GetPaymentDetails/GetHostedCheckout ou recevez le résultat via webhooks.
9. Si la transaction a réussi, vous pouvez délivrer les biens/services.

Avec un appareil mobile

1. Vos clients finalisent une commande sur leur appareil mobile/tablette dans votre boutique et sélectionnent PostFinance Pay.
2. Vous adressez une requête de paiement CreateHostedCheckout/CreatePayment à notre plateforme.
3. Vous redirigez vos clients via le redirectUrl (pour les demandes CreateHostedCheckout) ou merchantAction.redirectData.redirectURL (pour les demandes CreatePayment). L'appareil mobile/tablette ouvre l'application PostFinance Pay.
4. Vos clients confirment le paiement dans l'application.
5. Nous recevons le résultat de la transaction.
6. L'appareil mobile/tablette affiche le résultat de la transaction dans l'application PostFinance Pay.
7. Vous demandez le résultat de la transaction à notre plateforme via l'opération GetPaymentDetails/GetHostedCheckout ou recevez le résultat via webhooks.
8. Si la transaction a réussi, vous pouvez délivrer les biens/services.

Test

Consultez nos Cas de test pour des données de test et des instructions détaillées.

Informations supplémentaires

PostFinance Pay implémente deux fonctionnalités qui améliorent l'expérience de paiement de vos clients : les paiements Card On File et le mode Express Checkout. 

Paiements Card On File

PostFinance Pay prend en charge les paiements récurrents sans nécessité que le client initie manuellement chaque paiement.

Création d'un token

Créez un token lors du paiement initial. Utilisez-le pour les transactions suivantes, afin que vos clients n'aient pas à ressaisir leurs informations de paiement.

Pour ce faire, renseignez la propriété redirectPaymentMethodSpecificInput=true  dans la requête de paiement initiale CreatePayment/CreateHostedCheckout.

Création d'un token pour les cas d'abonnements

Vous pouvez également créer un token hors contexte de paiement. Pour ce faire, renseignez la propriété redirectPaymentMethodSpecificInput=true et order.amountOfMoney.amount=0  dans la requête de paiement initiale CreatePayment/CreateHostedCheckout. Cela vous permet d'utiliser le token pour des paiements futurs (par exemple des abonnements).

Utilisation du token pour une transaction initiée par le commerçant (MIT)

Pour les échéances suivantes, vous pouvez réaliser des paiements avec un token existant. Comme cela ne requiert pas le consentement de vos clients, le processus est simplifié tant pour vous que pour vos clients.

Renseignez les propriétés suivantes dans la requête de paiement CreatePayment : 

{
   ""order"":{
      ""amountOfMoney"":{
         ""currencyCode"":""EUR"",
         ""amount"":1000
      }
   },
   ""redirectPaymentMethodSpecificInput"":{
      ""paymentProductId"":3203,
      ""requiresApproval"":false,
      ""token"":""your_token""
   }
}

Suppression d'un token

Si vos clients demandent à désactiver un token ou s'ils suppriment leurs données auprès de PostFinance Pay, vous devez supprimer le token existant. Une fois désactivé, le token ne peut pas être réutilisé. Pour ce faire, adressez une requête DeleteToken à notre plateforme. Si nécessaire, créez un nouveau token pour les transactions futures.

Express Checkout

Le mode Express Checkout simplifie le processus de paiement en réduisant les étapes que les clients doivent suivre pour effectuer un paiement. Demandez les coordonnées de vos clients directement depuis leurs comptes PostFinance Pay afin de leur éviter de devoir les saisir par eux-mêmes.

Pour ce faire, ajoutez la propriété paymentProduct3203SpecificInput.checkoutType à la requête de paiement initiale CreatePayment/CreateHostedCheckout :

{
   ""order"":{
      ""amountOfMoney"":{
         ""amount"":100,
         ""currencyCode"":""CHF""
      }
   },
   ""hostedCheckoutSpecificInput"":{
      ""returnUrl"":""https://yourRedirectionUrl.com""
   },
   ""redirectPaymentMethodSpecificInput"":{
      ""paymentProductId"":3203,
      ""requiresApproval"":false,
      ""paymentProduct3203SpecificInput"":{
         ""checkoutType"":""expressCheckout""
      }
   }
}