Skip to content
Create account
 or
Sign in
The Stripe Docs logo
/
Create account
Sign in
OverviewUpgrade your integration
Online payments
OverviewFind your use caseManaged Payments
Payment methods
Payment interfaces
Payment scenarios
In-person payments
Other Stripe products

TWINT payments

Learn how to accept TWINT, a popular payment method in Switzerland.

Copy page

Caution

Stripe automatically presents your customers payment method options by evaluating their currency, payment method restrictions, and other parameters. We recommend that you configure your payment methods from the Stripe Dashboard using the instructions in Accept a payment.

If you want to continue manually configuring the payment methods you present to your customers with Checkout, use this guide. Otherwise, update your integration to configure payment methods in the Dashboard.

TWINT is a single-use payment method used in Switzerland. It allows customers to authenticate and approve payments using an approved TWINT mobile app.

You get immediate notification on whether the payment succeeded or failed.

Determine compatibility

A Checkout Session must satisfy all of the following conditions to support TWINT:

  • You must express Prices for all line items in Swiss Franc (currency code chf).

Accept a TWINT payment

Note

Build an integration to accept a payment with Checkout before using this guide.

Enable TWINT by making the following updates to your card payment integration.

When creating a Checkout Session, you must:

  • Add twint to the list of payment_method_types.
  • Make sure all line_items use the chf currency.
Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'twint'],
  line_items: [{
    price_data: {
      currency: 'usd',
      # To accept `twint`, all line items must have currency: chf
      currency: 'chf',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

Fulfill your orders

After accepting a payment, learn how to fulfill orders.

Test your integration

When testing your Checkout integration, select ‘TWINT’ as the payment method and click Pay.

Handle refunds

Learn more about TWINT refunds.

See also

Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc