# Datatrans

## General Information

The Swiss online payment provider Datatrans offers payment solutions for e-commerce, mobile commerce, and POS systems.

Datatrans is part of Planet, a global provider of payment technologies and services.

### Links

* Request a[ production account](https://www.datatrans.ch/en/about/contact/)
* Request a [test account](https://testaccount.datatrans.com/testaccounts?lang=en)
* Datatrans [Web Administration](https://admin.datatrans.com/)
* Datatrans [Web Administration Pilot](https://admin.sandbox.datatrans.com/)

## Features

### Payment types

The following features are available in the Payrexx merchant administration panel:

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

### Payment methods

* <img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FPwoJvB8aKGLzspq1XBhw%2Fimage.png?alt=media&#x26;token=72868cf8-fdb9-4e9c-b5d2-625aa12cbee1" alt="" data-size="line"> Visa
* <img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FLeahQhkYpcCO2VGAqkzH%2Fimage.png?alt=media&#x26;token=3c495428-10e0-4fab-88e7-9d19eb452e45" alt="" data-size="line"> Mastercard
* <img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FznTkJSVYyYBOvcwCZumF%2Fimage.png?alt=media&#x26;token=4fffbc0e-1e76-4f97-8427-b63e8c8fad3b" alt="" data-size="line"> Masterpass
* <img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2Fpzwyb9XzS6df6OPV94Zc%2Fimage.png?alt=media&#x26;token=5029ac0a-de5b-4193-8310-f18e4b08fb2b" alt="" data-size="line"> Postfinance Card
* <img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2Fx1PVP0hGs2mfW4DtSxNu%2Fimage.png?alt=media&#x26;token=31522fa9-a6fb-423d-91d3-6c01b74accb9" alt="" data-size="line"> Postfinance E-Finance
* <img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2F0UUrmlVxUEwBlRpEHylX%2Fimage.png?alt=media&#x26;token=3626f208-75bc-4ea0-8dc0-14af96dc1c72" alt="" data-size="line"> American Express
* <img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FdMUjSkQ5PBMM2BqQJwrT%2Fimage.png?alt=media&#x26;token=30fa7d94-a8e5-400a-8b1e-d338f219ee5b" alt="" data-size="line"> Diners Club
* <img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FaW6tx8ifzy176bpJF9mu%2Fimage.png?alt=media&#x26;token=a2c148c4-8413-4819-a71a-b31c13447ccb" alt="" data-size="line"> JCB
* <img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2F6lcua4CyDJYq19OrNypJ%2Fimage.png?alt=media&#x26;token=e09e5fee-d5bc-4d02-b32e-c4e83d5b8d51" alt="" data-size="line"> Klarna

## Country Availability

To find out if Datatrans is available in your country, please click on the following link:

{% 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 Datatrans as an external payment provider in Payrexx.

### **Configuration of Datatrans**

#### Apply for Datatrans contract

1. Request a quote from Datatrans at <https://www.datatrans.ch/en/about/contact/>.
2. Select "General" for the inquiry and ask for a "Webshop account" in the comment section.

**Request a test account**

Complete the [Request Test Account](https://testaccount.datatrans.com/testaccounts?lang=en) form.

Multiple test accounts will be set up. You only need the functionality of the "web" merchant. Configure the test account you receive by following these steps.

#### Settings

After the conclusion of the contract, Datatrans will provide you with a merchant ID and the access data for the requested account type.

* Production Datatrans [Web Administration](https://admin.datatrans.com/)
* Test Datatrans [Web Administration Pilot](https://admin.sandbox.datatrans.com/)

1. Log in with your Datatrans account. Note: If you don't see a UPP Administration tab, you need to select first a merchant by clicking on "Change merchant" (top right corner).
2. Navigate to **UPP Administration > Security**.
3. Activate the setting "Protect server-to-server services with password" on the "Server-to-Server service security" input mask. If no password has been created, generate a new password and confirm the changes. Copy the password. You must then enter this in the Payrexx administration under **Payment provider > Datatrans** in the "Merchant password" field.
4. Please follow the link "Security signature" next to the title "Server-to-Server service security".
5. Select the third option "Important parameters will be digitally signed (HMAC-SHA256) and sent with payment messages". If no HMAC key has been created yet, please generate a new key and confirm the changes. The HMAC key then must be added to the Datatrans settings.
6. Navigate to **UPP Management > UPP Data** and enter the settings according to the screenshot below. Confirm the changes.\
   \
   URL Post: <https://dispatcher.payrexx.com/datatrans/webhook.php>

![Settings in Datatrans](https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FcBvBiPSiixkMpGq8GeR0%2Fpsp_datatrans_api_redirect_migration_img1.png?alt=media\&token=afe31c9f-0378-4de9-a646-d4932bdb89e2)

### 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 %}

1. Navigate to Payment Providers > Credit and Debit Cards in your merchant backend of Payrexx.
2. Click on "Set up" next to Datatrans:

<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%2FsmIhc7KcaTAEE1TTadbz%2Fimage.png?alt=media&#x26;token=8c3c7cbe-256e-4db4-b668-759e55963dbb" alt=""><figcaption><p>Setting up Datatrans in Payrexx</p></figcaption></figure></div>

3. Insert the Merchant ID, the Merchant Password and the HMAC Key into the "Connection Settings" and save the changes.
