Inqud Logo
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

    ЗамінітьбазовуURL-адресуAPIна.

  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 не потрібен.