Integration Documentation
Add Express P2P crypto trading to your platform with our easy-to-integrate widget. Connect your users directly with verified sellers for seamless crypto purchases.
Documentation
Integrations
What is Palzea Widget?
Palzea Widget is an embeddable crypto trading solution that enables your users to buy and sell cryptocurrency directly through your platform. Our Express P2P network connects buyers with verified sellers, providing escrow protection and seamless transactions.
Key Features:
- Easy integration with just a few lines of code
- Support for multiple cryptocurrencies (BTC, ETH, etc.)
- Built-in KYC verification for secure transactions
- Escrow protection for buyer and seller safety
- Customizable themes to match your platform's design
How to Integrate Widget
Five steps, start to finish: get an API key, drop in an iframe, optionally configure it, optionally control it live, then test on staging before going live. No SDK install, no backend changes required on your side.
Step 1: Get Your API Key
First, you need to register as a partner and obtain your API credentials.
- Go to Partner Portal
- Register or login to your partner account
- Navigate to "Developers" section in your dashboard
- Copy your API Key
Note: Keep your API Key secure and never expose it in client-side code.
Step 2: Add Widget to Your Platform
HTML/JavaScript Integration:
<!-- Add this to your HTML -->
<iframe
src="https://widget-p2p-stage.palzea.com?apikey={{apikey}}&theme=dark/light&locale=en"
title="Palzea Crypto Widget"
loading="lazy"
allow="accelerometer; autoplay; camera; gyroscope; payment; microphone"
referrerpolicy="no-referrer-when-downgrade"
style="width:100%; height:750px; border:0;"
></iframe>Step 3: Configuration Options
Every query parameter the widget's src URL accepts:
| Parameter | Required | Example | Description |
|---|---|---|---|
apikey | Yes | pk_live_abc123 | Your Partner Portal API key. Identifies your account and controls which currencies/payment methods are available. |
theme | No | dark or light | Sets the widget's color scheme on load. Can also be changed live afterwards via postMessage({ type: 'THEME_CHANGE', theme }). |
locale | No | en, es, es-ar, es-mx, ... | Sets the widget's display language on load (e.g. "en", "es-ar"). Defaults to a previously saved preference, then the visitor's browser language, then English if neither matches a supported locale. |
Step 4: Control the Widget Live (Optional)
Once embedded, your page can update the widget's theme or language at any time via postMessage — no iframe reload needed. Useful if your site has its own dark/light toggle or language switcher you want the widget to follow.
const widgetFrame = document.querySelector('iframe[title="Palzea Crypto Widget"]');
// Switch the widget's theme to match your own dark/light toggle
widgetFrame.contentWindow.postMessage(
{ type: "THEME_CHANGE", theme: "dark" }, // "dark" or "light"
"*"
);
// Switch the widget's language to match your own locale switcher
widgetFrame.contentWindow.postMessage(
{ type: "LOCALE_CHANGE", locale: "es-ar" },
"*"
);Step 5: Test, Then Go Live
- Use your staging API key first (Partner Portal → Developers → Staging). Orders placed with it use a simulated wallet flow and never affect your live dashboard stats.
- Walk through a full test order end-to-end: connect a wallet, get matched with a merchant, complete KYC if prompted, and confirm payment.
- Errors surface on their own — the widget shows its own error toasts by default, so nothing extra is required on your side.
- When ready, switch to your production API key (same Developers page) and re-deploy.
Test Credentials
Use these credentials to test the integration in sandbox mode:
Sandbox API Key
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxNote: Sandbox mode simulates transactions without real money. Visit the Partner Portal to get your production credentials.
Getting Help and Support
Need assistance? We're here to help you integrate successfully.