Логотип Inqud
Inqud Sandbox and Production environments separated by an isolation wall
Иконка колбыРежим Sandbox

Inqud Sandbox

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

Кабинет мерчанта Inqud Sandbox с тестовым балансом

Что такое Inqud Sandbox?

Inqud Sandbox — это изолированная тестовая среда для криптоплатежей для команд, которые интегрируют Inqud в свой продукт. Она работает как песочница платёжного шлюза: вы создаёте платежи, отправляете выплаты и получаете вебхуки, не затрагивая рабочую платформу и реальные средства.

У Sandbox свои URL-адреса, аккаунты, API-токены и балансы. У каждого URL рабочей среды есть версия Sandbox на домене sandbox.inqud.com.

Команды используют Sandbox, чтобы разрабатывать и отлаживать интеграции, тестировать обработку статусов платежей и показывать демо продукта без финансовых рисков.

  • API
  • Кабинет мерчанта
  • Готовая платёжная страница
  • On-ramp
  • Регулярные платежи
Почему Sandbox

Зачем сначала тестировать
интеграцию в Sandbox?

  • Никакого риска для реальных средств

    Тестовые токены и монеты не имеют реальной ценности. Ошибки в суммах, валютах или адресах кошельков ничего не стоят.

  • Проверка поведения API

    Тестируйте запросы, ответы, вебхуки и подписи в Sandbox до перехода в рабочую среду.

  • Раннее выявление ошибок

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

  • Старт без KYB

    Разработчики могут создавать и тестировать интеграцию, пока ваша компания проходит верификацию KYB.

Что можно протестировать в Inqud Sandbox?

Как начать

  1. 01

    Создайте аккаунт Sandbox

    Зарегистрируйтесь на
    https://app.sandbox.inqud.com. KYB не нужен, поэтому начать разработку можно сразу после регистрации.

  2. 02

    Сгенерируйте API-токены

    В кабинете Sandbox откройте раздел API-токенов и сгенерируйте пару токенов: и . Эти токены работают только в Sandbox.

  3. 03

    Подключите интеграцию

    Укажите базовый URL API и подписывайте запросы токенами Sandbox. Дальше платёжный API Sandbox работает по тому же руководству по интеграции, что и рабочая среда.

  4. 04

    Получите тестовые средства

    Нативные монеты тестовых сетей для оплаты комиссий сети можно получить в публичных кранах (faucets). Чтобы получить тестовые USDT или USDC на баланс Sandbox, обратитесь к своему менеджеру Inqud или в поддержку.

Sandbox и Production

Sandbox и Production используют один и тот же API-контракт, но работают как отдельные среды. Вот чем тестовая среда платёжного шлюза отличается от рабочей.

Аккаунты, API-токены и балансы разделены. Учётные данные одной среды нельзя использовать в другой.

SandboxProduction
НазначениеРазработка, тестирование и демоРеальные платежи
СредстваТестовые токены и монеты тестовых сетейРеальные средства
KYBНе требуетсяТребуется
Базовый URL API
Кабинет мерчантаhttps://app.sandbox.inqud.comhttps://app.inqud.com
API-токеныПара токенов SandboxПара токенов Production
СетиПубличные тестовые сети EVMРеальные блокчейн-сети
ВалютыЧасть валют рабочей средыВсе поддерживаемые валюты

Протестируйте API-запросы до запуска

Тестирование API в Sandbox приносит больше всего пользы, если пройти все вызовы, которые ваш продукт будет делать в рабочей среде. Перед запуском проверьте:

Лимиты запросов

Sandbox допускает 10 POST-запросов и 300 GET-запросов в минуту. Если для тестов нужно больше, напишите в поддержку, чтобы повысить лимит.

  • 10
    POST-запросов / мин
  • 300
    GET-запросов / мин
  • Аутентификация

    КаждыйзапросподписываетсяпаройтокеновSandboxвзаголовкахи.

  • Тела запросов

    Все обязательные поля заполнены, а значения соответствуют форматам из справочника API.

  • Ответы и ошибки

    Ваша система корректно читает успешные ответы и обрабатывает ответы с ошибками, не прерывая процесс.

  • Доступные способы оплаты

    Не все валюты и сети рабочей среды включены в Sandbox, поэтому сначала запросите список доступных способов оплаты через API Sandbox и стройте тесты на его основе.

Протестируйте вебхуки

Вебхуки сообщают вашей системе, что платёж поступил или его статус изменился, поэтому им стоит уделить отдельное внимание. В Sandbox содержимое вебхуков и проверка подписи работают так же, как в рабочей среде.

Inqud Sandbox
  1. 01
    Оплата чекаута

    с тестового баланса USDT или USDC

  2. 02
    СтатусУспешно

    мгновенно, без ожидания подтверждений в блокчейне

ВебхукPOST с подписью вX-Payload-Digest
Ваш эндпоинт
  1. 03
    получает вебхук
  2. 04
    проверяет подпись
  3. 05
    правильно считывает статус
  4. 06
    обновляет заказ или баланс на вашей стороне

Проверьте, что ваш эндпоинт получает вебхук, проверяет подпись, правильно считывает статус и обновляет заказ или баланс на вашей стороне. Быстрее всего запустить этот сценарий, оплатив чекаут криптоэквайринга с тестового баланса USDT или USDC: вы получите всю цепочку от оплаты до вебхука и зачисления средств без ожидания подтверждений в блокчейне.

Тестовые депозиты и выплаты

Inqud Sandbox работает в публичных тестовых сетях EVM, поэтому вы можете тестировать криптоплатежи в сетях, которые ведут себя как настоящие блокчейны.

  • EthereumSepolia
  • BNB ChainTestnet
  • PolygonAmoy
  • ArbitrumSepolia
  • OptimismSepolia
  • BaseSepolia

Депозиты

Депозиты доступны в Ethereum Sepolia, BNB Smart Chain Testnet, Polygon Amoy, Arbitrum Sepolia, Optimism Sepolia и Base Sepolia. Для оплаты комиссий сети нужна только нативная монета тестовой сети, например Sepolia ETH или тестовый BNB, которую можно получить в сторонних кранах.

Получить тестовые монеты
  • USDTPolygon Amoy−50.00Успешно
  • USDCBase Sepolia−25.00В ожидании
  • Карта •••• 0002Тестовый номер карты−10.00Неуспешно

Выплаты

Выплаты доступны для тестовых USDT и USDC в тех же сетях. Это тестовые токены, выпущенные Inqud, и ваш менеджер или служба поддержки зачислит их на баланс Sandbox по запросу.

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

Из Sandbox в Production

Когда интеграция работает в Sandbox, переход в рабочую среду занимает три шага:

  1. 01

    Смените базовый URL API

    ЗаменитебазовыйURLAPIна.

  2. 02

    Пройдите KYB, получите токены

    Пройдите KYB и сгенерируйте API-токены рабочей среды на https://app.inqud.com, затем замените ими токены Sandbox.

  3. 03

    Запуск в реальных сетях

    Переключитесь на реальные сети и валюты.

.env
# Inqud API · Sandbox
INQUD_API_BASE_URL=https://api.sandbox.inqud.com01
INQUD_TOKEN_API_ID=<sandbox token id>02
INQUD_TOKEN_API_SECRET=<sandbox token secret>02

API-контракт в обеих средах одинаковый, поэтому других изменений в коде интеграции не потребуется.

При этом сама среда отличается: в рабочей среде используются реальные средства, доступно больше валют и сетей, а также отдельный аккаунт и балансы.

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

Нет. В Sandbox нет требования KYB, поэтому вы можете зарегистрироваться на https://app.sandbox.inqud.com и сразу начать разработку. KYB нужен только для рабочей среды.

Нет. Sandbox работает с тестовыми USDT и USDC, выпущенными Inqud, и с нативными монетами публичных тестовых сетей. Ни одна из них не имеет реальной ценности.

Да. Sandbox и рабочая среда используют отдельные аккаунты и отдельные пары API-токенов. Токены Sandbox не работают в рабочей среде, а токены рабочей среды не работают в Sandbox.

Да. Депозиты доступны в шести тестовых сетях EVM, включая Ethereum Sepolia, Polygon Amoy и Base Sepolia. Выплаты работают для тестовых USDT и USDC, а тестовые номера карт позволяют проверить успешные, неуспешные и ожидающие выплаты на карты.

Да. Содержимое вебхуков и проверка подписи в Sandbox такие же, как в рабочей среде. Вы можете проверить, что ваш эндпоинт получает вебхуки, проверяет подписи и обрабатывает каждый статус платежа.

API тот же: форматы запросов и ответов, содержимое вебхуков и проверка подписи не меняются. Отличаются сами среды: Sandbox использует тестовые средства и тестовые сети EVM, поддерживает только часть валют и сетей рабочей среды и имеет лимиты в 10 POST- и 300 GET-запросов в минуту, которые поддержка может повысить по запросу.

Вы меняете базовый URL API на https://api.inqud.com, заменяете токены Sandbox на токены рабочей среды и переключаетесь на реальные сети и валюты. Чтобы получить токены рабочей среды, нужно пройти KYB.

Проверьте аутентификацию, обязательные поля в запросах, обработку ответов и ошибок, доставку вебхуков и проверку подписи, депозиты и выплаты. Также полезно воспроизвести неуспешные и ожидающие выплаты, чтобы ваша система была готова к любому исходу.

Простые руководства для разработчиковРуководства

Пройдите процесс интеграции с нашими краткими и структурированными руководствами.

Документация

Центр помощи

Свяжитесь с нами по любым вопросам. Мы рады помочь.

Центр помощиПерейти в Центр помощи

Начните разработку в Sandbox.

Для регистрации KYB не нужен.