XPayr FAQ Database

How do I start accepting crypto with XPayr?

Create a merchant account, add a payout wallet, choose network and token, then publish your payment link, widget, or button.

Can I test before going live?

Yes. Use testnet flows to validate checkout, wallet connection, and invoice behavior before production.

Do I need coding skills to start?

No. You can launch with no code tools from merchant dashboard and use API only when you need advanced integrations.

How long does setup usually take?

Most merchants publish their first crypto checkout flow in minutes.

What is the difference between payment links and donation links?

Payment links are fixed checkout flows. Donation links are support focused flows for community contributions.

Can one link receive multiple payments?

Yes. Reusable links can collect multiple payments over time based on your campaign flow.

When should I use widget, button, or direct link?

Use widget for embedded checkout, button for branded call to action, and direct link for fast sharing in chats or social.

Can customer enter a custom amount?

Yes. You can allow custom amounts or keep fixed amounts depending on the flow you configure.

Which wallets does XPayr support?

XPayr supports EIP compatible browser wallets and modern wallet connection flows.

Why do I see Wallet not registered for this network?

The selected wallet is not registered for that chain in your merchant settings. Add and register it for the selected network.

Can I switch wallet after connecting?

Yes. Disconnect the current wallet and reconnect with the address you want to use before creating or confirming payment.

How do I add payout wallets correctly?

Open payout wallets in merchant panel, select network, paste wallet address, and save after validation.

What fee does XPayr charge?

XPayr applies a transparent 0.5 percent gateway fee. Network gas fees are blockchain costs and vary by chain state.

Who pays gas fees?

Gas costs are paid on chain by the transaction sender according to network conditions and selected token flow.

How fast do funds settle?

After on chain confirmation, funds move directly into your configured wallet flow.

Are there hidden fees?

No hidden gateway fees. You see platform fee and network costs clearly in the flow.

How does XPayr improve account security?

Use 2FA, whitelist controls, and webhook signature validation to secure account and payout operations.

Does White Label remove Powered by XPayr?

No. Core trust branding remains visible while your brand elements are shown in checkout header.

How does IP whitelist help?

It restricts sensitive actions to approved IP addresses and reduces unauthorized admin actions.

Can I enforce payout wallet whitelist only mode?

Yes. Enable whitelist enforcement to allow payouts only to approved wallet and currency pairs.

How do I verify webhook events?

Validate the signature header with your webhook secret before processing payload data.

What is API key and secret key difference?

API key identifies integration context. Secret key authorizes protected server side API requests.

Which statuses can webhook send?

Common statuses include pending, confirmed, failed, and expired with related update events.

How do I avoid duplicate event processing?

Use idempotency in your backend and store processed event identifiers before applying business updates.

Why do I get Transaction reverted by EVM?

This usually means network mismatch, token mismatch, missing wallet registration, or contract validation rejection.

Why is invoice detail not loading?

Verify invoice belongs to your merchant account and session data exists in current environment.

Why does Session expired appear?

The session reached its time limit or was already finalized by a completed flow.

Why is Connect wallet button not working?

Check wallet extension is installed, unlocked, on correct chain, and popups are not blocked by browser settings.

Can my team use one merchant account?

Yes. Teams can share operational workflows while payment controls remain centralized.

How do I recover account access?

Use forgot password flow and recovery steps, then update security settings after access is restored.

Where can I manage API keys?

Open API Keys in merchant panel to create, rotate, and revoke credentials.

Can admins see site during maintenance mode?

Yes. Admin users can bypass maintenance page while public visitors still see maintenance screen.