Часто задаваемые вопросы

Ключевые вопросы при выборе платежного решения

Четкие ответы для команд, сравнивающих решения для крипто-чекаута, расчетов, массовых выплат и спонсирования газа.

Проверено редакцией со ссылками на документацию продукта, API и политики. О нас · Документация API · Политика AML/KYC · llms.txt

Начиная

Создайте торговую учетную запись, добавьте кошелек для выплат, выберите сеть и токен, затем опубликуйте ссылку, виджет или кнопку для оплаты.
When you create a payment session using a test API key (sk_test_...) on any testnet network, both the hosted checkout page (/test/{session_id}) and the REST API (POST /api/v1/payments/{id}/simulate) allow you to trigger instant simulated outcomes—Completed, Underpaid, Expired, or Failed—without needing testnet faucet tokens. Each simulation generates realistic ledger records and dispatches a signed webhook event to your callback URL.
Да. Используйте потоки тестовой сети для проверки оформления заказа, подключения к кошельку и поведения счетов перед началом производства.
Нет. Вы можете запустить инструменты без кода с панели управления продавца и использовать API только тогда, когда вам нужны расширенные интеграции.
Большинство продавцов публикуют свою первую процедуру оплаты криптовалютой за считанные минуты.

Платежи и пожертвования

Платежные ссылки представляют собой фиксированные потоки оформления заказа. Ссылки для пожертвований — это потоки, ориентированные на поддержку сообщества.
Да. Каждая завершенная платежная сессия включает мгновенный генератор квитанций PDF-1.4 (/public/receipt.php?session_id={id}&download=1) и печатную HTML-версию. В квитанции указываются ID счета, ID сессии, название мерчанта, валовая сумма, комиссия шлюза XPayr, чистая сумма расчета, токен, сеть, адреса кошельков отправителя и получателя, метка времени UTC и хеш ончейн-транзакции.
Да. Многоразовые ссылки могут собирать несколько платежей с течением времени в зависимости от хода вашей кампании.
Используйте виджет для встроенной оформления заказа, кнопку для фирменного призыва к действию и прямую ссылку для быстрого обмена информацией в чатах или социальных сетях.
Да. Вы можете разрешить настраиваемые суммы или оставить фиксированные суммы в зависимости от настроенного вами потока.
Да. XPayr поддерживает двойной режим оплаты (Двойной чекаут): Web3-оплата в 1 клик для браузерных кошельков и Прямой перевод / QR для клиентов, переводящих средства с централизованных бирж (Binance, Bybit, OKX и др.) или мобильных кошельков. Клиенты могут просто отсканировать QR-код или скопировать адрес, отправить средства и ввести хэш транзакции (TxID) либо дождаться автоматического подтверждения блокчейн-эксплорером. Встроена толерантность к комиссиям бирж за вывод в размере 1% (макс. $0.50).
При создании ссылки на оплату или страницы пожертвований мерчанты могут выбрать опцию "Все сети (клиент выбирает при оплате)". Вместо привязки к одной цепочке на странице чекаута отображается удобный селектор сетей. Клиент может оплатить через EVM (Ethereum, BSC, Polygon, Arbitrum, Avalanche), TRON USDT или Solana, а система автоматически загрузит нужный маршрут, смарт-контракт и кошелек получателя.

Кошелек и сети

XPayr поддерживает EIP-совместимые браузерные кошельки и современные потоки подключения к кошельку.
Выбранный кошелек не зарегистрирован для этой цепочки в настройках вашего продавца. Добавьте и зарегистрируйте его для выбранной сети.
Да. Отключите текущий кошелек и повторно подключитесь к нему, используя адрес, который вы хотите использовать, прежде чем создавать или подтверждать платеж.
Откройте кошельки выплат на панели продавца, выберите сеть, вставьте адрес кошелька и сохраните после проверки.

Сборы и расчеты

XPayr взимает прозрачную комиссию за шлюз в размере 0,5 процента. Плата за сетевой газ представляет собой стоимость блокчейна и зависит от состояния сети.
XPayr начинает с прозрачной комиссии шлюза 0.50% (50 bps) на бесплатном тарифе Starter ($0/мес). Мерчанты могут перейти на Growth Pro ($49/мес с базовой ставкой 0.30% / 30 bps) или Enterprise Scale ($199/мес с базовой ставкой 0.15% / 15 bps). Кроме того, XPayr автоматически рассчитывает ваш завершенный оборот в мейннете в USD за скользящие 30 дней и применяет скидку за уровень объема: Bronze ($0+ = 0 bps), Silver ($10,000+ = -5 bps), Gold ($50,000+ = -10 bps) и Diamond ($250,000+ = -15 bps), снижая эффективную комиссию шлюза вплоть до минимального порога 0.05% (5 bps).
Затраты на газ оплачиваются отправителем транзакции в цепочке в соответствии с условиями сети и выбранным потоком токенов.
После подтверждения цепочки средства переходят непосредственно в настроенный поток вашего кошелька.
Никаких скрытых комиссий за шлюз. Вы четко видите плату за платформу и сетевые расходы.

Безопасность и соответствие требованиям

Используйте 2FA, элементы управления белыми списками и проверку подписи веб-перехватчика для защиты учетной записи и операций выплат.
Нет. Брендинг основного доверия остается видимым, пока элементы вашего бренда отображаются в заголовке оформления заказа.
Он ограничивает конфиденциальные действия утвержденными IP-адресами и уменьшает количество несанкционированных действий администратора.
Да. Включите использование белого списка, чтобы разрешить выплаты только на утвержденные пары кошелька и валюты.

API и вебхуки

Перед обработкой полезных данных проверьте заголовок подписи с помощью секрета веб-перехватчика.
Yes. Merchants can generate a dedicated HMAC secret in the API Keys dashboard and send X-Signature and X-Timestamp headers (with a 300-second anti-replay window) on API requests. When creating a payment session via POST /api/v1/payments, you can also pass ipn_url (or ipn_callback_url) to route webhooks dynamically per store/order, and allow_payment_methods (["web3", "direct", "gasless"]) to control which checkout tabs are shown to the buyer.
Ключ API идентифицирует контекст интеграции. Секретный ключ разрешает защищенные запросы API на стороне сервера.
Общие статусы включают ожидание, подтверждение, сбой и срок действия с соответствующими событиями обновления.
Используйте идемпотентность в своей серверной части и сохраняйте идентификаторы обработанных событий перед применением бизнес-обновлений.
Да. При создании сессии через POST /payments или панель управления укажите send_invoice_email: true и передайте customer_email. XPayr мгновенно доставит клиенту адаптивный брендированный HTML-счет с деталями платежа и кнопкой оплаты в один клик. После завершения платежа на ваш вебхук поступит мгновенное уведомление.

Поиск неисправностей

Обычно это означает несоответствие сети, несоответствие токенов, отсутствие регистрации кошелька или отказ в проверке контракта.
Убедитесь, что счет принадлежит вашей учетной записи продавца и данные сеанса существуют в текущей среде.
Сеанс достиг лимита времени или уже завершен завершенным потоком.
Убедитесь, что расширение кошелька установлено, разблокировано, в правильной цепочке и всплывающие окна не заблокированы настройками браузера.

Аккаунт и команда

Да. Команды могут совместно использовать рабочие процессы, при этом контроль платежей остается централизованным.
Используйте процедуру восстановления забытого пароля и действия по восстановлению, а затем обновите настройки безопасности после восстановления доступа.
Откройте ключи API на панели продавца, чтобы создавать, менять и отзывать учетные данные.
Да. Пользователи с правами администратора могут пропустить страницу обслуживания, в то время как общедоступные посетители все еще видят экран обслуживания.

Партнерская программа и рефералы

XPayr предлагает гибридную партнерскую инфраструктуру, поддерживающую как корпоративный трекинг Web2 (через Impact.com S2S), так и прямые выплаты через смарт-контракты Web3.

Приглашая продавцов или разработчиков, вы получаете 30% постоянного дохода от комиссий шлюза или $50 CPA за каждого активированного продавца.
Когда посетитель переходит по вашей ссылке, XPayr сохраняет идентификатор клика на 30 дней.

При регистрации или покупке XPayr отправляет запрос Server-to-Server (S2S) в Impact.com, обеспечивая 100% точность учета без потерь от блокировщиков рекламы.
Вы можете выбрать одну из двух моделей:

1. 30% постоянный RevShare: Получайте 30% от комиссии 0.5% XPayr со всех транзакций пожизненно.
2. $50 CPA за активацию: Получите $50 сразу после того, как приглашенный продавец проведет первые $100 объема.
Подключите свой кошелек в панели управления (/merchant/affiliate).

Смарт-контракт автоматически начисляет ваши 30% комиссии. Нажмите кнопку 'Claim', чтобы вывести USDT, USDC или SOL прямо на свой кошелек без задержек.
Посетите студию Фирменный стиль по адресу /brand-assets.

Вы можете создать динамические SVG-значки и скопировать готовые HTML-коды баннеров (728x90, 300x250, 1200x630).
Нет. Саморефералы, искусственный объем и транзакции в тестовых сетях строго блокируются автоматической системой защиты от мошенничества.

Как XPayr подтверждает достоверность заявлений о платежах и продукте?

XPayr связывает публичные утверждения с документацией продукта, политиками и правилами управления, чтобы мерчанты и ИИ-системы могли быстро проверять факты.