Integrationv. 1.0.0

Bancomail iFrame - Integration Guide

Integrate Bancomail database access into your application or website through a faster, ready-to-use embedded module. The iFrame solution is designed to preserve your navigation flow, support partner-specific configurations, and simplify query building, package discovery, and quote generation inside your platform.

Ready to embedA pre-configured module, customizable to your design guidelines.
Query-driven UXUsers explore data packages through what / where filters and structured results.
Flexible commercial flowQuote handling can stay with your team or be managed by Bancomail with referral logic.

Overview

The Bancomail iFrame integration is a faster, ready-to-use alternative to a full API implementation. It is designed for partners who want to embed Bancomail search and quote-generation capabilities into their own website or platform with a shorter setup time.

Bancomail provides a fully embeddable module that can be customized according to the hosting partner’s design guidelines. This makes it possible to present the experience as a native extension of your own interface while relying on Bancomail’s backend logic.

Since each iFrame is created specifically for the partner that hosts it, there is room for configuration based on individual requirements. The objective is to reduce friction and keep the user journey coherent with your platform experience.

End-user experience

The embedded module is designed to support three main user actions:

1. Build queries

Users can create target selections through combinations of what / where filters, making it easier to identify the most relevant data segments directly within the integrated experience.

2. Explore data packages

Once the query is defined, users can instantly access available data packages, including key commercial and selection details, without leaving the page.

3. Generate quote requests

The module can generate a structured quote request based on the selected parameters, turning the configuration into a ready-to-use input for commercial handling.

Where to embed the module

The module can be embedded across different areas of your platform or website: product pages, reserved areas, onboarding flows, or dedicated lead generation sections. It can act as a pre-qualification tool, request collector, or commercial activation layer, adapting to your operating model.

Commercial workflow

From a commercial standpoint, the quote flow can be configured in more than one way depending on how the partner wants to manage the relationship with the end customer.

Scenario How it works
Quote handled by your team The generated request is sent to your commercial team. You remain in charge of the negotiation and customer relationship, while Bancomail supports the process through its backend and operational structure.
Quote handled by Bancomail The generated request can be sent directly to Bancomail. In this case, Bancomail can manage the transaction and recognize a referral fee to the hosting partner.
Platform-specific promotions Exclusive discounts can also be applied to users coming through your platform, making the embedded flow commercially differentiated and easier to align with your acquisition strategy.

Partner-led model

Best suited for partners who want to retain control over pricing communication, negotiation timelines, and account management, handling the commercial relationship directly.

Bancomail-led model

Best suited for partners who prefer to rely on Bancomail for GDPR compliance management and target definition, which may require an iterative process based on available parameters.

Configuration options

Each iFrame is custom-built for the partner hosting it, allowing Bancomail to configure a flexible layer that adapts to visual guidelines as well as the operational, commercial, and integration requirements defined by the partner.

Area Possible configuration scope
Visual integration Adapting colors, spacing, labels, and interface presentation to the partner’s design guidelines.
Commercial routing Directing quote requests either to the partner team or to Bancomail, depending on the agreed model.
Promotional logic Applying dedicated discounts or partner-specific conditions for users arriving through the embedded module.
Shared data handling Where useful, requests can also be saved in a shared table or equivalent shared layer so that the partner can communicate progress or outcomes inside its own platform or page, without interrupting the browsing flow.
Navigation continuity The setup can be designed to minimize context switching and keep the interaction inside the partner environment as much as possible.
A key advantage of this model is that it can be shaped around the hosting environment. The aim is not only to embed a tool, but to make the tool feel compatible with the surrounding product experience.

Suggested integration flow

The following structure can be used as a practical reference for a partner-facing iFrame experience:

Step Module area Purpose
01 Target Selection Users define the audience through filter combinations such as sector, geography, and related selection logic.
02 Result Grid Available packages are displayed with key details, allowing the user to evaluate the most suitable option.
03 Quote Request The selected configuration is transformed into a structured request ready for commercial processing.
04 Follow-up / Purchase Link The flow continues through partner-led or Bancomail-led handling, depending on the agreed commercial model.
What / Where filters Package evaluation Formalized request Commercial routing Optional referral / discount logic

Interface mockups

The following mockups illustrate the three main interface areas of the embedded module as they appear inside a partner platform: Target Selection, Result Grid, and Quote Request.

Mock 01 · Target Selection
Search anything
?
U
User Name
Logged in
Grow your B2B reach with Bancomail
Filter by industry and geography to surface relevant business databases directly inside your platform.
Embedded partner widget
embedded-bancomail-widget
iFrame
Expand your contact list with qualified B2B data
Select an industry and a target geography to explore relevant business databases and pricing.
Find your target
Partner logo area
Category
Industry / Business sector
Location
Country / Region / Area
Search Database
Reset
Mock 02 · Result Grid
Search anything
?
U
User Name
Logged in
Grow your B2B reach with Bancomail
A native-looking widget experience embedded inside the partner platform workflow.
embedded-bancomail-widget
iFrame
Search results
11 databases found
Industry Segment
Available
Country - All regions
XXXX
Total contacts
€0.XXX
€0.XXX
Per contact
Updated recently
Included data
Company
Email
Location
Website
Phone
Add to selection
Industry Segment
Available
Country - Region
XXX
Total contacts
€0.XXX
€0.XXX
Per contact
Updated recently
Included data
Company
Email
Region
Phone
Add to selection
Additional result card
Repeatable card pattern for larger result sets
Mock 03 · Quote Request & Selection Sidebar
Search anything
?
U
User Name
Logged in
embedded-bancomail-widget
iFrame
Search results
11 databases found
Industry Segment
Country - Region
Industry Segment
Country - Region
Your selection
Industry Segment
XXX
Country - Region
Price per contact €0.XXX
Industry Segment
XXX
Country - Region
Price per contact €0.XXX
Total contacts XXXX
Total €XXX
Partner discount applied inside the embedded flow
Request Quote
Clear Selection

Recommended next steps

Functional definition

Align on the commercial model, the quote-routing logic, and any discount or referral conditions to be applied to customers arriving from the partner environment.

UX and configuration brief

Share visual guidelines, navigation constraints, and any data persistence requirements so the iFrame can be shaped around the hosting page or platform.

Partner application

Integration is available to Bancomail partners. Apply to the Partner Program and activate your setup with direct support from our team.