# Paiements TWINT

Découvrez TWINT, un moyen de paiement populaire en Suisse.

TWINT est un moyen de paiement utilisé en Suisse qui permet aux clients de [s’identifier et d’approuver](https://docs.stripe.com/payments/payment-methods.md#customer-actions) des paiements directement depuis l’application mobile TWINT autorisée.

Vous recevez une [notification immédiate](https://docs.stripe.com/payments/payment-methods.md#payment-notification) indiquant si le paiement a abouti ou échoué.
Payment method family: Wallets
Usability: Reusable
Access type: Approval required
Payment confirmation timing: Immediate
Settlement timing: Standard payout schedule
Pricing: https://stripe.com/en-ch/pricing/local-payment-methods#twint
## Éligibilité et disponibilité

### Éligibilité du compte
Business location: AT, BE, BG, CH, CY, CZ, DE, DK, EE, ES, FI, FR, GB, GI, GR, HR, HU, IE, IS, IT, LI, LT, LU, LV, MC, MT, NL, NO, PL, PT, RO, SE, SI, SK, SM
Account type: ✓ Merchant, ✓ Platform or marketplace (Connect)
Business model: ✗ B2B, ✓ B2C
Business category: View list of prohibited and restricted business categories
Avant de demander l’accès à TWINT dans le [Dashboard](https://dashboard.stripe.com/settings/payment_methods) ou via [l’API Capabilities](https://docs.stripe.com/api/capabilities.md), assurez-vous de respecter les exigences relatives au compte et au site web décrites dans cette section :

- Votre site web doit être opérationnel. Il ne doit pas être protégé par mot de passe ni afficher une page « Bientôt disponible ».
- Affichez les informations requises sur votre entreprise dans les mentions légales, les conditions d’utilisation ou les conditions générales de votre site web. Pour les entreprises individuelles, indiquez le prénom et le nom complets du propriétaire de l’entreprise. L’adresse de votre entreprise doit inclure la rue, le numéro, le code postal et la ville.
- Si vous vendez des biens physiques, vous devez proposer la Suisse comme destination de livraison.
- Vous devez afficher les prix en CHF (francs suisses) au plus tard lorsque le client accède à la page de paiement.

> #### Affichez les prix en CHF
> 
> Vous pouvez utiliser [Adaptive Pricing](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md) pour automatiser l’affichage des devises sans devoir définir explicitement les prix de vos produits en CHF.

La fonctionnalité `twint_payments` reste à l’état `pending` jusqu’à ce que le respect des exigences d’onboarding TWINT ait été vérifié. Contactez [le service de support chez Stripe](https://support.stripe.com/contact) si vous avez des doutes sur l’état de cette fonctionnalité.

Votre compte peut faire l’objet d’une vérification après son activation afin de vérifier son éligibilité. En plus de remplir les critères ci-dessus, vous devez fournir un site web qui respecte les exigences suivantes ainsi que les [exigences d’activation du compte Stripe](https://support.stripe.com/questions/business-website-for-account-activation-faq) :

- Doit être accessible publiquement.
- La tarification doit être affichée dans la devise locale du client.
- Le nom légal de l’entreprise doit être clairement affiché.
- La forme juridique de l’entreprise doit être clairement affichée.
- L’adresse de l’entreprise doit être clairement affichée.
- Les conditions d’utilisation du service doivent être affichées.
- L’entreprise ne doit pas recourir à des pratiques commerciales ou marketing trompeuses.
- Fournissez au moins l’un des éléments suivants :
  - Une adresse e-mail de contact doit être clairement affichée.
  - Un numéro de téléphone de contact doit être clairement affiché.

Vous pouvez contacter le [service de support chez Stripe](https://support.stripe.com/) pour contester toute restriction appliquée à la fonctionnalité TWINT.

### Droits de résiliation

En plus des droits de résiliation et de suspension prévus dans le [Contrat d’utilisation du service Stripe](https://stripe.com/legal/ssa), TWINT se réserve le droit de suspendre ou de résilier votre utilisation de TWINT, notamment en cas de non-respect des [conditions d’éligibilité du compte](https://docs.stripe.com/payments/twint.md#account-eligibility) auquel il n’est pas remédié rapidement.

Consultez la liste des *codes de catégorie de commerçant* (A Merchant Category Code (MCC) is a four-digit number that classifies the type of goods or services a business offers) interdits ou restreints pour TWINT.

- **Interdit** : vous ne pouvez pas utiliser ce moyen de paiement avec ces MCC.
- **Restreint** : vous pourrez peut-être utiliser ce moyen de paiement avec ces MCC, mais vous devrez fournir des informations complémentaires lors de la création du compte.

Les exigences relatives aux MCC dépendent du pays de votre entreprise. Les pays soumis aux mêmes exigences sont regroupés dans un même tableau.

**Pays de l’entreprise :** Autriche, Belgique, Bulgarie, Suisse, Chypre, République tchèque, Allemagne, Danemark, Estonie, Espagne, Finlande, France, Royaume-Uni, Gibraltar, Grèce, Croatie, Hongrie, Irlande, Italie, Liechtenstein, Lituanie, Luxembourg, Lettonie, Malte, Pays-Bas, Norvège, Pologne, Portugal, Roumanie, Suède, Slovénie, Slovaquie.

| MCC | Description | Type |
| --- | --- | --- |
| 3000 – 3482 | Description non disponible | Restreint |
| 3483 – 3484 | Agences de location de voitures | Restreint |
| 3485 – 3500 | Description non disponible | Restreint |
| 3501 | Hôtels Holiday Inn | Restreint |
| 3502 – 3999 | Description non disponible | Restreint |
| 4112 | Transport ferroviaire de passagers | Restreint |
| 4131 | Lignes de bus | Restreint |
| 4411 | Bateaux de croisière | Restreint |
| 4511 | Compagnies aériennes, transporteurs aériens | Restreint |
| 4551 | Description non disponible | Restreint |
| 4722 | Agences de voyages, voyagistes | Restreint |
| 4814 | Services de télécommunications | Restreint |
| 4829 | Mandats - Virements bancaires | Interdit |
| 5094 | Pierres et métaux précieux, montres et bijoux | Restreint |
| 5122 | Médicaments, spécialités pharmaceutiques et produits pharmaceutiques divers | Restreint |
| 5816 | Biens numériques - Jeux | Restreint |
| 5960 | Marketing direct - Services d’assurances | Restreint |
| 5961 | Description non disponible | Restreint |
| 5962 | Marketing direct - Voyage | Restreint |
| 5963 | Démarchage à domicile | Restreint |
| 5964 | Marketing direct - Commerçant vendant par catalogue | Restreint |
| 5965 | Marketing direct - Commerçant vendant par catalogue et au détail | Restreint |
| 5966 | Marketing direct - Télémarketing sortant | Restreint |
| 5967 | Contenus et services pour adultes | Restreint |
| 5968 | Marketing direct - Abonnement | Restreint |
| 5969 | Marketing direct - Autre | Restreint |
| 5999 | Magasins de détail divers spécialisés | Restreint |
| 6010 | Décaissement manuel d’espèces | Interdit |
| 6011 | Services financiers | Interdit |
| 6012 | Établissements financiers | Interdit |
| 6050 | Description non disponible | Interdit |
| 6051 | Échanges de cryptomonnaies et wallets | Interdit |
| 6211 | Courtiers et négociants en valeurs mobilières | Restreint |
| 6540 | Achat et rechargement de cartes à valeur sauvegardée (hors institutions financières) | Interdit |
| 7012 | Multipropriétés | Restreint |
| 7273 | Services de rencontre et d’escorte | Restreint |
| 7922 | Billetteries pour spectacles de théâtre | Restreint |
| 7994 | Arcades de jeux vidéo | Restreint |
| 7995 | Paris et jeux de casino | Restreint |
| 9223 | Paiement de cautions | Restreint |
| 9754 | Hébergement - Hôtels, motels et complexes hôteliers (suite) | Restreint |

**Pays de l’entreprise :** Islande, Monaco, Saint-Marin.

Les exigences relatives aux MCC ne sont pas disponibles pour ce pays. Contactez le [service de support chez Stripe](https://support.stripe.com/).

Les comptes Stripe situés dans les pays suivants peuvent accepter des paiements TWINT réglés dans une devise prise en charge.

EMEA: AT, BE, BG, CH, CY, CZ, DE, DK, EE, ES, FI, FR, GB, GI, GR, HR, HU, IE, IS, IT, LI, LT, LU, LV, MC, MT, NL, NO, PL, PT, RO, SE, SI, SK, SM

Les clients situés dans les pays suivants peuvent utiliser TWINT.

EMEA: CH

### Prise en charge des paiements
Customer location: CH
Presentment currency: CHF
Geographic coverage: ✓ Domestic, ✓ Crossborder
Transaction limits: Minimum amount: 0.50 CHF

Maximum amount: 5,000 CHF
## Fonctionnalités
Recurring payments: ✓ Supported

Payment authorizations:
  ✗ Extended authorizations
  ✗ Flexible extended authorizations
  ✗ Incremental authorizations
  ✗ Decremental authorizations
  ✗ Re-authorizations

Payment captures:
  ✗ Manual capture
  ✗ Partial capture
  ✗ Multi-capture
  ✗ Over-capture

Refunds:
  ✓ Partial refunds
  ✓ Full refunds
  Submission window: 180 days
  Processing time: a few minutes

Disputes:
  ✗ Partial disputes
  ✓ Full disputes
### Remboursements

Vous pouvez rembourser des paiements TWINT jusqu’à 180 jours après leur finalisation. Les remboursements sont généralement traités en quelques minutes. TWINT prend en charge les remboursements intégraux, partiels et plusieurs remboursements partiels. Le montant total de tous les remboursements ne peut pas dépasser le montant du paiement initial. Les remboursements TWINT ne peuvent pas être annulés.

#### Processus de remboursement

Les remboursements TWINT ne sont jamais traités comme des annulations. TWINT traite directement le remboursement et renvoie les fonds vers la source de paiement initiale du client, c’est-à-dire son solde TWINT ou le moyen de paiement associé. Le remboursement apparaît alors sur le compte TWINT du client ou sur sa source de financement.

#### Suivi des remboursements

Pour vérifier l’état d’un remboursement, ouvrez le paiement dans le [Dashboard](https://dashboard.stripe.com/payments) et cliquez sur **Afficher les détails** sur la ligne du remboursement. Vous pouvez également [récupérer l’objet Refund](https://docs.stripe.com/api/refunds/retrieve.md) et vérifier son champ `status`.

Stripe vous informe de l’état final par le biais d’un événement de *webhook* (A configurable endpoint that executes when it receives certain event notifications from an event destination) `refund.updated` ou `refund.failed`. [Vérifiez les signatures de webhook](https://docs.stripe.com/webhooks.md#verify-events) pour confirmer que les événements proviennent bien de Stripe. Vous pouvez également utiliser les [adresses IP publiques](https://docs.stripe.com/ips.md) de Stripe pour la liste d’autorisation du réseau. Lorsqu’un remboursement aboutit, l’état de l’[objet Refund](https://docs.stripe.com/api/refunds/object.md) passe à `succeeded`. Si le remboursement échoue, l’état passe à `failed` et Stripe reverse le montant sur votre solde Stripe. Vous devez alors rembourser le client en utilisant un autre moyen de paiement.

### Litiges

#### Procédure de résolution des litiges

Les clients peuvent contester des paiements TWINT en déposant une réclamation auprès de leur banque. Lorsque Stripe reçoit un litige, il crée un dossier de litige que vous pouvez consulter et auquel vous pouvez répondre dans le Dashboard. Le montant contesté est débité de votre solde Stripe.

#### Notifications de litige

Consultez les litiges TWINT dans le [Dashboard](https://dashboard.stripe.com/disputes). Chaque litige indique son motif ainsi que la date limite d’envoi des justificatifs.

#### Répondre aux litiges

Pour contester un litige, envoyez vos justificatifs via le Dashboard avant la date limite indiquée. Stripe les transmet à TWINT pour vérification.

Pour accepter le litige, sélectionnez **Accepter le litige** dans le Dashboard. Si vous acceptez le litige ou n’envoyez aucun justificatif avant la date limite, le litige est considéré comme perdu.

#### Résultats des litiges

Stripe met à jour le litige lorsqu’elle reçoit la décision. Si vous gagnez, Stripe re-crédite le montant contesté sur votre solde. Si vous perdez, le débit de votre solde devient définitif.

### Mandats

Les mandats TWINT autorisent des paiements réutilisables hors session. Les paiements TWINT ponctuels ne nécessitent pas de mandat. Un client crée un mandat en autorisant, dans son application TWINT, un SetupIntent ou un PaymentIntent configuré pour une utilisation ultérieure.

#### Ce que les clients autorisent

Le client autorise votre entreprise à initier ponctuellement des paiements TWINT hors session à l’initiative du commerçant. Le mandat ne définit ni montant fixe ni calendrier de paiement.

#### Collecter les mandats

Pour collecter un mandat, confirmez un SetupIntent ou un PaymentIntent configuré pour une utilisation ultérieure. Le client autorise l’enregistrement de TWINT pour de futurs paiements dans son application TWINT.

#### Gérer les mandats

À un moment donné, un seul mandat TWINT peut être actif entre votre entreprise et un client donné. Utilisez le mandat actif pour les paiements futurs.

Pour les plateformes Connect qui utilisent des paiements indirects sans définir `on_behalf_of`, des conflits de mandat peuvent survenir lorsqu’un client crée des mandats TWINT avec plusieurs comptes connectés. Étant donné que ces paiements considèrent la plateforme comme le Merchant of record, la création d’un second mandat révoque automatiquement le mandat existant, même si le compte connecté est différent. Pour obtenir de l’aide sur la configuration des paiements Connect, consultez [la documentation Connect relative au Merchant of record](https://docs.stripe.com/connect/merchant-of-record.md).

Les mandats TWINT actifs s’affichent dans le Dashboard avec les moyens de paiement enregistrés du client. Pour récupérer l’identifiant du mandat associé à un paiement, consultez `charge.payment_method_details.twint.mandate`. Vous pouvez récupérer les détails du mandat à l’aide de [l’API Mandate](https://docs.stripe.com/api/mandates.md).

#### Annuler les mandats

Pour révoquer un mandat TWINT en tant que commerçant, dissociez le PaymentMethod du client à l’aide de [l’API Detach](https://docs.stripe.com/api/payment_methods/detach.md). Les clients peuvent révoquer un mandat à tout moment dans leur application TWINT, et TWINT peut aussi le révoquer. Lorsque Stripe reçoit la révocation, elle met à jour l’état du Mandate.

## Prise en charge des produits Stripe
Checkout UIs:
  ✓ Full page (Recommended)
  ✓ Payment Links
  ✓ Embedded form
  ✓ Payment Element
  ✗ Express Checkout Element
  ✗ Payment Method Messaging Element
  ✓ In-app payments

Products:
  ✗ Managed Payments
  ✓ Billing
  ✓ Invoicing
  ✓ Customer Portal
  ✓ Radar
  ✗ Terminal
  ✓ Connect

APIs:
  ✓ Checkout Sessions (Recommended)
  ✓ Payment Intents
  ✓ Payment Intents with setup_future_usage
  ✓ Setup Intents
  ✓ Off-session payments
## Expérience client

#### 1. Select TWINT

The customer selects TWINT at checkout.

#### 2. Authorize the payment

On mobile, the customer is redirected to a TWINT-hosted page, selects their TWINT app, and then switches to that app. TWINT offers different apps depending on the customer's Swiss bank. On desktop, the customer is redirected to a TWINT-hosted page that displays a QR code. The customer scans the code using their TWINT app. The customer approves the payment in the app. While authorization is pending, the PaymentIntent remains in `requires_action`.

#### 3. Complete the payment

The customer sees confirmation in the TWINT app. After authorization, the customer is redirected back to your website or app. Stripe immediately reports the result: successful PaymentIntents transition to `succeeded`, while declined or failed payments transition to `requires_payment_method`.

### Libellés de relevé bancaire

Stripe transmet le `statement_descriptor` du paiement à TWINT en tant que libellé dynamique. Cela ne garantit pas que TWINT affiche le libellé personnalisé au client.

Par défaut, le nom de l’entreprise associé à votre compte Stripe est affiché au client. Pour les paiements Connect, les paiements directs et les paiements utilisant `on_behalf_of` utilisent le nom du compte connecté. Les paiements indirects ainsi que les paiements et transferts distincts qui n’utilisent pas `on_behalf_of` utilisent le nom de la plateforme. En savoir plus sur les [libellés de relevé bancaire avec Connect](https://docs.stripe.com/connect/statement-descriptors.md).

## Activer TWINT

Si vous utilisez les produits front-end Stripe, activez TWINT dans vos [paramètres des moyens de paiement](https://dashboard.stripe.com/settings/payment_methods). Stripe détermine automatiquement les moyens de paiement les plus pertinents pour chaque client.

Si votre intégration répertorie manuellement les moyens de paiement, découvrez comment [configurer TWINT comme moyen de paiement](https://docs.stripe.com/payments/twint/accept-a-payment.md).

Pour les comptes connectés qui utilisent le Dashboard Express ou aucun Dashboard hébergé par Stripe, suivez les instructions pour [demander des fonctionnalités pour vos comptes connectés](https://docs.stripe.com/connect/account-capabilities.md). Demandez la fonctionnalité `twint_payments` et vérifiez que son état est `active` avant d’accepter des paiements TWINT.