Form Integration Guide

Integrate Zynx loan application forms directly into your website using iframe embeds. No coding required - just copy, paste, and customize.

🚀 Quick Start

UK Form

<iframe 
  src="https://forms.zynx.co.uk/uk?affid=YOUR_AFFID"
  width="100%" 
  height="800"
  frameborder="0"
  scrolling="auto">
</iframe>

UK loan application form

US Form

<iframe 
  src="https://forms.zynx.co.uk/us?affid=YOUR_AFFID"
  width="100%" 
  height="800"
  frameborder="0"
  scrolling="auto">
</iframe>

US loan application form

⚙️ Configuration Options

URL Parameters

Parameter Description Example
affid Your affiliate ID (required) aff_123456
campaign Campaign identifier summer_2024
clickid Click tracking ID click_789
theme Form theme (light/dark) dark
prefill Pre-fill form data (JSON) {"email":"user@example.com"}

Styling Options

CSS Customization

/* Custom iframe styling */
.loan-form-iframe {
  border-radius: 12px;
  box-shadow: 0 10px 30px rgba(0,0,0,0.3);
  border: 1px solid rgba(255,255,255,0.1);
}

.loan-form-iframe iframe {
  border-radius: 12px;
  overflow: hidden;
}

Responsive Design

/* Responsive iframe */
.loan-form-container {
  position: relative;
  width: 100%;
  height: 0;
  padding-bottom: 56.25%; /* 16:9 aspect ratio */
}

.loan-form-container iframe {
  position: absolute;
  top: 0;
  left: 0;
  width: 100%;
  height: 100%;
}

💻 Implementation Examples

Basic Implementation

<!DOCTYPE html>
<html>
<head>
    <title>Loan Application - Your Site</title>
    <meta name="viewport" content="width=device-width, initial-scale=1">
</head>
<body>
    <div class="loan-form-container">
        <iframe 
            src="https://forms.zynx.co.uk/uk?affid=YOUR_AFFID&campaign=website"
            width="100%" 
            height="800"
            frameborder="0"
            scrolling="auto"
            allow="payment">
        </iframe>
    </div>
</body>
</html>

📡 Event Handling

PostMessage Events

Listen for events from the iframe to track user interactions

// Listen for form events
window.addEventListener('message', function(event) {
  if (event.origin !== 'https://forms.zynx.co.uk') return;
  
  switch(event.data.type) {
    case 'form_started':
      console.log('User started filling form');
      break;
      
    case 'form_step_completed':
      console.log('Form step completed:', event.data.step);
      break;
      
    case 'form_completed':
      console.log('Form submitted successfully:', event.data.leadId);
      // Track conversion
      break;
      
    case 'form_abandoned':
      console.log('User abandoned form at step:', event.data.step);
      // Track abandonment
      break;
  }
});

form_started

User begins filling the form

form_completed

Form submitted successfully

form_abandoned

User left form incomplete

form_step_completed

User completed a form step

🔧 Troubleshooting

Common Issues

Form not loading

Check if the iframe src URL is correct and accessible

https://forms.zynx.co.uk/uk?affid=YOUR_AFFID

Events not firing

Ensure you're listening for messages from the correct origin

if (event.origin !== 'https://forms.zynx.co.uk') return;

Mobile display issues

Use responsive iframe container with proper viewport meta tag

<meta name="viewport" content="width=device-width, initial-scale=1">

Need Help?

Our integration team is here to help you get started