JusPay (Hyperswitch) Integration

JusPay uses the Hyperswitch payment orchestration platform to give you a flexible alternative to Stripe for collecting guest payments. With one-click setup, you can create a merchant account, manage multiple payment profiles, and start accepting payments through the guest portal.

What JusPay Powers in SuiteOp

Guest payments — Collect payments for upsells and service fees through the guest portal using the Hyperswitch checkout experience.
Multiple profiles — Create separate payment profiles for different properties or brands, each with its own processor configuration.
Payment orchestration — Route payments through multiple processors for better acceptance rates and lower fees.
Authorization holds — Place holds on guest cards for request-type upsells, then capture or release later.

Prerequisites

Before you begin, make sure you have:

Admin or Owner role in SuiteOp (the manage_payments permission is required)
No external account is needed — SuiteOp creates your Hyperswitch merchant account automatically

Connecting JusPay

Open the Integrations page
1. Integrations
Navigate to Integrations in the sidebar. Find JusPay under the Payment Providers category and click on it.
Create your merchant account

Click the One Click Setup button. SuiteOp automatically creates a Hyperswitch merchant account for your organization and sets up your first payment profile.

After setup, you will receive an onboarding email from Hyperswitch with instructions to access your dashboard and configure payment processors.
Review your payment profiles

Once created, you will see your payment profiles listed in a table with the following columns:
- Nickname — A friendly name for the profile
- Profile ID — The Hyperswitch profile identifier
- Status — Active or inactive
- Default — Whether this is the default profile for new upsells

Managing Payment Profiles

Adding a new profile

If you manage multiple properties or brands that need separate payment configurations, you can create additional profiles:

Click Add Profile on the JusPay integration page
Enter a nickname for the profile
The profile is created in Hyperswitch and appears in your list

Configuring processors

Each profile can be connected to one or more payment processors (such as Stripe, Adyen, or others supported by Hyperswitch). To configure processors:

Click the Hyperswitch Dashboard link on the JusPay integration page
Sign in to the Hyperswitch Dashboard
Navigate to your profile and connect your preferred processors

Using JusPay for Upsells

Once your JusPay account is set up, you can assign it as the payment provider for any upsell:

Go to Settings > Portals and open your portal settings
Edit an existing upsell or create a new one
In the Settings step, under Payment Account, select your JusPay profile from the dropdown
Guests who purchase this upsell will see the Hyperswitch checkout form in the guest portal

For more details on assigning payment accounts to upsells, see Creating Upsells.

Troubleshooting

One-click setup fails

If the account creation does not complete, check that you have the manage_payments permission and try again. If the issue persists, contact SuiteOp support.

Payments are not going through

Verify that at least one processor is connected and active in the Hyperswitch Dashboard
Check that the payment profile assigned to the upsell is active in SuiteOp
Review the charge details in the reservation’s Charges & Payments section for error information

Webhook events are not updating

SuiteOp listens for Hyperswitch webhook events to keep payment statuses in sync. If a payment status seems stale, verify the webhook configuration in your Hyperswitch Dashboard or contact SuiteOp support.

Stripe Integration — Set up Stripe as a payment provider
GuestyPay Integration — Use Guesty’s built-in payment system
Creating Upsells — Create upsells and assign payment accounts
Managing Charges & Payments — Capture, refund, and manage reservation charges