# 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="/files/bmCTsmMMLMzMhI1Kwz7h" alt="" data-size="line"> Visa
* <img src="/files/6H1RoBASs6DZVLSS6fCj" alt="" data-size="line"> Mastercard
* <img src="/files/9fO69GtnJBUoaOayXfbq" alt="" data-size="line"> Masterpass
* <img src="/files/L9gEfdNlDEuvZDoAy9Qt" alt="" data-size="line"> Postfinance Card
* <img src="/files/Gsnu7QYipiFe8FzEE7oj" alt="" data-size="line"> Postfinance E-Finance
* <img src="/files/c75EI42u8ClKF0tI1gB0" alt="" data-size="line"> American Express
* <img src="/files/vFmy9HUtz2KWi3cN9ekc" alt="" data-size="line"> Diners Club
* <img src="/files/kmGRFKII0qBxIJMM6oW2" alt="" data-size="line"> JCB
* <img src="/files/1f3leQjMjUzRtGxlnRp7" 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="/pages/lYOlUHuszMQ4Z1VVjlNL" %}
[Country Availability](/merchant/english/payment-provider/country-availability.md)
{% 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](/files/abmsX3sCthbykL66hGlC)

### 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="/files/3h4HDpMBD24z3fcG43vw" 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.


---

# 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/creditcards/datatrans.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.