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?
- Click your name at the bottom of the sidebar, then click Settings.
- Under Integrations, click Payment.
- On the Payment Methods page, find Payrexx and click Connect. Keep the dialog open.
- Type your instance name into Instance name.
- In Payrexx administration, open API & Plugins. Copy your API secret into API secret.
- Add the webhook in Payrexx. The next section shows you how.
- Copy the webhook’s signing key into Webhook signing key.
- Check the Currency.
- Click Save.

How do I add the Payrexx webhook?
- In the OneSuite dialog, click the copy button next to Webhook URL for your Payrexx dashboard.
- In Payrexx, open Webhooks, then click Add Webhook.
- Paste the OneSuite URL.
- Choose the JSON webhook type. JSON is a common way for apps to send data.
- Tick the Transaction event.
- Save the webhook.
- 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:
- Open the invoice.
- Switch Payrexx on in its Payments panel.
- 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.
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.
Record the money that arrives: Log payments made outside a gateway with How to Record Invoice Payments.