Integrate Crypto Payments in Minutes
The Payd Ramp Widget provides a seamless interface for converting between fiat currencies and cryptocurrencies. Easily integrate our widget into your application with a few simple steps.
Quick Integration Guide
1
Generate a Widget Session
Create a session with your desired configuration using our API.
curl -X POST https://ramp.payd.cash/api/widget/generate \ -H "Content-Type: application/json" \ -H "Authorization: Basic <credentials>" \ -d '{ // Required parameters "type": "onramp", // "onramp" or "offramp" "callbackUrl": "https://example.com/callback", "redirectUrl": "https://example.com/success", // Optional parameters "prefill": { "amount": 100, // Amount in fiat currency "token": "USDt", // Token to receive (e.g., "USDt", "LSK", "cUSD", "cKES") "network": "lisk", // Blockchain network (e.g., "lisk", "celo") "walletAddress": "lsk123abc...", // Recipient wallet address "email": "user@example.com", // User email for notifications "phone": "+254712345678" // User phone for notifications }, "styling": { "primaryColor": "#7C3AED", // Primary brand color "darkMode": false, // Enable dark mode "fontFamily": "Nunito, sans-serif" // Custom font family }, "metadata": { // Custom metadata for your reference "orderId": "order_123456", "userId": "user_789012", "source": "checkout_page" }, "webhookSecret": "your_webhook_secret", // Secret for webhook signature verification "expiresIn": 3600 // Session expiry in seconds (default: 1 hour) }'
2
Integrate the Widget
Use the returned widgetUrl
in your application.
// Example iframe integration <iframe src="https://ramp.payd.cash/widget/abc123?mode=iframe" width="450" height="700" frameborder="0" ></iframe>
3
Handle Callbacks
Receive transaction updates at your callback URL.
initiatedTransaction has been started
pendingPayment is being processed
completedTransaction completed successfully
failedTransaction has failed
Powerful Features
Supported Networks
- Lisk
- Celo
Supported Tokens
- LSK (Lisk)
- USDt (Tether on Lisk)
- cUSD (Celo Dollar)
- cKES (Celo Kenyan Shilling)
Payment Methods
- M-Pesa
Customization Options
- Pre-filled values
- Custom branding
- Theme selection
Ready to Get Started?
Integrate the Payd Ramp Widget today and provide your users with a seamless crypto on-ramp experience.
View Developer Documentation