Use this step-by-step guide to connect your Swedbank Pay 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.
Limitations
You need a live Frisbii Pay account. The agreement doesn’t work in test mode.
You need an active acquiring agreement with Swedbank Pay.
Step 1: Go to the configuration area
Start by navigating to the correct section in your Frisbii admin:
Click Configurations in the left-hand menu.
Under Configurations, click on Checkout Management and Payment methods.
Click on Credit card agreement.
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 Swedbank as your card acquirer
From the list of available acquirers, click on Swedbank.
You’ll be taken to a new configuration page specifically for setting up your Swedbank Pay 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 Swedbank Pay.
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 Swedbank Pay:
Name: An internal label for the agreement (e.g., My Swedbank Pay Agreement).
TOF number: Your Nets TOF number (7 digits). Swedbank Pay sends it to you by email when your agreement is ready.
Merchant name, address, zip code, city, and country: Make sure these match your registration with Swedbank Pay.
Merchant Category Code (MCC): The four-digit Merchant Category Code that Swedbank Pay assigned to your business.
Merchant website: Your official business website. Remember to include
https://, like:https://my-company-website.com.Swedbank Pay Merchant id: The international TOF number.
These details are required to connect Frisbii to your Swedbank Pay merchant account so payments can be processed and settled 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 Swedbank Pay.
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 Swedbank Pay agreement for use in your Frisbii checkout.
Your integration is now live, and you’re ready to start accepting card payments through Swedbank Pay.
✅ Setup complete!
Your Swedbank Pay 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 Swedbank Pay 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 SEK transactions to Swedbank Pay, 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, or Vipps.
This allows you to assign a specific Swedbank Pay 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
BINs (Bank Identification Numbers)
When you select Set custom settings under Strong customer authentication, the fields Visa BIN, MasterCard BIN appear. These acquirer BINs identify Swedbank Pay as your acquirer during 3D Secure authentication, so the card issuer can process the authentication correctly. Frisbii pre-fills the fields with the standard values that Swedbank Pay uses for all merchants, so you don’t need to enter anything.
Don’t change these values unless Swedbank Pay or Frisbii support asks you to. A wrong BIN makes 3D Secure fail, and your customers can’t complete their card payments.
CIT COF payments
CIT COF payments (customer-initiated transactions with a card on file) are payments your customer starts themselves with a card they saved earlier, for example a one-click purchase.
By default, Frisbii selects the card agreement for a CIT COF payment based on your currently active agreements. The payment therefore doesn’t necessarily go through the agreement the card was saved on.
Turn on Use saved card agreement for CIT COF payments if CIT COF payments should use the agreement the card was saved on instead.
You only need this setting if you have several card agreements and more than one token requestor configuration. In this setup, the agreement Frisbii selects can belong to a different token requestor than the one the card was tokenized with, and the payment can fail. If you have only one card agreement or one token requestor configuration, leave the toggle off.
Also leave the toggle off if CIT COF payments should follow your current routing, for example when you switched acquirers and want saved cards to be charged through the new agreement.
Reference templates
This section allows you to define exactly what identifier Frisbii sends to Swedbank Pay for each transaction. The value you set here will appear in Swedbank Pay’s 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}}, and {{transaction_id}}.
This customization helps streamline reconciliation and accounting by aligning Frisbii transactions with your financial reporting and Swedbank Pay payout files.