> For the complete documentation index, see [llms.txt](https://docs.saaster.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.saaster.io/fundementals/payment-service-provider.md).

# Payment Service Provider

Saaster makes use of the payment service provider [Payrexx](https://www.payrexx.com/?ref=paweco). At the moment, integration of other payment provides is not planned.

Payrexx is a [Swiss Payment Service Provider](https://www.payrexx.com/?ref=paweco) and is subject to Swiss quality control. And anyone who knows Switzerland knows how important that is.

But this is not the only reason why we decided to work with [Payrexx](https://www.payrexx.com/?ref=paweco). Another reason is that [Payrexx ](https://www.payrexx.com/?ref=paweco)has already integrated tons of other payment service providers in the system, so that every SaaS provider can probably find their desired PSP in it.

<figure><img src="/files/6KmL76KfBxQYJC2LWUJA" alt=""><figcaption></figcaption></figure>

The following chapters will guide you through the configuration and integration of Payrexx in saaster.

## Create an account

First you need an account with Payrexx. [Click here to register](https://www.payrexx.com/?ref=paweco).\
Enter your company name or a part of it here:

<figure><img src="/files/HZZBBclyHxUnQR68MGBK" alt=""><figcaption></figcaption></figure>

After you have created your login, you will find yourself in the [Payrexx ](https://www.payrexx.com/?ref=paweco)account.

## Create an API key

Now you need to create an API key. To do this, navigate to **API & Plugins** on the left-hand side.

<figure><img src="/files/WIiRQDA4WmRn3M7IVUM1" alt=""><figcaption></figcaption></figure>

Click the button "Add API Key" and assign a meaningful name to the new key. It is best to choose the name of your project:

<figure><img src="/files/NBmhYrVG1os5E0ViBpMP" alt=""><figcaption></figcaption></figure>

Keep the API key you received safe. You will need this key in the further steps.

## Create a webhook

Now you create a webhook. This is used to store payment methods and to charge them repeatedly later. To do this, navigate to **Webhooks** on the left-hand side.

<figure><img src="/files/hj9cHlXzwPlGOo4wt6qZ" alt=""><figcaption></figcaption></figure>

You need two webhooks, one for the *development environment* and one for the *production environment*.

### Development environment

You will find a file called "payrexx\_webhook\_dev.cfm" in the saaster file structure in the "frontend" folder. You must now upload this file to any server that can be reached from the internet.&#x20;

*Example:*

`https://your-domain.com/frontend/core/handler/payrexx_webhook_dev.cfm`

This is also the path that you must enter as the webhook.\
Click "Add webhook". Give the webhook a unique name and write the path to the file you just uploaded in the field:

<figure><img src="/files/usU7mxkPuTjyyTJNrwpI" alt=""><figcaption></figcaption></figure>

Configure your webhook exactly as shown above.

### **Production environment**

For the productive environment you can add a webhook and specify the file "payrexx\_webhook.cfm" also in the folder "frontend". Everything else remains the same.

**Note: You must add a password defined in a url variable:**\
`https://your-domain.com/frontend/core/handler/payrexx_webhook.cfm?pass=xxx`

The password is defined in config.cfm

## Create a payment page design

To ensure that your payment page matches your design, you can create a corresponding design in [Payrexx](https://www.payrexx.com/?ref=paweco).

Click on "Settings" on the left, then on "Look & Feel":

<figure><img src="/files/KUfDZ8jE8ojo6yXLFjYD" alt=""><figcaption></figcaption></figure>

Click the green button "Add a new profile" at the top right and fill this form according to your wishes:

<figure><img src="/files/sfShKxx7skncewU86PfH" alt=""><figcaption></figcaption></figure>

Save the new profile at the bottom. You will now get a unique ID for your design.&#x20;

<figure><img src="/files/PmPyM9bRPckX0JWXQ6vq" alt=""><figcaption></figcaption></figure>

Please copy this ID into the config.cfm of your project. Read more about the configuration / config.cfm here:

{% content-ref url="/pages/QPT0YAYq0IqbnbbyLBkK" %}
[Installation](/getting-started/installation.md)
{% endcontent-ref %}

## Payment providers

In this menu you can configure your payment methods and choose the payment provider.

Please follow the instructions from [Payrexx](https://www.payrexx.com/?ref=paweco), as this configuration can be very extensive. You will also have to provide [Payrexx ](https://www.payrexx.com/?ref=paweco)with some confirmations in order to activate certain payment methods.

Docuementation related to [Payrexx ](https://www.payrexx.com/?ref=paweco)payment providers:

{% embed url="<https://docs.payrexx.com/merchant/payment-priovder/payrexx-direct>" %}

For more information about [Payrexx ](https://www.payrexx.com/?ref=paweco)we recommendreading the official documentation:

{% embed url="<https://docs.payrexx.com/merchant/>" %}
