On this page
Getting started
New to Eppay? These three steps cover what every merchant needs before accepting their first crypto payment.
1. Create your account and verify your email
Sign up at eppay.io with email or social login (Google, Facebook). Verify the address that arrives in your inbox so we can send you payment notifications and security alerts.
2. Add a destination wallet address
Open Settings and paste a wallet address you control on each blockchain you plan to accept payments on. Eppay never holds funds — every payment settles directly to the address you set.
3. Generate an API key or create a payment link
For one-off invoices, create a Product and share the hosted payment link. For checkout integrations, generate an API key under the API tab and call POST /api/v2/create-payment to mint links programmatically.
Payments & confirmations
Eppay processes USDT and USDC stablecoin payments across the networks below. Each chain has different confirmation speeds and fee profiles.
Supported networks
Ethereum, Binance Smart Chain (BSC), Polygon, Arbitrum, Avalanche, Fantom, Cronos, Celo, and Cosmos. We continue to add chains based on merchant demand — let us know which network you need.
Supported tokens
USDT (Tether) and USDC (USD Coin) on each supported chain. Both are USD-pegged stablecoins, so the amount your customer sends matches the price you displayed at checkout.
How long do confirmations take?
Confirmation time depends on the chain. On BSC, Polygon and Arbitrum, payments usually finalize in well under a minute. On Ethereum mainnet, expect roughly 1–3 minutes during normal network conditions, longer when fees spike. Eppay marks the payment "completed" as soon as the on-chain transaction reaches the required confirmation depth.
Who pays the network fee?
The customer pays the gas fee on the chain they choose. Eppay does not take a fee from the payment itself beyond the platform fee disclosed in your account dashboard.
What if a customer underpays?
If a customer sends less than the requested amount, the payment is recorded as partial and the link remains open until the remaining balance arrives or the link expires. Refunds for partial payments are handled directly between you and the customer; Eppay does not hold the funds.
API & integrations
Eppay offers a REST API, a Shopify app, and a JavaScript SDK for embedding checkout into any web stack.
Where do I get my API key?
Log in, open the API tab from the dashboard, and click Create API Key. Each key is scoped to your account and you can revoke and rotate keys at any time. Treat API keys like passwords and store them server-side only.
Should I use API v1 or v2?
Use v2 for all new integrations. The v2 endpoints (POST /api/v2/create-payment, GET /api/v2/payments/{id}/status) are the supported standard. v1 endpoints still respond for legacy callers but should not be used for new work.
Do you support webhooks?
Yes. Configure a webhook URL in your account and Eppay will POST a signed JSON payload when a payment status changes. Verify the signature header on your end before trusting the event.
How does the Shopify integration work?
Install the Eppay app from the Shopify App Store, connect it to your Eppay account, and crypto becomes a checkout option for your customers. Payments settle to the wallet you configured in Eppay; orders are marked paid in Shopify automatically once the on-chain transaction confirms.
Account & security
A few common account questions:
I forgot my password
Use the "Forgot password" link on the login page. We will email a reset link valid for 60 minutes. If the email does not arrive, check spam and confirm the address you signed up with.
How do I enable two-factor authentication?
Open your profile settings and follow the 2FA setup wizard. We recommend enabling 2FA before adding wallet addresses or generating API keys.
Can I change my wallet address?
Yes. Update the address in Settings at any time. Future payments route to the new address. Payments already in flight settle to the address that was active when the payment link was created.
Troubleshooting
The five issues we see most often, and how to resolve them:
My payment is stuck on "pending"
Pending means the transaction has been broadcast but has not reached the required confirmation depth on the chain. Look up the transaction hash on a block explorer (etherscan.io for Ethereum, bscscan.com for BSC, polygonscan.com for Polygon, etc.) to confirm it is mined. If it shows as confirmed on-chain but still pending in Eppay after 10 minutes, contact us with the transaction hash.
A customer paid on the wrong chain
If you receive a payment on a chain you control with the same wallet address (most EVM chains share an address format), the funds are recoverable from that chain. If the customer sent to a chain you do not have keys for, the funds are unfortunately not recoverable through Eppay.
My API key returns 401 Unauthorized
Check that you are passing the key in the Authorization header as a Bearer token, that the key has not been revoked in your dashboard, and that you are calling the correct environment. Regenerate the key as a last resort.
The amount displayed does not match what was sent
Eppay quotes amounts in stablecoins (USDT or USDC), so 1 USDT in equals 1 USDT out — there is no FX conversion. If your customer sent a different token (e.g., ETH instead of USDT) the payment will not match. Decimal precision differs by chain; we display six decimal places by default.
My webhook never fires
Confirm the URL is publicly reachable (no localhost or VPN-only hosts), responds with HTTP 2xx within 5 seconds, and that no firewall is blocking our IPs. We retry failed deliveries with exponential backoff for up to 24 hours.
Response times
We aim to reply to every email within one business day (Monday–Friday). Urgent payment-blocking issues are prioritized. For business hours we operate on Central European Time, but the team is distributed and will often respond outside those hours.
To get a faster answer, please include in your first email: your account email, the payment ID or transaction hash if relevant, the network, and a screenshot or error message.
Business & partnership inquiries
For partnerships, integrations at scale, custom payout terms, or media inquiries, write to info@eppay.io with "Partnership" in the subject line and a brief description of what you are building. We reply to every legitimate inquiry within two business days.
Looking for technical docs?
Our developer documentation covers the full API reference, webhook payloads, SDK usage, and code samples in multiple languages.
Open the documentation →