# TWINT

## General Information

With the TWINT payment app, customers in Switzerland can pay conveniently and securely using their smartphone – whether online or at the point of sale. With more than 5 million users, TWINT is Switzerland’s leading payment app.

### Links <a href="#links" id="links"></a>

* TWINT [Website](https://www.twint.ch/en)
* Information about TWINT for [business customers](https://www.twint.ch/en/business-customers/our-solutions/?lang=en)
* Information about TWINT on the [Payrexx website](https://payrexx.com/en/twint)

### TWINT within Payrexx Pay

Swiss merchants with a [verified](https://docs.payrexx.com/merchant/english/the-first-steps/account-verification) Payrexx account can activate TWINT within the [Payrexx Pay](https://docs.payrexx.com/merchant/english/payment-provider/payrexx-pay) payment provider and benefit from the following advantages:

* Attractive conditions with fees of only 1.25%
* Convenient processing and an "all-in-one" solution thanks to integration into Payrexx Pay
* Payouts made directly by Payrexx

### TWINT as an external payment provider

Swiss merchants without a verified Payrexx account can integrate TWINT as an external payment provider in Payrexx. Further information can be found in the [Setup](#setup) section.

## Features <a href="#features" id="features"></a>

### Payment types

* ✅ One-time payment
* ✅ Refund
* ✅ Partial refund
* ❌ Recurring payments (subscriptions)
* ❌ Tokenization
* ❌ Pre-authorization

## Country Availability

TWINT is exclusively available for merchants located in :flag\_ch: Switzerland.

{% content-ref url="../../country-availability" %}
[country-availability](https://docs.payrexx.com/merchant/english/payment-provider/country-availability)
{% endcontent-ref %}

## Setup

Please follow the instructions below to integrate TWINT as an external payment provider in Payrexx.

### Configuration of TWINT

* Register with [TWINT](https://portal.twint.ch/partner/gui/?login\&login).
* After registration, log in to your TWINT account.
* Navigate to **Stores** in the main menu and click the "Add" button under "Online shop":

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FjBaEsQpG52qBZGpHjXhP%2Fimage.png?alt=media&#x26;token=5f76d5d1-1514-4606-91ae-a7e6f40e0bdb" alt=""><figcaption><p>Adding a new shop in TWINT</p></figcaption></figure></div>

* For method of integration, select "PSP" and for payment service provider, select "Payrexx":

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FaxTfa0tDFDsGT3hyiI1a%2Fimage.png?alt=media&#x26;token=4de86361-8471-4e56-a75e-f2b3bfaed19b" alt=""><figcaption><p>Selecting the Payrexx payment service provider</p></figcaption></figure></div>

* Configure the appropriate settings in the following form:

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FqXO6zM1WyNcVd00gKI0H%2Fimage.png?alt=media&#x26;token=c7242219-cdb6-472a-b937-701a454a78e2" alt=""><figcaption></figcaption></figure></div>

1. **Category:** Select the appropriate entry for the industry in which you operate.
2. **Sub-category:** Select the corresponding entry for the sub-category of your industry.
3. **Name of store:** Enter the name of your shop (e.g., Demo Shop).
4. **Address:** Enter the company address associated with the shop.
5. **Website:** Enter the shop’s URL.
6. **Confirmation:** Confirm that your website meets the listed requirements.
7. **Logo:** Optionally, upload your logo.
8. **Payout acccount:** Provide the bank account where TWINT payouts should be transferred.

Click "Next" to proceed to the next step, verify that all information is correct, and if so, confirm by clicking "Save":

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FGMtvrTx60jkrSkMYZcl4%2Fimage.png?alt=media&#x26;token=00ada707-c6b5-4ffa-b610-cd42aefe560c" alt=""><figcaption><p>Review and save the information</p></figcaption></figure></div>

* Navigate to **Stores** in the main menu.
* Click the edit icon for the shop you want to connect:

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FeYit0qhIayfmZWg2zCso%2Fimage.png?alt=media&#x26;token=98306033-911d-435a-a634-1b1039a15bb5" alt=""><figcaption><p>Enter the shop’s edit mode</p></figcaption></figure></div>

* Copy the displayed UUID to the clipboard, as you will need it in the [next step](#configuration-of-payrexx).

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FkKc6tzVSeZaNLNQqeB9Z%2Fimage.png?alt=media&#x26;token=1bf0b177-82f6-48df-977d-fede1c27a4f4" alt=""><figcaption><p>Copy the UUID to the clipboard for later use in Payrexx</p></figcaption></figure></div>

### Configuration of Payrexx

{% hint style="info" %}
Make sure you're [logged in](https://login.payrexx.com/) to your Payrexx account before you begin. If you don’t have a Payrexx account yet, you can [register](https://signup.payrexx.com/) now.
{% endhint %}

* In the merchant administration of your Payrexx account, navigate to **Payment Providers**.
* Under "Alternative payment methods", click "Show".
* Click "Setup" next to TWINT:

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FgGEUY9AnyOILpHdCUwnx%2Fimage.png?alt=media&#x26;token=339aed16-b28e-42ba-aba8-81456f0e9ab6" alt="" width="563"><figcaption><p>Starting the setup of TWINT as an external payment provider in Payrexx</p></figcaption></figure></div>

* If you do not yet have a TWINT account, you can create one by clicking "Yes". Otherwise, select "No, not now":

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2F5b84xV9qERasqSrl2RQc%2Fimage.png?alt=media&#x26;token=795b9c23-6211-4e2f-b8d9-f61b6c548f20" alt="" width="563"><figcaption><p>Option to create a TWINT account</p></figcaption></figure></div>

* Configure the TWINT integration according to the illustration below:

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FFo0R6DFQuMEmDiDSmXCR%2Fimage.png?alt=media&#x26;token=bc611b24-7e8a-4457-b7ef-396bf126ae9e" alt=""><figcaption><p>Entering the Store UUIDs to connect Payrexx and TWINT</p></figcaption></figure></div>

1. **Mode:** Choose whether you want to receive live payments directly via TWINT or test the payment provider first.
2. **Productive account settings:** Paste the Store UUID for the live account, which you copied during the [configuration of TWINT](#configuration-of-twint), into the "Store UUID" field.
3. **Test account settings:** Paste the Store UUID for the test account, which you copied during the [configuration of TWINT](#configuration-of-twint), into the "Store UUID" field.

{% hint style="success" %}
Once the live mode is activated, you can start accepting TWINT payments from your customers immediately.
{% endhint %}

## Testing

In order to conduct tests with TWINT payments, you will need the TWINT Test App. Kindly reach out to our [support team](https://docs.payrexx.com/merchant/english/faq/payrexx-support-portal) for assistance.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payrexx.com/merchant/english/payment-provider/external-payment-provider/wallets-and-more/twint.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
