Пісочниця

Магазин-пісочниця дозволяє перевіряти обробку платежів без надсилання реальної криптовалюти. У кожного мерчанта може бути одна пісочниця.

Створіть окремий магазин із "sandbox": true. Наявний бойовий магазин не можна переключити в режим пісочниці.

Перевірте рахунок

1. Створіть рахунок у магазині-пісочниці за швидким стартом.
2. Збережіть його id як issuance_id.
3. Симулюйте підтверджений вхідний платіж:

curl -X POST 'https://platform.invoise.me/api/v1/shops/{shop_id}/sandbox/simulate' \
  -H 'Authorization: Bearer ivk_...' \
  -H 'Idempotency-Key: <saved-unique-key>' \
  -H 'Content-Type: application/json' \
  -d '{"issuance_id":"<issuance-id>","kind":"transfer.confirmed","amount":"10000000"}'

Використовуйте фактичну суму рахунку в базових одиницях. Порожнє тіло {} не ідентифікує платіж і завершиться помилкою.

У пісочниці один рахунок або симульований переказ не може перевищувати 10 000 токенів; більша сума повертає 400 sandbox_amount_limit. Рахунки й депозитні адреси пісочниці рахуються окремо від продакшена. Див. Ліміти.

Знову прочитайте ендпоінт статусу. Повністю оплачений рахунок досягає стану funded; підписники вебхуків можуть отримати transfer.confirmed. Симуляція вставляє запитану подію, а не повний реальний платіж у блокчейні.

Щоб симулювати закриття рахунку після оплати, надішліть новий ключ ідемпотентності з:

{"issuance_id":"<issuance-id>","kind":"invoice.closed","amount":"0"}

Це перевіряє стан settled. Щоб перевірити коригування, симулюйте transfer.reverted із reference_event_id, встановленим у ID попередньої події. Для кожної нової симульованої події використовуйте окремий збережений ключ.

Почніть чистий тест

POST /api/v1/shops/{shop_id}/sandbox/reset видаляє історію платежів пісочниці. Потрібна сесія власника, свіжа MFA, якщо увімкнена, та Idempotency-Key.

Старі ключі ідемпотентності зберігають свої початкові результати після скидання. Для нових тестових платежів використовуйте нові ключі.

Перед прийомом реальних платежів

Пісочниця перевіряє ваш API та обробку подій. Вона не підтверджує реальні мережеві підтвердження, витрати на газ чи надходження на біржу. Перевірте невеликий реальний платіж окремо, перш ніж покладатися на цей шлях.