# Barzahlen/viacash

## General Information

Barzahlen/viacash is an independent payment infrastructure in Europe that allows cash deposits and withdrawals via barcode at retail checkout counters.

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

* [Login](https://controlcenter.viacash.com/#/account/signin) at Barzahlen/viacash
* Barzahlen/viacash [Website](https://www.viacash.com/?lang=de)
* Barzahlen/viacash [Website for business customers](https://www.viafintech.com/)

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

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

## Country Availability

To find out if Barzahlen/viacash 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 Barzahlen/viacash as an external payment provider in Payrexx.

### Configuration of Barzahlen/viacash

Create an account in the Barzahlen/viacash [Control Center](https://controlcenter.barzahlen.de/#/account/signin) to begin the integration.

#### Add Division

Navigate to **Settings > Divisions** in your Barzahlen/viacash account and click on "Add Division":

<div align="left"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/11055635973/original/eCBbugvCUZW77Of0T70vUosAHuDPCXIGEA.png?1581930976" alt="Adding a division in Barzahlen/viacash"></div>

#### Enter required information

* Enter your company name under "Division Title".
* Add the link to your website under "Division URL".
* Copy the URL <https://dispatcher.payrexx.com/> and paste it under "Notification URL" and "Sandbox Notification URL".
* Then click on "Save".

<div align="left"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/11055636051/original/tL8aQnFURlU7nCaxFOdl4VAbsNIv6-iAOA.png?1581931081" alt="Entering various details in Barzahlen/viacash"></div>

Copy the Division ID and API key from your Barzahlen/viacash account to your clipboard. You will need these values for the next step.

<div align="left"><img src="https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/11055636103/original/j_nqHqEQl6JW7hk42w845QljwXhxd3BJpw.png?1581931183" alt="Copying Division ID and API Key to clipboard"></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 %}

Log in to your Payrexx account and navigate to **Payment providers > Alternative payment methods**. Click "Setup" next to "Barzahlen/viacash".

Then, paste the previously copied Division ID and API key into the corresponding fields:

<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%2F22ZAFNW2hobdpwl18AQW%2Fimage.png?alt=media&#x26;token=34b601bf-945b-466e-91f2-5a3319c8ffbc" alt=""><figcaption><p>Entering Division ID and API Key in Payrexx</p></figcaption></figure></div>

#### Adding the bank account

Next, edit the division in your Barzahlen/viacash account and add your desired bank account under **Settings > Bank accounts > Add new bank account**:

<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%2FqRwduRBVhDd9Kfy6t1vb%2Fimage.png?alt=media&#x26;token=67ae4b60-53d1-42b1-acc8-8e17168f3db7" alt=""><figcaption><p>Adding the bank account</p></figcaption></figure></div>

Finally, you need to verify your identity at any post office branch using the "Gelbe Identifikation". You can use the coupon from the support page to complete this identification process free of charge. Once the identification is successfully completed, Barzahlen/viacash can be activated immediately.

The form for the "Gelbe Identifikation" can be found at the end of this guide.

{% hint style="info" %}
Payrexx and Barzahlen/viacash are now successfully connected.
{% endhint %}

## Testing

Activate the [test mode](https://docs.payrexx.com/merchant/english/payment/testing) in your Payrexx account to test the process. In your Barzahlen/viacash account, you can simulate actions such as transactions and payments by clicking on the various actions under **Transactions > Sandbox Transactions** (on the right under "Actions").

<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%2FWsscRk0NInz2PEcYlca4%2Fimage.png?alt=media&#x26;token=215124d9-4dcb-4b70-af61-522193f19c9b" alt=""><figcaption><p>Testing the integration in test mode</p></figcaption></figure></div>

Once you have finished testing the process, change the mode from "Test" to "Live" in your Payrexx account and finalize a cooperation agreement with Barzahlen/viacash.
