APIS & WEBHOOKS
Build USDC payments into your product with an API
Create payments, connect order references, receive webhook updates, and reconcile onchain transactions with SoloPay payment APIs.
Why SoloPay
A simpler crypto payment gateway
USDC payment API
Replace manual wallet-transfer matching with payment IDs, status updates, and programmable operations.
curl -X POST https://gateway.dev.solonetwork.io/api/v1/payments \
-H "x-public-key: pk_xxxxx" \
-H "Content-Type: application/json" \
-d '{"orderId":"order-001","amount":25,"currency":"USD","tokenAddress":"0x...","successUrl":"https://shop.example/success","failUrl":"https://shop.example/fail"}'What the product actually supports
The payment API creates a five-minute payment intent, returns contract and token details, and exposes status fields for server-side order verification.
- POST /api/v1/payments requires an x-public-key and unique orderId.
- Token address must be whitelisted and enabled for the merchant.
- Optional currency triggers conversion using the latest one-hour TWAP.
- Webhook events currently include payment.paid and payment.invalid with HMAC signing support.
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
Build USDC payments into your product with an API
Build USDC payments into your product with an API
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.