TWINT

Countries & currencies

Supported countries

• Switzerland

Supported currencies

• Swiss franc (CHF)

Integration

Nous proposons ces méthodes de paiement pour les modes d'intégration suivants. Découvrez dans nos guides dédiés les spécificités de chacun :

• Hosted Checkout Page
• Server-to-server

Découvrez un aperçu général dans le chapitre "Process flows".

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

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

Process flows

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.

1. Vos clients finalisent une commande sur leur ordinateur dans votre boutique et sélectionnent TWINT.
2. Vous envoyez cette requête CreateHostedCheckout à notre plateforme.
3. Vous redirigez vos clients sur leur ordinateur via l'URL de redirection redirectUrl vers notre Hosted Checkout Page.
4. Vos clients scannent le QR code affiché avec leur appareil mobile/tablette ou saisissent manuellement le code affiché dans leur application TWINT.
5. L'appareil mobile/tablette ouvre l'application TWINT. Vos clients confirment le paiement dans l'application.
6. Nous recevons le résultat de la transaction.
7. 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.
8. Vous demandez le résultat de la transaction à notre plateforme via GetHostedCheckout ou recevez le résultat via webhooks.
9. Si la transaction a été réussie, vous pouvez livrer les biens / services.

Avec un appareil mobile

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

Testing

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

Additional information

TWINT paiements récurrents (User-on-File)

TWINT paiements récurrents User-on-File (UoF) permet aux marchands de stocker l'identité TWINT de vos clients sous forme de jeton (alias), ce qui vous permet de les facturer selon un calendrier défini sans ré-authentification.

Cette fonctionnalité simplifie le processus de paiement pour vos clients et vous permet d'offrir des paiements récurrents, des abonnements et des versements échelonnés tout en gardant les données sensibles de la carte hors de votre périmètre.

Pour utiliser cette fonctionnalité, vous devez :

• Effectuer un paiement avec création de jeton ou créer un jeton autonome pour les abonnements.
• Utiliser le jeton pour les transactions suivantes initiées par le commerçant (MIT).

Paiement avec création de jeton

Effectuer un paiement et créer un jeton simultanément.

Définissez order.amountOfMoney.amount < 0 et redirectPaymentMethodSpecificInput.tokenise=true dans votre demande de paiement initiale :

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

Pour ce scénario, il existe deux résultats possibles :

Vos clients soit :

1. Accepter à la fois le paiement et l'enregistrement UoF (Utilisateur sur fichier), ce qui permet la création du jeton.
2. Accepter le paiement mais refuser l'inscription UoF (empêchant ainsi la création du jeton).

Dans le scénario 2, notre plateforme traitera la transaction mais ne créera pas de jeton. En conséquence, notre plateforme n'inclura pas la propriété paymentOutput.redirectPaymentMethodSpecificOutput.token dans la réponse de la requête CreatePayment ou dans les requêtes GetHostedCheckout/GetPaymentDetails. Veillez à gérer ce cas en conséquence.

Jeton autonome pour les abonnements

Effectuer une transaction dont le montant est nul afin de créer un jeton à utiliser ultérieurement.

Définissez order.amountOfMoney.amount=0 et redirectPaymentMethodSpecificInput.tokenise=true dans votre demande de paiement initiale :

{ 
    "order": { 
        "amountOfMoney": { 
            "amount": 0, 
            "currencyCode": "CHF" 
        } 
    }, 
    "hostedCheckoutSpecificInput": { 
        "returnUrl": "https://yourRedirectionUrl.com"
    }, 
    "redirectPaymentMethodSpecificInput": { 
        "paymentProductId": 5407, 
        "requiresApproval": true,
        "tokenize": true
    } 
}

Utilisation du jeton pour les transactions suivantes initiées par le commerçant (MIT)

Utilisez un jeton existant pour traiter les paiements suivants selon le cadre Card On File (COF).

{
   "order":{
      "amountOfMoney":{
         "currencyCode":"CHF",
         "amount":100
      }
   },
   "redirectPaymentMethodSpecificInput":{
      "paymentProductId":5407,
      "requiresApproval":false,
      "token":"your_TWINT_token"
   }
}