Split Gateway

Display a specific payment method within your cashier by using the Split Gateway feature with the init-iframe API.

By default, the MiFinity iFrame displays all available payment methods based on the customer's location. Split Gateway overrides this behavior, letting you specify which payment method to show.

How it works

Pass the paymentMethod parameter in your init-iframe API request to control which payment method appears. The customer sees three options in the iFrame:

• Specified payment method — the method you passed (e.g., BLIK, Giropay, etc.)
• MiFinity Balance — shown by default for users who already have a balance
• Other Options — a tile that directs customers to a landing page with all available payment methods for their region within the MiFinity app. Customers can then use their MiFinity balance on your site

Example

Pass the desired payment method in the paymentMethod field of init-iframe request:

{
  "paymentMethod": "BLIK"
}

With "paymentMethod": "BLIK", the iFrame renders as follows:

📘

The Other Options tile is not a payment method itself — it links to all available methods for the customer's region.