The stablecoin checkout API for gift cards, mobile top-ups and eSIMs
Use stablecoins like USDC and USDT on fast chains like Solana, Base to move from quote to delivery in a single deterministic flow. Issue inventory at checkout time instead of pre-buying stock, so your working capital stays flexible.
Quick-start
How it works
Take a user from discovery to delivered gift card.
- 01
Search
Browse brands and products available in the user’s country.
- 02
Quote
Get the exact crypto amount for a denomination, coin, and network.
- 03
Pay
Create the order and receive a wallet address and coin amount.
- 04
Deliver
Stream or poll the order until it is Done, then return the code.
Why it works for builders
Clean REST endpoints or MCP
Search, price, validate, and create orders through clean REST endpoints or connect via MCP for AI agent workflows.
15+ coins across major networks
Supports 15+ coins across Solana, Base, Arbitrum, Polygon, Lightning, and more.
6,600+ brands, 180+ countries
Global catalog with no KYC required for your users.
Real-time order tracking
Streaming status updates from payment to delivery, with polling fallback.
Start building today, you only pay per successful order.
Pay with your preferred coin
Every gift card, top-up, and eSIM in our catalog can be purchased with the coins and networks below.
Coins
Networks
Cashflow efficient
Issue inventory at checkout time instead of pre-buying stock. Keep working capital available for growth.
Fast settlement UX
Stablecoin rails plus stream updates reduce waiting friction from payment to delivery.
Web3 user-agent fit
Natural for wallets, mini apps, and agentic checkout flows where users already hold stablecoins.
Operational control
Check the order before creating it, track each status clearly, and switch to polling if streaming is not available.
Delivery and disclosure requirements
To maintain quality during API implementation, please note the following.
Valid end-user email is required
Cryptorefills delivers product information to the user. Invalid email means failed delivery experience.
Cryptorefills handles delivery
Cryptorefills is responsible for product delivery at all times in this flow.
Service disclosure to users
Your UX should clearly communicate that the user is making use of Cryptorefills service.
Customer support from Cryptorefills
Cryptorefills is available to support customers with questions related to the products they ordered.
Power your platform with a stablecoin offramp via Cryptorefills. Join integrated partners enabling real-world crypto spending through a single API.
Spend crypto on real-world products directly from the World App ecosystem.
Visit World
The world’s largest exchange, connecting millions of users to Cryptorefills checkout.
Visit Binance
Gaming-native platform bringing player earnings into everyday spending.
Visit MineX
Kraken’s consumer app, turning held crypto into real-world purchases.
Visit Krak
KuCoin Pay users can now unlock global travel and everyday spending with crypto.
Visit KuCoinBuilt for AI agents
Skills, MCP, and x402 give agents the tools to quote, validate, and buy gift cards, eSIMs, and top-ups autonomously, with stablecoins.Connect your AI agent to 6600+ products across 180+ countries.
No KYC. No credit cards.
ChatGPTFrequently asked questions
The most common questions from partners integrating with the Cryptorefills API. For full technical details, see our API documentation.
- Crypto is sent directly to Cryptorefills. We generate a unique wallet address for each order and collect payment directly. Partners never hold customer funds, payment goes straight to us. There's no prepaid balance required; you pay per order.
- We don't have a dedicated sandbox environment. We recommend testing with low-value real products to keep testing costs minimal, Free Fire top-ups are a good option, available for under $1.
- We support multiple blockchain networks for USDT, USDC, BTC, ETH and other major crypto. For the full and up-to-date list, see our API documentation.
- You can build a fully customized native UI using our REST API. This is the recommended approach for a seamless experience. There's no major functional difference between using our hosted checkout (whitelabel) and a custom UI built on the API, with one exception: the loyalty points system is only available on cryptorefills.com directly, not via the API.
- Yes. The public endpoint (/v5/orders) lets you start integrating immediately with no approval required, useful for testing and early development. Commission tracking is only available through the whitelabel endpoint (/v6/partner/orders), which requires a partner account. All partners use the same API; each partner is identified by their own unique key.
- A Partner ID (referral code) is generated automatically when you create an account at cryptorefills.com, no approval needed. You'll find it under your account settings.
- Once you're ready to start earning commission, reach out to our partnerships team. We'll set up your whitelabel account, after which you'll find a dedicated "Whitelabel" section in your account with your API key and full integration instructions.
- Yes. Webhooks are available for order status events. See the API documentation for the full list of supported events.
- Codes are delivered instantly in the API response. An email containing the code is also sent to the end user, as required for product delivery compliance.
- Yes. The Cryptorefills logo must be displayed at the points in the purchase flow we specify, and a "Powered by Cryptorefills" label is required. End users must be informed they are purchasing from Cryptorefills before completing checkout.
- Cryptorefills is the Merchant of Record for all transactions processed through the platform.
- Cryptorefills handles transaction monitoring and AML compliance on all orders. When KYC is required for a specific transaction, we return a redirect link so you can send the end user through our verification flow.
- Yes. Some products have country-level restrictions enforced automatically at the catalog level, you don't need to filter these yourself. Certain legal entity types are not eligible for partnership agreements; reach out to our team if you have questions about your specific case.
- Commission is a percentage of gross margin on each completed sale. Gross margin varies by brand and product category.
- Commission accrues monthly. A transaction report is issued within 5 business days after each calendar month, showing sales, refunds, gross margin, and accrued commission. Once your accrued balance reaches €200, you invoice us and we pay within 7 business days.
- No minimum volume is required to get started.
- No. Commission is not earned on orders that are refunded, cancelled, or voided.
- Common causes include temporary supplier stock issues (we automatically attempt fallback suppliers where available) or a payment network mismatch. Our support team investigates and resolves all delivery issues.
- No. We don't operate a wholesale or bulk-purchase model with discounted resale pricing. Our only partnership structure is API-based, with revenue share as described above.
- We don't currently offer a dedicated affiliate program for content and editorial sites. Non-technical partners can still use a standard referral link (cryptorefills.com/?ref=YOUR_PARTNER_ID), which earns loyalty points on the referring account.
- We're continuously expanding our catalog. Reach out to our partnerships team for the latest roadmap updates relevant to your integration.
Payment & settlement
Integration
Branding & compliance
Commission & earnings
Orders & delivery
Other partnership models
Roadmap
Have a question not answered here? Contact our partnerships team at info@cryptorefills.com or through our API documentation.