Available balance
$0
USD credits available
Total orders
—
all time
Last 30 days
—
spend
Recent eSIMs
Available balance
$0
USD credits
Lifetime spend
—
total orders
Pending
—
in-flight orders
Avg order
—
last 30 days
Top up balance
Add credit instantly via Stripe
Loading…
Payments processed by Stripe. Credit appears in your balance within seconds of payment confirmation. All major cards accepted. Stripe security.
How balance works
Balance is your prepaid credit pool.
Each eSIM order debits credits from your balance. Cancellations on unused eSIMs refund automatically. Topups to existing eSIMs also debit balance.
Recent transactions
Loading…
Loading…
Loading…
Destinations
Loading…
◐
Pick a destination
Choose a country or region to see available plans.
Manage eSIMs
Loading…
◇
Select an eSIM to manage
Click any eSIM in the list to see full live details — plan, data usage, install QR — and to suspend, top up, refresh, or cancel it.
Looking for a specific customer's eSIM? Paste their ICCID into the search box and press Enter to pull it live from the provider — even if it's an older eSIM.
Lookup by ICCID
Find any eSIM directly
18–22 digit identifier. Found on the eSIM detail screen. Stuck on a customer issue? WhatsApp our team →
Loading…
Loading…
Branding
Logo, colors, and visual identity for your storefront
Loading…
About & content
What customers see on your storefront
Loading…
Home page
Hero background and the 5 featured destinations on your home page
Loading…
Pricing
Set the markup customers see at checkout
Loading…
Customers & orders
Manage everyone who has bought from your storefront
Total customers
—
all time
Lifetime revenue
—
net of refunds
Active eSIMs
—
currently provisioned
Total orders
—
paid + fulfilled
Loading…
Storefront orders
Customer purchases at your storefront
Loading…
Domains
Where customers reach your store
Loading…
Email
How customer emails are sent on your behalf
Loading…
Discount codes
Create codes your customers can redeem at checkout
Loading…
Loading…
Loading…
Loading…
Loading…
Loading…
Country hero photos
Custom photos shown on your storefront's country grid
Loading…
Checking system status…
Running diagnostic checks against all subsystems
Loading…
Endpoint reachability
Try each public endpoint with your API key
Click "Run checks" above to test all endpoints
Endpoint
Where we send events
Must be HTTPS. Public hostname — no localhost or private IPs.
When disabled, no events are sent. Useful for maintenance.
Signing secret
For HMAC verification
Rotating immediately invalidates the previous secret. The new secret is shown only once — save it.
Recent deliveries
Event types
order.fulfilled
eSIM allocated, ready to install
esim.installed
Customer activated on device
esim.in_use
eSIM is connected and using data
esim.data_threshold
50% / 80% / 90% data usage
esim.expiring_soon
Validity warning
esim.expired / cancelled
Lifecycle endings
Verifying signatures
// Each webhook POST includes:
// X-YFiNet-Signature: sha256=<hex_hmac>
// X-YFiNet-Timestamp: <unix_seconds>
// X-YFiNet-Event: order.fulfilled
// X-YFiNet-Delivery-Id: <uuid>
const crypto = require('crypto');
const expected = 'sha256=' + crypto
.createHmac('sha256', YOUR_WEBHOOK_SECRET)
.update(timestamp + '.' + rawBody)
.digest('hex');
if (signature !== expected) reject('invalid signature');
if (Math.abs(now - timestamp) > 300) reject('replay');
API keys
Live keys make real charges. Test keys for sandboxed development.
Loading…
Authentication
curl https://esimyfi.live/v1/balance \
-H "Authorization: Bearer yf_live_YOUR_KEY"
Use
yf_live_… for production and yf_test_… for development. Test mode never charges customers, never provisions real eSIMs.Best practices
- — Store keys in environment variables, never in source code
- — Don't share keys in chat, email, or screenshots
- — Rotate immediately if you suspect a key has leaked
- — Each API request is logged with the key prefix for audit
API documentation
Endpoint reference