Getting Started
Welcome to CryptumPay Widget! This guide will help you integrate cryptocurrency payments into your website in just a few minutes.
Prerequisites
Before you begin, make sure you have:
- ✅ A CryptumPay merchant account (Sign up here)
- ✅ Your Project ID from the merchant console
- ✅ Your domain added to the project (required - widget won't work otherwise)
- ✅ Basic knowledge of HTML and JavaScript
- ✅ (Optional) Backend server for fixed-amount orders
Domain Authorization Required
Before using the widget, you must add your domain to the project in Merchant Console.
The widget will only work on authorized domains. If you try to use it on a non-authorized domain, you'll see an "Invalid source" error in the browser console and the widget won't load.
Step-by-Step Integration
Step 1: Get Your Project ID
- Log in to CryptumPay Console
- Navigate to Projects → Your Project
- Copy your Project ID
Step 2: Include the Widget Script
Add the CryptumPay widget to your HTML page. Follow the detailed instructions on the Installation page to include the script with the correct version and integrity hash.
Step 3: Choose Your Integration Approach
Depending on your business needs, choose the most suitable integration approach from the Use Cases page:
- Donations/Top-ups - Users choose the amount (no backend needed)
- E-commerce - Fixed prices, orders created on button click
- Custom Logic - Pre-created orders, maximum flexibility
- Payment Links - Send links via email/messengers (no widget)
Each use case includes complete code examples and setup instructions.
What's Next?
Now that you have a basic integration working, explore more advanced features:
- Backend Integration - Create orders from your server for fixed amounts
- Callbacks - Handle payment events
- UI Customization - Match your brand
Need Help?
- 🏢 Merchant Console
- 📧 Support: [email protected]