5-minute sportsbook iframe integration

Complete Sportsbook & Betting Site Solutions

Launch Sportsbook
with one iframe

Connect your users to AlvaronTech Sportsbook with a single PHP file. The package handles iframe login, balance checks, settlement callbacks, cashout updates and secure signatures.

⚡ 5-minute installation 🔐 Secure HMAC signatures 💳 Balance & settlement callbacks 🌍 12 language documentation
iframe.php
$siteKey  = 'YOUR_SITE_KEY';
$apiToken = 'ALVARON_API_TOKEN';

https://yourdomain.com/iframe.php
  ?username=demo_user
  &platform=desktop
Ready for integration

Upload, configure credentials, test the iframe and go live.

Overview

A simple bridge between your user database and AlvaronTech Sportsbook.

The integration reads the user from your own database, sends the current balance securely to AlvaronTech, opens the sportsbook iframe and receives balance updates through signed callbacks.

Quick Setup

Install in 5 minutes.

Only edit the credentials section, upload the file to your server and open the iframe URL. The rest of the flow is handled automatically.

1. Edit these values

Place your MySQL connection, site key and API token at the top of iframe.php.

iframe.php
$dbHost = 'DB_HOSTUNUZ';
$dbName = 'DB_ADINIZ';
$dbUser = 'DB_KULLANICINIZ';
$dbPass = 'DB_SIFRENIZ';

$siteKey  = 'YOUR_SITE_KEY';
$apiToken = 'ALVARON_TARAFINDAN_VERILEN_API_TOKEN';
Usage Links & Endpoints

Open the iframe, check balance and receive settlement callbacks.

The customer usually opens only the iframe URL. Balance check and callback endpoints are called by the central AlvaronTech system.

Desktop member URL
https://yourdomain.com/iframe.php?username=demo_user&platform=desktop
Mobile member URL
https://yourdomain.com/iframe.php?username=demo_user&platform=mobile
Guest URL
https://yourdomain.com/iframe.php?platform=desktop
Optional page parameter
https://yourdomain.com/iframe.php?username=demo_user&platform=desktop&page=sports/live/
Database

Minimum database structure.

The integration expects a users table. Transaction history is created automatically in alva_sports_transactions.

Required users table fields

Auto-created transaction table

iframe.php creates alva_sports_transactions automatically when the first callback arrives. It stores transaction id, user, action, delta, balance before/after and raw callback payload.

Keep username values identical between your site and the iframe URL.
iframe.php Functions

What each function does.

These helper functions keep the integration clean: database access, secure signatures, API calls, JSON responses and transaction logging.

Node.js + PostgreSQL

Use the same integration flow with Express and PostgreSQL.

The package includes a complete Node.js example with PostgreSQL balance reads, signed callbacks, transaction logging and iframe token generation.

.env
PORT=3058
PUBLIC_BASE_URL=https://yourdomain.com
PGHOST=127.0.0.1
PGPORT=5432
PGDATABASE=your_database
PGUSER=your_db_user
PGPASSWORD=your_db_password
ALVARON_SITE_KEY=YOUR_SITE_KEY
ALVARON_API_TOKEN=API_TOKEN_PROVIDED_BY_ALVARON
ALVARON_CENTRAL_BASE=https://alvarontech.work
Install & run
cd nodejs-postgresql
cp .env.example .env
npm install
psql -U your_db_user -d your_database -f schema.sql
npm start
Node iframe URL
https://yourdomain.com/iframe.php?username=demo_user&platform=desktop
Node package
AlvaronTech_nodejs_postgresql.zip
nodejs-postgresql/README.md
nodejs-postgresql/src/server.js
nodejs-postgresql/schema.sql
Security & Reliability

Secure by token, signature and timestamp.

Each important request is signed with your private API token. Callback timestamps are checked and duplicate transaction ids are safely ignored.

Troubleshooting

Common setup errors.

Most problems come from wrong credentials, missing users, server access or an invalid API token.

Support

Need help with installation?

Send your domain, callback URL and server environment details. Our team can help you verify the iframe, balance flow and settlement callbacks.