---
title: How to Connect Payrexx to OneSuite
description: "Connect Payrexx so your clients can pay invoices online through it. Go to **Settings** > **Integrations** > **Payment** and click **Connect** on the Payrexx card. Enter your **Instance name** and **API secret**. Add the OneSuite webhook in Payrexx, and paste its signing key into **Webhook signing key**. Then click **Save**. **In this guide…"
url: "https://help.onesuite.io/docs/how-to-connect-payrexx-to-onesuite/"
updated: "2026-11-18"
category: Payment Integration
---

# How to Connect Payrexx to OneSuite

Connect Payrexx so your clients can pay invoices online through it. Go to **Settings** > **Integrations** > **Payment** and click **Connect** on the Payrexx card. Enter your **Instance name** and **API secret**. Add the OneSuite webhook in Payrexx, and paste its signing key into **Webhook signing key**. Then click **Save**.

**In this guide you'll learn how to:**

- Find your Payrexx instance name and API secret
- Add the OneSuite webhook in Payrexx
- Connect Payrexx to OneSuite
- Switch Payrexx on for an invoice

## Before you start

- You need access to **Settings**. If you can't see **Integrations**, ask an admin.
- You need a Payrexx account and access to Payrexx administration.
- Your API secret is a private code from Payrexx. It lets OneSuite work with your Payrexx account.
- A webhook is how Payrexx tells OneSuite that a client has paid. It is a web address that you add in Payrexx.
- A signing key (also called a signature secret) is a secret code. It shows that a message really came from Payrexx.

## What does OneSuite ask for when you connect Payrexx?

| Field | Where to find it | Required |
| --- | --- | --- |
| **Instance name** | The first part of your Payrexx address. For yourshop.payrexx.com it is "yourshop". | Yes |
| **API secret** | In Payrexx administration, open **API & Plugins**. Copy the secret of your API key. | Yes |
| **Webhook signing key** | In Payrexx administration, open **Webhooks**. Copy the signing key that Payrexx generated for the webhook you added for OneSuite. | Yes |
| **Currency** | Starts as **Swiss Franc (CHF)**. OneSuite uses it when an invoice has no currency of its own. | No |

The dialog also shows a **Webhook URL for your Payrexx dashboard** box with a copy button.

## How do I connect Payrexx to OneSuite?

1. Click your name at the bottom of the sidebar, then click **Settings**.
2. Under **Integrations**, click **Payment**.
3. On the **Payment Methods** page, find **Payrexx** and click **Connect**. Keep the dialog open.
4. Type your instance name into **Instance name**.
5. In Payrexx administration, open **API & Plugins**. Copy your API secret into **API secret**.
6. Add the webhook in Payrexx. The next section shows you how.
7. Copy the webhook's signing key into **Webhook signing key**.
8. Check the **Currency**.
9. Click **Save**.

![](https://help.onesuite.io/wp-content/uploads/2026/11/open-payment-settings-in-onesuite-1-925x1024.png)

## How do I add the Payrexx webhook?

1. In the OneSuite dialog, click the copy button next to **Webhook URL for your Payrexx dashboard**.
2. In Payrexx, open **Webhooks**, then click **Add Webhook**.
3. Paste the OneSuite URL.
4. Choose the JSON webhook type. JSON is a common way for apps to send data.
5. Tick the Transaction event.
6. Save the webhook.
7. Paste its signing key into **Webhook signing key** in OneSuite.

## How do I check it worked?

The Payrexx card on the **Payment Methods** page now says **Connected** instead of **Not connected**. You also see Payrexx marked **Connected** under **Invoices** > **Configure** > **Getting paid** > **Online payments**.

OneSuite switches a connected gateway on for every new invoice. An invoice you created earlier keeps its own choice. To use Payrexx on an older invoice:

1. Open the invoice.
2. Switch Payrexx on in its **Payments** panel.
3. Save the invoice and send it again.

## If something goes wrong

Your Payrexx menu or labels may look different from the steps above. If so, follow Payrexx's own [webhook guide](https://docs.payrexx.com/developer/guides/webhook).

## FAQs

### What is my Payrexx instance name?

It is the first part of your Payrexx address. If your address is yourshop.payrexx.com, your instance name is "yourshop".

### Where do I find the Payrexx webhook signing key?

In Payrexx administration, open **Webhooks** and find the webhook you added for OneSuite. Its signing key is also called the signature secret. Payrexx generated it for that webhook.

### Which currency does Payrexx use in OneSuite?

The **Currency** list starts as Swiss Franc (CHF). OneSuite uses your choice when an invoice has no currency of its own.

## What to do next

**See every gateway:** Browse all the guides in [Payment Integration](https://help.onesuite.io/docs-category/payment-integration/).

**Record the money that arrives:** Log payments made outside a gateway with [How to Record Invoice Payments](https://help.onesuite.io/docs/how-to-record-invoice-payments/).
