EMBEDDED CHECKOUT
Add a USDC payment widget to your website
Embed a wallet-connected USDC checkout in your existing website and keep customers inside your purchase flow.
Why SoloPay
A simpler crypto payment gateway
USDC payment widget
Launch a consistent payment UI without rebuilding your storefront or sending customers through a manual transfer flow.
const soloPay = new SoloPay({ publicKey: 'pk_live_xxx' });
soloPay.requestPayment({
orderId: 'order-123',
amount: '10',
tokenAddress: '0x...',
successUrl: 'https://shop.example/success',
failUrl: 'https://shop.example/fail'
});What the product actually supports
SoloPay provides a framework-agnostic JavaScript SDK, a React hook, and a CDN bundle. The widget handles payment creation, wallet connection, signing, approval, and processing.
- Desktop opens a popup; mobile redirects to a full-screen hosted widget.
- successUrl and failUrl receive paymentId, orderId, and result parameters.
- Callback URL parameters must not be trusted without API verification.
- The React hook cleans up its widget instance on unmount.
How it works
From wallet connection to confirmed payment
Create the payment
Set the amount, asset, merchant wallet, and optional order reference.
Customer confirms
The customer connects their own wallet and approves the payment.
Track the result
SoloPay links payment status and the public onchain transaction to your order.
Common use cases
Add a USDC payment widget to your website
Add a USDC payment widget to your website
SoloPay does not add a separate identity review or payout-approval step for supported payment gateway flows. Verification required by a wallet, exchange, merchant policy, industry, or applicable law may still apply.
No. Wallet addresses and transactions remain visible on public blockchains. A No-KYC payment gateway does not mean anonymous, untraceable, or exempt from applicable obligations.
No. SoloPay payment gateway scope is separate from any customer-verification, contractual, tax, delivery, medical, AML, or other legal duties that may apply to the merchant.
For supported gasless payment flows, SoloPay sponsors the gas fee. Token- and network-specific requirements still apply and should be confirmed for the relevant checkout.
Funds are sent to the merchant-designated wallet rather than being held by SoloPay for a later withdrawal.
USDC is the default payment asset, but SoloPay is multi-token. Other supported tokens can be enabled per merchant, network, and payment configuration.
Ready to accept crypto payments?
Talk to us about the right payment flow for your business.