Questions that decide payment adoption

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.

Can customers pay directly from crypto exchanges or without connecting a Web3 wallet?

Yes. XPayr features Dual Checkout Mode: Web3 1-Click Pay for direct browser wallet transactions, and Direct Transfer / QR for customers paying from centralized exchanges (Binance, Bybit, OKX, etc.) or mobile wallets. Customers can simply scan the QR code or copy the recipient address, transfer the funds, and enter their Transaction Hash (TxID) or let the on-chain explorer auto-detect the payment. Network fee underpayment tolerance (1%, max $0.50) is built-in.

How do Multi-Chain payment links and multi-chain donations work?

When creating a payment link or donation page, merchants can choose "All Networks (Customer chooses on checkout)". Instead of locking the payer into a single blockchain or coin, the hosted checkout presents a clean network selector. The customer can pay using EVM (Ethereum, BSC, Polygon, Arbitrum, Avalanche), TRON USDT, or Solana, and the system automatically loads the correct routing, contract parameters, and recipient wallet.

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.

Can payment links be created with automated invoice email push via API and dashboard?

Yes. When creating a session via POST /payments or the merchant portal, set send_invoice_email to true and provide customer_email. XPayr immediately delivers a responsive, branded HTML email invoice with payment details, line items, and a 1-click checkout button. Webhooks fire upon invoice viewing and completion.

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.

How does the XPayr Partner & Affiliate program work?

XPayr offers a hybrid multi-tier partner infrastructure supporting both Web2 corporate affiliate tracking (via Impact.com S2S) and Web3 direct smart contract settlement.

When you refer a developer, agency, or online merchant to XPayr, you earn recurring revenue shares from gateway processing fees or CPA bonuses per activated merchant.

How does Impact.com tracking and referral link attribution work?

When a visitor clicks your affiliate link with an 'irclickid' parameter, XPayr saves the unique click identifier in a secure, first-party cookie for 30 days.

When the referred user registers, buys a license, or accepts payment, XPayr executes a Server-to-Server (S2S) postback directly to the Impact.com REST API. This guarantees 100% accurate tracking immune to ad-blockers and browser privacy filters.

What are the available payout models: 30% RevShare vs $50 CPA?

You can choose between two lucrative reward tracks:

1. 30% Recurring Revenue Share: Earn 30% of XPayr's 0.5% gateway fee for every transaction processed by your referred merchants, lifetime.
2. $50 Activation CPA: Earn a flat $50 bounty as soon as your referred merchant integrates XPayr and completes their first $100 in volume.

How do I claim on-chain referral rewards directly to my Web3 wallet?

In your Merchant Dashboard (/merchant/affiliate), connect your EVM or Solana wallet.

The smart contract automatically calculates and allocates your 30% commission per settlement. Click the 'Claim' button at any time to withdraw USDT, USDC, SOL, or native tokens directly with zero admin delays.

Where can I find official badges and affiliate banners?

Visit the XPayr Brand Assets Studio at /brand-assets.

You can generate custom dynamic SVG badges (Verified Merchant, Powered by XPayr, Official Partner) and copy 1-click embed codes for standard banner sizes (728x90 Leaderboard, 300x250 Medium Rectangle, 1200x630 Social Card).

Are self-referrals, multiple accounts, or testnet transactions rewarded?

No. XPayr strictly isolates production and testnet transactions.

Self-referrals (using the same payout address or merchant wallet), artificial wash volume, and testnet transactions are strictly excluded by automated anti-fraud checks.