TWINT

Introduction

TWINT est un système de paiement bancaire/prépayé en temps réel suisse.

Avec plus de 3,5 millions d'utilisateurs actifs, TWINT est la méthode de paiement la plus populaire en Suisse. En reliant leurs comptes bancaires, cartes de crédit ou cartes prépayées à l'application TWINT, vos clients peuvent facilement effectuer des transactions de faible montant (par exemple, payer un parking par téléphone, commander de la nourriture ou régler des factures).

Vous envoyez une requête standard à notre plateforme pour rediriger vos clients vers le portail TWINT afin d'ouvrir l'application.
L'intégration est très simple, car il vous suffit d'envoyer un paramètre supplémentaire avec votre demande.

Optimisé pour Desktop Mobile

Aperçu

Groupe de paiement :

Banque en temps réel

Identifiant du moyen de paiement:

5407

Avantages clés

Exigences PCI faibles (aucune donnée sensible ou personnelle partagée)
Intégration facile
Très populaire en Suisse
Permet
- Autorisations
- Captures partielles/intégrales
- Remboursements partiels/multiples/intégraux
- Annulations complètes

Pays & devises

Pays pris en charge

Suisse

Devises prises en charge

Swiss franc (CHF)

Intégration

Redirigez vos clients vers l'application TWINT via notre Hosted Checkout Page. Retrouvez une vue d'ensemble dans le chapitre "Cinématique".

Ajoutez les propriétés suivantes à une requête standard CreateHostedCheckout :

{
   "order":{
      "amountOfMoney":{
         "currencyCode":"CHF",
         "amount":1700
      },
      "redirectPaymentMethodSpecificInput":{
         "paymentProductId":5407,
         "requiresApproval":false
      }
   }
}

Propriétés	Remarques
order.amountOfMoney amount currencyCode	amount : Le montant brut que vous souhaitez facturer pour cette commande. currencyCode : Le code de devise ISO 4217 correspondant à ce montant.
redirectPaymentMethodSpecificInput paymentProductId requiresApproval	paymentProductId : L'identifiant numérique de la méthode de paiement sur notre plateforme. Retrouvez cet ID dans le chapitre "Aperçu". Il indique à notre plateforme d'envoyer directement vos clients vers la version de notre Hosted Checkout Page avec la marque TWINT. En cas d'omission, notre plateforme redirige vos clients vers la Hosted Checkout Page, leur permettant de choisir ce mode de paiement ou tout autre actif dans votre compte. requiresApproval : Définissez cette valeur sur "true" ou "false" selon que vous souhaitez traiter les paiements en mode autorisation ou Direct Sale.

Propriétés

Remarques

order.amountOfMoney
amount
currencyCode

amount : Le montant brut que vous souhaitez facturer pour cette commande.
currencyCode : Le code de devise ISO 4217 correspondant à ce montant.

redirectPaymentMethodSpecificInput
paymentProductId
requiresApproval

paymentProductId : L'identifiant numérique de la méthode de paiement sur notre plateforme. Retrouvez cet ID dans le chapitre "Aperçu". Il indique à notre plateforme d'envoyer directement vos clients vers la version de notre Hosted Checkout Page avec la marque TWINT. En cas d'omission, notre plateforme redirige vos clients vers la Hosted Checkout Page, leur permettant de choisir ce mode de paiement ou tout autre actif dans votre compte.

requiresApproval : Définissez cette valeur sur "true" ou "false" selon que vous souhaitez traiter les paiements en mode autorisation ou Direct Sale.

Retrouvez des informations détaillées sur cet objet et ses propriétés dans notre documentation CreateHostedCheckoutAPI.

Cinématique

Selon le(s) appareil(s) utilisé(s) 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

Ce flux implique l'interaction entre l'ordinateur et l'appareil mobile/tablette de vos clients.

Vos clients finalisent une commande sur leur ordinateur dans votre boutique et sélectionnent TWINT.
Vous envoyez cette requête CreateHostedCheckout à notre plateforme.
Vous redirigez vos clients sur leur ordinateur via l'URL de redirection redirectUrl vers notre Hosted Checkout Page.
Vos clients scannent le QR code affiché avec leur appareil mobile/tablette ou saisissent manuellement le code affiché dans leur application TWINT.
L'appareil mobile/tablette ouvre l'application TWINT. Vos clients confirment le paiement dans l'application.
Nous recevons le résultat de la transaction.
L'appareil mobile/tablette ouvre le navigateur standard et redirige vos clients vers votre returnURL. Nous redirigeons également vos clients vers votre returnURL sur leur ordinateur.
Vous demandez le résultat de la transaction à notre plateforme via GetHostedCheckout ou recevez le résultat via webhooks.
Si la transaction a été réussie, vous pouvez livrer les biens / services.

Avec un appareil mobile

Vos clients finalisent une commande dans votre boutique et sélectionnent TWINT.
Vous envoyez cette requête CreateHostedCheckout à notre plateforme.
Vous redirigez vos clients via l'URL de redirection redirectUrl vers notre Hosted Checkout Page où ils cliquent sur le bouton "Passer à l'application".
L'appareil mobile ouvre l'application TWINT. Vos clients confirment le paiement dans l'application.
Nous recevons le résultat de la transaction.
L'application redirige vos clients vers votre returnURL.
Vous demandez le résultat de la transaction à notre plateforme via GetHostedCheckout ou recevez le résultat via webhooks.
Si la transaction a été réussie, vous pouvez livrer les biens / services.

Test

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

Assurez-vous d'utiliser le bon endpoint et de renseigner l'URL de production dès que vous avez terminé vos tests.