New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebee docs
HomeBillingPaymentsRevRecGrowthReveal
Support

Product Updates

  • Release Notes

Payment Methods

  • Payment Methods Overview
  • Cards
  • Direct Debit
  • Bank Based Payments
  • Wallets
  • Vouchers
  • Articles and FAQ

Payment Gateways and Configuration

  • Payment Gateways Overview
  • Chargebee Test Gateway
  • Stripe
  • PayPal Payment Services
  • Chargebee Pay
  • Adyen
    • ACH Payments via Adyen
    • Apple Pay via Adyen
    • BACS via Adyen
    • Bancontact via Adyen
    • Google Pay via Adyen
    • GoPay via Adyen
    • GrabPay via Adyen
    • iDEAL via Adyen
    • KakaoPay via Adyen
    • Klarna Pay Now via Adyen
    • NaverPay via Adyen
    • Online Banking Poland via Adyen
    • PayCo via Adyen
    • Payconiq by Bancontact via Adyen
    • PayMe via Adyen
    • PayPal via Adyen
    • SEPA Payments via Adyen
    • Sofort via Adyen
    • Swish via Adyen
    • Trustly via Adyen
    • TWINT via Adyen
    • WeChat Pay via Adyen
  • Authorize.net
  • Bambora (formerly Beanstream)
  • Bank of America
  • BluePay
  • BlueSnap
  • Braintree
  • Checkout.com
  • CyberSource
  • dLocal
  • EBANX
  • Ecentric
  • Elavon
  • E-xact Direct Integration
  • eWay Rapid
  • Global Payments
  • GoCardless
  • J.P. Morgan Mobility Payment Solutions
  • Metrics Global
  • Mollie
  • Moneris
  • Network Merchants Incorporated (NMI)
  • Nuvei
  • Orbital (Chase Paymentech)
  • Pay.com
  • Paymill
  • Paystack
  • Pin Payments
  • QuickBooks Payments
  • Razorpay
  • Sage Pay
  • Solidgate
  • Tempus
  • Twikey
  • Windcave
  • Worldline Online Payments(formerly Ingenico)
  • Worldpay
  • Articles and FAQ

Level 2/3 Data Support

  • Level 2/3 Data Support

Advanced Routing

  • Advanced Routing

Dunning

  • Dunning
  • Articles and FAQ

Offline Checkout

  • Offline Checkout
  • Articles and FAQ

Transaction Sync & Invoice Mapping

  • Transaction Sync and Invoice Mapping

Fraud Management

  • Fraud Management

Error Handling

  • Errors with Root Cause and Troubleshooting

Payment Lifecycle Logs

  • Payment Intents
  • Transactions
  • Gateway Activity Logs
  • Gateway Webhook Logs
  • Articles and FAQ

Others

  • Reach (Merchant of Record)
  • Payment Verification
  • Bulk Deletion of Payment Methods
  • Custom Payment Methods
  • Payment Initiator Parameter
  • PSD2 and Strong Customer Authentication
  • RBI e-Mandate
  • RBI Tokenization Regulations
  • Chargeback Management
  • Transaction Descriptors
  • Payment Preferences
  • Visa Trial Rules
  • Mastercard Trial Rules
  • Co-badged Card Compliance
  • Articles and FAQ
  1. Payments
  3. Payment Gateways and Configuration
  5. Adyen
  6. TWINT via Adyen
  1. Payments
  3. Payment Gateways and Configuration
  5. Adyen
  6. TWINT via Adyen

Twint via Adyen

This feature is currently a Private Beta release. Contact Chargebee Support to enable Twint via Adyen for your live and test sites.

Twint is Switzerland's most popular mobile payment method, used by over 6 million active users. Chargebee supports Twint as a payment method via the Adyen payment gateway.

When customers select Twint at checkout, they are presented with a QR code on desktop or redirected to the Twint app on mobile. Once the payment is authorised within the Twint app, the transaction is processed via Adyen and the customer is redirected back to your website.

For a walkthrough, see the Twint setup demo video.

Supported countries and currencies

Twint via Adyen supports the following countries and currencies:

CountryCurrency
SwitzerlandCHF

Prerequisites

To accept Twint payments using Chargebee, you must:

  • Have an active Adyen account with Twint enabled as a payment method in your Adyen Customer Area. Learn more
  • Ensure CHF (Swiss Franc) currency is enabled for your Chargebee account.
  • Ensure the Adyen payment gateway and webhooks are configured in your Chargebee account. Learn more

Integration options

You can integrate Twint via Adyen using the following methods:

Integration methodDescription
Chargebee Hosted PagesUse Chargebee’s hosted checkout pages to accept Twint payments with minimal integration effort.
Chargebee JSEmbed Twint as a payment method within your custom checkout using Chargebee JS.
API (Payment Intent)Integrate Twint using Chargebee APIs for a fully custom checkout and payment flow.

Supported tokens

This integration supports the following set of tokens:

TokenDescriptionFormat and Sample
Chargebee Payment Intent IDThis is the Payment Intent ID returned after a successful authorization process using Chargebee JS.Format: payment_intent[id]
Gateway Permanent TokenUsed for recurring payments. The token is stored after the first successful Twint transaction and can be reused for subsequent charges.Format: shopper_reference_id/recurring_detail_reference_id

Configure Twint in Chargebee

Follow these steps to configure Twint via Adyen in your Chargebee site:

  1. Log in to the Chargebee app.
  2. Go to Settings > Configure Chargebee > Payment Gateways.
  3. Select the relevant Adyen instance from the list.
  4. Locate the Twint toggle under the list of supported payment methods and enable it.
    image
  5. Click Apply to save changes.
    image

Configure smart routing for Twint

When you configure Twint through Adyen, smart routing for the CHF currency is automatically enabled. Check the Smart Routing settings, and if any other gateway is already designated for the CHF currency, adjust the Smart Routing settings manually to allocate Twint to it.

Follow these steps to modify Smart Routing settings:

  1. Log in to the Chargebee app.
  2. Go to Settings > Configure Chargebee > Payment Gateways.
  3. Click Manage Rules under Smart Routing.
  4. Go to the Twint section and click Add a Gateway for CHF. If you already have a payment gateway assigned to it, click Edit.
image
  1. From the Choose a payment gateway drop-down menu, select the relevant Adyen instance with Twint enabled.
  2. Click Save.
image

Checkout flow

Your customer performs the following steps during checkout using Twint via Adyen:

  1. Initiate checkout and proceed to the payment step.
  2. Select Twint as the payment method.
  3. On desktop, scan the displayed QR code using the Twint app. On mobile, you are automatically redirected to the Twint app to authorise the payment.
  4. Confirm the payment within the Twint app.
  5. Once payment is authorised, you are redirected back to the merchant's website.

Testing

Sandbox testing

Refer to the Adyen documentation for instructions on testing TWINT in a sandbox environment.

Production testing

Before going live, ensure the following:

  • Twint is enabled in your Adyen account.
  • Webhook configuration is complete (mandatory for payment status updates).
  • You perform end-to-end testing using a real Twint-enabled bank account and a mobile device with the Twint app installed.

Reconciliation

For financial reconciliation between Chargebee and Adyen:

  • Use the Chargebee transaction field id_at_gateway, which maps to the pspReference in Adyen.

Follow these steps to reconcile transactions:

  1. Retrieve the id_at_gateway value from the Chargebee transaction details.
  2. Locate the corresponding pspReference in Adyen reports.
  3. Match transactions using this reference.

Limitations and important points

  • Twint cannot be added as a payment method via the customer portal or directly in the Chargebee app. Customers must complete the payment through the checkout flow, Pay Now flow, or a custom checkout using Chargebee.js.
  • Twint is exclusively available for CHF (Swiss Franc) transactions.
  • Twint payments are immediately captured upon authorization. No separate capture step is required.

Was this article helpful?