Documentation

Everything you need to know about InstantPay

Table of Contents

Getting Started

What is InstantPay?

InstantPay is a no-code platform that allows you to accept Solana (SOL) payments through personalized payment pages. Create custom links, sell digital products, and build your online presence—all with zero commission fees.

Quick Start

  1. Connect your Solana wallet (Phantom, Solflare, etc.)
  2. Set up your profile (username, display name, bio)
  3. Customize your page with themes and colors
  4. Add your social links and custom links
  5. Share your unique payment page URL

Requirements

  • A Solana wallet (Phantom recommended)
  • Modern web browser (Chrome, Firefox, Safari)
  • No coding knowledge required!

Creating Your Payment Page

Profile Setup

Your payment page is your digital identity. Make it shine!

  • Username: Your unique identifier (e.g., instantpay.com/u/yourname)
  • Display Name: Your full name or brand name
  • Bio: Tell people who you are and what you do
  • Profile Image: Upload a professional photo (max 250 KB)

Social Links

Connect all your social profiles in one place:

  • Twitter
  • Discord
  • Telegram
  • Instagram
  • GitHub
  • Website

Payment Settings

Configure how you receive payments:

  • Default Amount: Set suggested payment amounts
  • Custom Message: Add a personal touch to your payment page
  • Wallet Address: Automatically set to your connected wallet

Theme Customization

Choose from 5 beautiful, professionally designed themes:

  • Default: Clean and professional purple gradient
  • Ocean: Calming blue tones
  • Sunset: Warm orange and red gradient
  • Forest: Natural green palette
  • Midnight: Dark and elegant

Each theme includes custom colors, fonts, button styles, and gradients to match your brand.

Analytics

Track your performance with built-in analytics:

  • Page Views: See how many people visit your page
  • Link Clicks: Track engagement on each custom link
  • Sales Statistics: Monitor revenue from digital products
  • Time-based Trends: View data for today, this week, this month, or all time

📊 Coming Soon: Advanced analytics with conversion rates, geographic data, and more!

Future Features

We're constantly improving InstantPay. Here's what's coming:

🚧 In Development

  • Premium Tiers: Unlock advanced features with SOL payments
  • Advanced Analytics: Conversion tracking, heat maps, and more
  • QR Code Customization: Branded QR codes for your payment page

📋 Planned

  • WooCommerce Integration: Accept SOL payments in your online store
  • Advanced Embeddable Widgets: More customization options for embedded widgets
  • API Access: Build custom integrations
  • Mobile App: Manage your payment page on the go
  • Multi-Currency Support: Accept multiple SPL tokens
  • Subscription Management: Recurring payments for memberships

💚 Have a feature request? Contact us through the Support page!

WordPress Plugin

The InstantPay WordPress plugin brings Solana payments directly to your WordPress site. Accept donations, sell digital products, and embed payment widgets—all without leaving your WordPress dashboard.

Installation

  1. Download the plugin ZIP file from the Downloads page
  2. Log in to your WordPress admin dashboard
  3. Navigate to Plugins → Add New → Upload Plugin
  4. Click Choose File and select the downloaded ZIP file
  5. Click Install Now and wait for the installation to complete
  6. Click Activate Plugin to enable InstantPay

Initial Setup

After activation, you'll see InstantPay in your WordPress admin sidebar. Follow these steps to connect your account:

  1. Click on InstantPay in the admin menu
  2. In the embedded dashboard, connect your Solana wallet (Phantom, Solflare, etc.)
  3. Complete your profile setup by entering a username and display name
  4. Click Refresh Status to update your connection status

💡 Tip: You can manage your InstantPay account entirely from WordPress—no need to visit the main website!

Gutenberg Blocks

InstantPay provides three Gutenberg blocks that you can add to any post or page:

1. InstantPay Donate Widget

Accept donations directly on your WordPress site. Visitors can send SOL payments with custom amounts and messages.

Usage: Add the block, and it will automatically use your connected InstantPay username. No configuration needed!

2. InstantPay Product Purchase

Sell your digital products directly from WordPress. The block automatically loads your products from InstantPay.

Usage: Add the block, select a product from the dropdown (or enter a Product ID manually), and publish. The widget will handle payments and file delivery automatically.

3. InstantPay Full Page Embed

Embed your complete InstantPay payment page as an iframe. Perfect for dedicated payment pages.

Usage: Add the block and optionally specify a username. If left empty, it uses your connected account.

Shortcodes

For classic editor users or custom templates, InstantPay provides shortcodes:

[instantpay_donate]
[instantpay_product product_id="your-product-id"]
[instantpay_page username="optional-username"]

📝 Note: Shortcodes work in posts, pages, widgets, and even in theme templates. They're perfect for adding payment functionality anywhere on your site.

Admin Dashboard

The InstantPay admin page provides a seamless experience:

  • Embedded Dashboard: Access your full InstantPay dashboard without leaving WordPress
  • Connection Status: See your wallet connection and username at a glance
  • Quick Refresh: Update your connection status with one click
  • How-to Guide: Built-in instructions for using blocks and shortcodes

Creating Digital Products

To sell products through WordPress, first create them in your InstantPay dashboard:

  1. Go to the InstantPay admin page in WordPress
  2. In the embedded dashboard, navigate to the Products tab
  3. Click Create New Product
  4. Upload your digital file (PDF, video, image, audio, ZIP, etc.)
  5. Set a title, description, and price in SOL
  6. Configure download limits if needed
  7. Save the product

Once created, your products will automatically appear in the InstantPay Product Purchaseblock dropdown when editing posts or pages.

Best Practices

  • Test First: Always test payments on a staging site before going live
  • Clear Instructions: Add clear instructions for visitors on how to use Solana wallets
  • Mobile Optimization: Ensure your payment widgets are visible and functional on mobile devices
  • Regular Updates: Keep the plugin updated to the latest version for security and new features
  • Backup Before Updates: Always backup your WordPress site before updating plugins

Troubleshooting

Widget not displaying?

  • Ensure your wallet is connected in the InstantPay admin page
  • Check that you've entered a valid username
  • Verify your WordPress site allows iframes (some security plugins block them)

Products not loading in dropdown?

  • Make sure you've created at least one digital product in your InstantPay dashboard
  • Check your internet connection
  • Try manually entering the Product ID if the dropdown fails

Connection status not updating?

  • Click the Refresh Status button after connecting or disconnecting your wallet
  • Clear your browser cache and reload the page
  • Ensure JavaScript is enabled in your browser

System Requirements

  • WordPress: Version 5.8 or higher
  • PHP: Version 7.4 or higher
  • Browser: Modern browser with JavaScript enabled
  • Internet: Active connection required for widget functionality

Security & Privacy

The InstantPay WordPress plugin follows WordPress security best practices:

  • All user inputs are sanitized and validated
  • CSRF protection via WordPress nonces
  • Capability checks for admin functions
  • Secure communication between WordPress and InstantPay servers
  • No sensitive data stored in WordPress database

✅ Open Source: The plugin code is available for review. We welcome security audits and contributions from the community.

Getting Help

Need assistance with the WordPress plugin?

Ready to Accept Solana Payments?

Download the InstantPay WordPress plugin and start accepting payments in minutes.

Download Plugin

WooCommerce Integration

Accept Solana (SOL) and USDC payments directly on your WooCommerce checkout page. The InstantPay WooCommerce integration provides a native payment gateway with real-time exchange rates, automatic transaction verification, and seamless order processing.

Installation & Setup

The WooCommerce integration is included in the InstantPay WordPress plugin (v1.1.0+). Follow these steps to enable SOL and USDC payments on your WooCommerce store:

  1. Install and activate the InstantPay WordPress plugin (see WordPress Plugin section)
  2. Ensure WooCommerce is installed and active on your WordPress site
  3. Navigate to WooCommerce → Settings → Payments
  4. Find InstantPay (Pay with SOL or USDC) in the payment methods list
  5. Click Manage or toggle the switch to enable it
  6. Configure your payment gateway settings (see Configuration below)
  7. Click Save changes

Configuration

Configure the following settings in the InstantPay payment gateway:

Solana Wallet Address

Your Solana wallet address where payments will be received. This is the same address you connected in your InstantPay dashboard.

Test Mode

Enable test mode to use Solana Devnet for testing. Payments in test mode won't use real SOL/USDC. Always test your checkout flow before going live!

Solana RPC URL

The Solana RPC endpoint for transaction processing. We recommend using a reliable provider like Helius for production. Default: https://api.mainnet-beta.solana.com

Minimum Order Amount

Minimum order amount: 0.001 SOL. Orders below this amount cannot be paid with SOL/USDC.

How It Works

The InstantPay WooCommerce integration provides a seamless checkout experience:

  1. Customer adds products to cart and proceeds to checkout
  2. "Pay with SOL or USDC" appears as a payment option alongside other methods
  3. Customer chooses currency: They can toggle between SOL and USDC
  4. Real-time conversion: The system fetches current exchange rates and calculates the exact amount based on the order total
  5. Exchange rates auto-refresh every 10 minutes to prevent price staleness
  6. Customer connects Phantom wallet and reviews the amount
  7. Customer clicks "Place Order" and approves the transaction in Phantom
  8. Transaction is sent to the Solana blockchain
  9. Automatic verification: The system verifies the transaction on-chain
  10. Order is completed and the customer receives confirmation

Admin Features

  • Order Management: View and manage crypto payments in the WooCommerce Orders dashboard
  • Transaction Hash: Each order includes the Solana transaction signature for verification
  • Token Type: Orders indicate whether payment was made in SOL or USDC
  • Order Notes: Automatic notes are added to orders with payment details
  • Refunds: Manual refunds can be processed (send crypto back to customer's wallet)

Technical Details

Exchange Rate System

InstantPay uses a robust exchange rate system powered by CoinGecko API:

  • SOL/USD & USDC/USD: Updated every 15 minutes
  • Fiat currencies: EUR, GBP, TRY, JPY, CAD updated every 30 minutes
  • Price staleness protection: Rates auto-refresh on checkout page every 10 minutes
  • Fallback mechanisms: Cached rates ensure availability during API downtime

Transaction Verification

Every payment is verified on-chain before order completion:

  • Transaction signature validation
  • Amount verification (ensures correct amount was sent)
  • Recipient address verification (ensures payment went to your wallet)
  • Token type verification (SOL or SPL Token)
  • Double-payment protection (prevents duplicate orders)

Supported Currencies

The gateway automatically converts from any WooCommerce currency to SOL or USDC. Supported: USD, EUR, GBP, TRY, JPY, CAD, and more.

Troubleshooting

"Pay with SOL or USDC" not appearing on checkout?

  • Ensure the InstantPay payment gateway is enabled in WooCommerce → Settings → Payments
  • Check that you've entered a valid Solana wallet address in the gateway settings
  • Verify WooCommerce is active and up-to-date
  • Clear your browser cache and reload the checkout page

Amount shows "Calculating..." forever?

  • Check your internet connection
  • Ensure the InstantPay exchange rate API is accessible
  • Check browser console for JavaScript errors
  • Try refreshing the page

Payment fails with "403 Forbidden" error?

  • The default Solana RPC may be rate-limited or blocked
  • Solution: Sign up for a free Helius RPC account
  • Enter your Helius RPC URL in the gateway settings
  • Save changes and test again

Order stuck in "Pending Payment" status?

  • Check if the transaction was confirmed on Solana blockchain (use Solana Explorer)
  • If confirmed, the transaction signature may not have been properly recorded
  • Check the order notes for transaction details
  • Manually verify and update the order status if needed

Best Practices

  • Use Helius RPC: For production sites, always use a reliable RPC provider like Helius to avoid rate limits
  • Test Mode First: Always test your checkout flow in test mode (Devnet) before going live
  • Clear Instructions: Add a note on your checkout page explaining how to use Phantom wallet
  • Monitor Orders: Regularly check your WooCommerce orders dashboard for any issues
  • Keep Plugin Updated: Update the InstantPay plugin when new versions are released
  • Backup Before Updates: Always backup your WordPress site before updating plugins

✅ Production Ready: The WooCommerce integration has been thoroughly tested and is ready for production use. Thousands of transactions can be processed securely and efficiently.

Getting Help

Need assistance with the WooCommerce integration?

Ready to Accept SOL & USDC on WooCommerce?

Download the InstantPay WordPress plugin (v1.1.0+) and enable crypto payments on your WooCommerce store today.

Download Plugin

Shopify Integration

Accept Solana (SOL) and USDC payments directly from your Shopify store's cart page. The InstantPay Shopify integration provides a seamless "Pay with Crypto" button that bypasses traditional checkout, enabling instant crypto payments with automatic order creation and fulfillment.

Overview

Unlike traditional Shopify payment gateways that require app approval and extensive setup, InstantPay's Shopify integration works through a simple theme snippet that you can install in minutes. Your customers can pay with SOL or USDC directly from the cart drawer without leaving your store.

⚡ Key Benefits: No app approval required • Works with any Shopify theme • Instant payments • Zero transaction fees • Full inventory management

Installation & Setup

Follow these steps to add crypto payments to your Shopify store:

Step 1: Connect Your Shopify Store

  1. Log in to your InstantPay dashboard at instantpay.now/dashboard
  2. Navigate to Dashboard → Integrations → Shopify
  3. Click the "Connect Shopify" button
  4. You'll be redirected to Shopify to authorize the connection
  5. Click "Install" to grant InstantPay access to your store
  6. You'll be redirected back to InstantPay with your store connected

Step 2: Configure Your Settings

After connecting, configure the following settings in the Shopify integration page:

  • Shop Domain: Your Shopify store URL (e.g., mystore.myshopify.com) - automatically filled
  • Wallet Address: Your Solana wallet address where payments will be received
  • Shop Currency: Your store's default currency (USD, EUR, GBP, etc.)
  • Default Shipping Cost: Fallback shipping cost if automatic calculation fails
  • Helius API Key: (Optional but recommended) Your Helius RPC API key for reliable transaction processing

Click "Save Shopify Settings" when done.

Step 3: Install Theme Snippet

  1. In the InstantPay Shopify integration page, click "View Snippet"
  2. Click "Download File" to download the instantpay-cart-button-FINAL.liquid file
  3. Go to your Shopify admin: Online Store → Themes → Edit code
  4. In the left sidebar, find and click on Snippets
  5. Click "Add a new snippet"
  6. Name it instantpay-cart-button and click "Create snippet"
  7. Open the downloaded file and copy all its contents
  8. Paste the contents into the new snippet in Shopify
  9. Click "Save"

Step 4: Add Button to Cart Drawer

Now we'll add the "Pay with Crypto" button to your cart drawer:

  1. In the Shopify theme editor, find Snippets → cart-drawer.liquid (or main-cart-drawer.liquid depending on your theme)
  2. Search for the checkout button code (usually contains checkout or button--primary)
  3. Right after the checkout button's closing tag, add this line:
{% render 'instantpay-cart-button' %}
  1. Click "Save"
  2. Your "Pay with Crypto (SOL/USDC)" button is now live!

💡 Pro Tip: If you can't find cart-drawer.liquid, look for cart-summary.liquid ormain-cart.liquid. The exact file name varies by theme.

How It Works

The InstantPay Shopify integration provides a smooth checkout experience:

  1. Customer adds products to cart and opens the cart drawer
  2. "Pay with Crypto (SOL/USDC)" button appears below the standard checkout button
  3. Customer clicks the button and a payment modal opens
  4. Customer enters shipping details (name, email, address)
  5. System calculates total including shipping and taxes automatically
  6. Customer chooses currency: SOL or USDC
  7. Real-time conversion: Shows exact crypto amount based on current exchange rates
  8. Customer connects Phantom wallet and reviews the transaction
  9. Customer approves payment in Phantom wallet
  10. Transaction is sent to Solana blockchain (~400ms confirmation)
  11. Automatic verification: System verifies transaction on-chain
  12. Order created in Shopify: Full order with customer details, line items, and transaction hash
  13. Inventory updated: Product quantities automatically adjusted
  14. Customer receives confirmation with order number and transaction details

Features

🔒 Secure Payments

  • All transactions verified on Solana blockchain
  • Merchant's Helius API key never exposed to customers
  • RPC proxy pattern for enhanced security
  • No sensitive data stored on frontend

📦 Automatic Order Management

  • Orders automatically created in Shopify admin
  • Customer details captured (name, email, shipping address)
  • Transaction hash saved for verification
  • Inventory automatically reduced
  • Order notes include payment method (SOL/USDC) and transaction signature

💰 Dual Currency Support

  • Accept both SOL and USDC payments
  • Real-time exchange rates from CoinGecko
  • Automatic conversion from any fiat currency
  • Price staleness protection (rates refresh every 10 minutes)

🚚 Smart Shipping Calculation

  • Automatic shipping cost calculation via Shopify Draft Orders API
  • Supports all Shopify shipping zones and rates
  • Tax calculation based on customer location
  • Fallback to default shipping cost if API fails

🎨 Theme Compatibility

  • Works with all Shopify themes (Dawn, Debut, Brooklyn, etc.)
  • Responsive design for mobile and desktop
  • Customizable button styling
  • Modal overlay with smooth animations

Technical Details

OAuth Integration

InstantPay uses Shopify's OAuth 2.0 flow for secure store connection:

  • One-click merchant connection
  • Encrypted access token storage (AES-256)
  • Scopes: read_orders, write_orders, read_products, write_draft_orders

RPC Proxy Architecture

For security, all Solana RPC calls go through InstantPay's proxy:

  • Frontend never accesses Helius API key directly
  • Proxy validates merchant and shop domain
  • Allowed methods: getLatestBlockhash, sendTransaction, getTransaction
  • Rate limiting and error handling

Transaction Verification

Every payment is verified before order creation:

  • On-chain transaction confirmation via Helius RPC
  • Amount verification (ensures correct amount was sent)
  • Recipient address verification (ensures payment went to merchant wallet)
  • Token type verification (SOL or USDC SPL token)
  • Double-payment protection via quote system

Shopify Admin API

InstantPay uses Shopify's Admin API (2024-01) for order management:

  • Draft Orders: For shipping calculation and tax estimation
  • Products API: For inventory validation
  • Orders API (GraphQL): For final order creation with full details
  • Automatic inventory reduction: Shopify handles stock management

Troubleshooting

"Pay with Crypto" button not appearing?

  • Verify you've saved the snippet as instantpay-cart-button.liquid
  • Check that you've added {% render 'instantpay-cart-button' %} to your cart drawer file
  • Clear your browser cache and reload the page
  • Check browser console for JavaScript errors

Modal appears but is not interactive?

  • This was a known issue in early versions - ensure you're using the latest snippet
  • Re-download the snippet from InstantPay dashboard
  • The latest version has z-index fixes and proper overlay handling

Payment fails with "Failed to get recent blockhash"?

  • You need to add a Helius API key in your Shopify integration settings
  • Sign up for a free account at helius.dev
  • Copy your API key and paste it in the InstantPay Shopify settings
  • Click "Save Shopify Settings"

Transaction confirmed but order not created?

  • Check your Shopify store's API permissions
  • Verify the access token is valid (try reconnecting your store)
  • Check Vercel logs for error messages
  • Transaction hash is saved - you can manually create the order if needed

Shipping cost shows as $0?

  • Ensure you've set up shipping zones in Shopify admin
  • Set a default shipping cost in InstantPay Shopify settings as fallback
  • Check that customer's address is within your shipping zones

Best Practices

  • Use Helius RPC: Always add your Helius API key for reliable transaction processing
  • Test First: Test the full checkout flow with a small amount before promoting to customers
  • Clear Instructions: Add a banner or note explaining crypto payment option to customers
  • Monitor Orders: Regularly check your Shopify orders dashboard for crypto payments
  • Keep Snippet Updated: Check InstantPay dashboard for snippet updates and improvements
  • Set Realistic Shipping: Configure accurate shipping zones and rates in Shopify
  • Customer Support: Be ready to help customers who are new to crypto payments

Limitations & Future Improvements

Current version (v0.6) has the following characteristics:

  • Manual Installation: Requires theme code editing (future: Shopify App Store listing)
  • Cart Drawer Only: Button appears in cart drawer, not in standard checkout flow
  • No Refunds UI: Refunds must be processed manually by sending crypto back to customer
  • Single Wallet: One wallet address per store (future: multi-wallet support)

🚀 Coming in v0.7: Shopify App Store listing • Checkout UI Extensions • Advanced analytics • Refund management • Multi-currency wallet support

✅ Production Ready: The Shopify integration is fully functional and has been tested with real transactions. Hundreds of merchants are already using it to accept crypto payments.

Getting Help

Need assistance with the Shopify integration?

  • Check the Support page for common questions
  • Review the Blog for technical guides and updates
  • Join our Discord community for real-time support

Ready to Accept Crypto on Shopify?

Connect your Shopify store to InstantPay and start accepting SOL & USDC payments today.

Connect Shopify Store

Need Help?

Our support team is available 24/7 to assist you.

Contact Support