Clearhaus

Use this step-by-step guide to connect your Clearhaus acquiring agreement in Frisbii so you can accept card payments from your customers. Each step includes helpful context to explain what you’re doing and how it affects your setup.

Step 1: Go to the configuration area

Start by navigating to the correct section in your Frisbii admin:

• Click Configuration in the left-hand menu.

• Under Configuration, select Checkout Management.

• Now, click Credit card agreements.

This brings you to a page showing all the supported card acquirers in Frisbii.

This is where you manage and set up the agreements that allow you to accept card payments in your checkout.

Step 2: Select Clearhaus as your card acquirer

From the list of available acquirers, click on Clearhaus.

You’ll be taken to a new configuration page specifically for setting up your Clearhaus agreement.

Each acquirer has its own setup process.

Step 3: Choose the processor mode

At the top of the configuration page, choose between:

• Recommended (preselected): Uses Frisbii’s standard setup for Clearhaus.

• Custom: Allows manual configuration for special cases.

Unless you have specific technical needs, stick with Recommended.

This determines how your payments are processed. The recommended option is optimized for simplicity and compatibility.

Step 4: Fill in your company and agreement details

Now complete the form with the details provided by Clearhaus:

• Name: An internal label for the agreement (e.g., My Clearhaus Agreement).

• API token: Paste in the API token issued by Clearhaus (required).

• Merchant website: Your official business website. Remember to include https://, like: https://my-company-website.com.

These details are required to connect Frisbii to your Clearhaus merchant account so payments can be processed correctly.

Step 5: Select which card brands to accept

In the Cards payment methods section, choose the card types your business supports. You can check them one by one or use the Select all option.

Common card brands to enable include:

• Visa

• Visa Electron

• Mastercard

• Maestro

This controls which cards your checkout will display to customers. Make sure to only select the cards you’re allowed to accept through Clearhaus.

Step 6: Set up token requestor IDs

Under Token requestor configuration, connect the necessary token IDs:

• For Visa and Mastercard, select your Token Requestor ID from the dropdown.

• If you haven’t created one yet, click Create Visa token requestor ID or Create Mastercard token requestor ID.

These identifiers enable you to securely process payments through network tokenization. The primary advantage is that Frisbii can automatically update saved cards for you, meaning your customers won’t have to update their card details—helping you reduce involuntary churn.

Step 7: Review optional advanced settings

At the bottom of the page, click Show advanced settings if you need to enter specific parameters or adjust default behavior.

Most users don’t need to touch this section, but it’s there if you’ve been given technical requirements or special instructions.

Step 8: Save and activate your setup

Finally, click the green Create button at the top right.

This saves your configuration and activates your Clearhaus agreement for use in your Frisbii checkout.

Your integration is now live, and you’re ready to start accepting card payments through Clearhaus.

✅ Setup complete!

Your Clearhaus agreement will now appear under your list of credit card agreements. You can return to this section at any time to make updates or enable additional cards.

🔧 Need more control? Explore the advanced settings

If your business setup requires more specific routing, authentication, or branding behavior, you can expand the advanced settings when configuring your Clearhaus agreement in Frisbii. These options give you the flexibility to adapt your checkout flow based on how and where transactions happen.

These advanced features are optional and best used by teams who understand how payments are routed and handled. If unsure, default settings are a safe starting point.

Click “Show advanced settings” to reveal the following configurable options:

Currencies

Choose whether this agreement should:

• Use all currencies (default)

• Or only apply to specific currencies you define

Frisbii uses this setting to determine which acquiring agreement to route a payment through. For example, you can send DKK transactions to Clearhaus, and EUR to another acquirer.

Payment methods

Select whether this agreement applies to:

• All payment methods (default)

• Or only selected methods, such as:

  • Card

  • MobilePay

  • Apple Pay

  • Google Pay

  • Vipps

This allows you to assign a specific Clearhaus agreement to just Apple Pay, for instance, while using a different acquirer for regular card transactions.

Strong customer authentication (SCA)

Fine-tune your authentication rules:

• Enable or disable 3D Secure

• Enable 3D Secure for recurring

• Disallow 3D Secure attempted

• Require SCA by default

You can also enable 3D Secure for pre-authorizations, meaning that there is strong customer authentication when a recurring payment method is created. Whether this results in liability shift in subsequent transactions depends on the acquirer. Contact Clearhaus for more information.

Payout

Certainly! Here's a clear and structured version of the Payout section, aligned with the tone and style of the rest of the guide:

Payout

You have the option to enable Payout functionality, which allows you to send funds directly to saved cards using Visa Direct and Mastercard Send.

This feature supports use cases such as:

• Marketplaces

• Customer refunds

• Vendor disbursements

• In-app wallet withdrawals

Payouts are initiated from within Frisbii and rely on card tokens previously stored during transactions.

To use this feature:

• It must be enabled by Clearhaus on your merchant account

• Special pricing applies from both Frisbii and Clearhaus

• You must store customer cards in Frisbii to issue payouts

Enable the toggle “Enable payout” only if you’ve received confirmation from both Frisbii and Clearhaus that your setup is approved for outbound card payouts.

Reference templates

This section allows you to define exactly what identifier Frisbii sends to Clearhaus for each transaction. The value you set here will appear in Clearhaus' reporting and settlement files, making it easier to match payments with internal records like invoices or subscriptions.

By default, Frisbii uses the invoice handle (e.g., inv-123456) as the identifier.

You can customize:

• Order ID template – Controls what Frisbii sends as the primary order reference.

• Soft description template – Optional. Used for descriptors on cardholder statements, if supported.

Both fields support dynamic tags such as:

• {{invoice_number}}

• {{account_name}}

• {{transaction_id}}

This customization helps streamline reconciliation and accounting by aligning Frisbii transactions with your financial reporting and Clearhaus payout files.

Settlements & transactions

Once your Clearhaus agreement is active and payments begin flowing through Frisbii, you'll likely want to reconcile what you've processed with what your acquirer reports.

Depending on the acquirer, this is typically done through a settlements section in the acquirer’s own dashboard.

For Clearhaus, follow these steps to access settlement data:

1. Log in to the Clearhaus Dashboard

2. Select your merchant name in the top-left menu

3. Click on Settlements

Here you’ll find an overview of all processed transactions, including:

• Sales, refunds, and chargebacks

• Fees and reserves (if any)

• Settlement periods and payout dates

• Currency and account details

You can also export your settlements using the Prepare Export button in the dashboard.