How to integrate our widget in your platform
Depasify Widget Integration Guide
Overview
The Depasify widget provides a seamless, customizable interface for integrating KYC (Know Your Customer) processes and fiat-to-crypto gateway functionality into your platform. This solution enables your clients to verify their identity and conduct secure cryptocurrency transactions.
User Journey
Users interacting with the widget will follow these steps:
-
Identity Verification
- Submit personal information (name, ID proof, selfie)
- Complete AML (Anti-Money Laundering) checks
-
Payment Method Selection
- Choose between:
- Individual segregated bank account
- Master bank account (platform-wide)
- Card payment
- Choose between:
-
Transaction Completion
- Process payment
- Automatic redirect to your system via configured redirect_url
Integration Process
Prerequisites
- Create a client account on Depasify - See our Getting Started Guide
- Register as a Depasify partner:
- Contact [email protected]
- Configure your:
- Partner ID
- Theme colors
- Logo
- Trading parameters
Widget Implementation
Basic Implementation
Add the following iframe to your platform:
<iframe
src="https://widget.depasify.com/widgets/kyc"
width="560px"
height="650px"
frameborder="0"
allow="camera">
</iframe>
URL Parameters
Parameter | Required | Description |
---|---|---|
partner | Yes | Your unique partner identifier (provided during registration) |
user_uuid | Yes | UUIDv4 for user identification and session management |
code | No | Additional transaction description text (appended to deposit_id) |
amount | No* | Transaction amount (*Required for direct payment scenarios) |
name | No* | User's first name (*Required for card payments) |
surname | No* | User's last name (*Required for card payments) |
trx_uuid | No | Custom transaction identifier for business tracking |
scenario | No | Workflow configuration (see Scenarios section) |
Available Scenarios
Scenario | Description | Required Parameters |
---|---|---|
with_registry | Complete flow: KYC + registration + funding | None |
direct_funding | Starts at amount selection (No KYC) | None |
direct_card_payment | Starts at card payment screen | amount, name, surname, address, postal_code, city, country_code |
direct_funding_crypto | Starts at crypto payment screen | amount, currency |
direct_payment | Starts at payment method selection | amount |
(default) | KYC + funding flow | None |
Final Configuration
- Provide your redirect_url to Depasify for post-transaction redirects
This can be done by including a “redirect_url” parameter in the widget implementation or by sharing the url to the Depasify team so that it is set in your account by default. - Test the integration in your development environment
- Deploy to production
Support
For technical support or custom implementations, contact our team at [email protected]