Легкий старт із Sandbox

Вступ по Sandbox

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

ЗВЕРНІТЬ УВАГУ

Sandbox працює з тестовими даними, тому всі оброблені транзакції не є реальними і не залучають справжні кошти.

 

Тестові дані

Sandbox API хост

API URLhttps://sandbox-api.coocoopay.com/
API КЛЮЧДля авторизації використовуйте публічний ключ, отриманий у "Sandbox Дашборд" або наданий службою підтримки.

 

Sandbox дашборд

URLhttps://sandbox-app.coocoopay.com/
ОБЛІКОВІ ДАНІЯкщо ви бажаєте отримати свої облікові дані, будь ласка, зв'яжіться з нашою службою підтримки.

Sandbox webhook public key

Публічний ключ завантажить "webhook-shared-public-key-sandbox.pem"

Sandbox webhook public key
-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtpgcPVQ+pyTQRxuIq2zu
6dm8lcA6EnSpGEjpzv4bhPOHboBFcRYdhY3ToqeILE383Zv7bvsWWqLqrSmKqYYz
jo7pILfAWJ6+pPmp4jvMr78aP6eqc2jYxI/+ZXsV5QezU7oVZohihfWV/rq+BbAr
Hhgk25XoX8Rb21KjvMDoAlVThbQ3+xEZKrEG5s/jDMQ7QFmijDlxiLq/1oDlJ8ih
FxJc4wEKjhtlzRBBYq0q+W7b5d1T8VGExLHRwg7XZ4qosQHRTD45r74h2SHjzPvn
2V5OK7UNBAkO5C9fepoitOSrV9w0OZpjPJcZ55VA5qodAEgANQl+6sjN8KSw/Wnm
0QIDAQAB
-----END PUBLIC KEY-----

Запит для тестування

Sandbox request sample
POST /webhook-url/1697633610 HTTP/1.1
Host: example.com
Signature: kxztHjcNqibE/3ijq5mSrdwrJl7PFkcJWA3NqIlqHeb3Nyokj3GlqsVaCD9ytS+L/8jYS5srFIBt3OCknmASyTV6ywMKziU6IV1rayuINN6Qr0nbzOHT8XzFDt8U8h6hjS2r/VmL4OjIvp8aHYDn1OKKf6YwH+fxWxPkHpvlcQNyVoRjTewEtxgtlQCtwWAwCeF2j0SPjAk57FSd+rfg+HF/T574egz6ur+U4IQctaBvbXpURudfZ2PFPxMyagvJpCRi3a2vqo7ADqR0SwThyamWLWDpKTEUeEDZHJpwXQDRRQZ0ifstzBWCLJXRh6rg68MrCUq6HDML0bKqDRXQBg==
{"data": {}, "error": null}

Webhook Verification algorithm  

Початок роботи з Sandbox

Щоб почати використовувати Sandbox, виконайте наступні кроки:

  1. Отримайте облікові дані: Після налаштування облікового запису, спеціально для використання в Sandbox. Вони потрібні для автентифікації запитів у середовищі Sandbox.
  2. Налаштуйте тестову конфігурацію: Налаштуйте Sandbox відповідно до ваших очікувань, таких як часовий пояс (UTC), валюта та інші індивідуальні налаштування (детально описано у розділі "Sandbox Налаштування").
  3. Почніть виконувати тестові транзакції: З обліковими даними на руках ви можете розпочати виконання тестових транзакцій та використовувати тестові картки для різних сценаріїв (див. розділ "Тестові картки").

API calls link

Почніть насолоджуватись усіма перевагами Sandbox.

Розпочати right copy

API приклад

Дізнайтесь про запити аутентифікації, відповіді та код.

Переглянути API right copy

 

Використання: Еквайринг та криптопроцесинг

API підтримує різноманітні сценарії використання, які відповідають як традиційним потребам еквайрингу, так і криптопроцесингу.

Використання еквайрингу

МожливостіЗабезпечує традиційну обробку платежів, дозволяючи мерчантам приймати платежі з кредитних та дебетових карт у різних валютах. Ідеально підходить для платформ електронної комерції, постачальників послуг та інших бізнесів, яким потрібна безпечна обробка платежів.
ОбмеженняТранзакції в Sandbox є змодельованими, тому реальні кошти не переводяться. Деякі умови реального світу, такі як затримка мережі або неочікувані помилки, можуть не повністю відтворюватись у режимі Sandbox.

 

Використання криптопроцесінгу

МожливостіДозволяє обробку транзакцій у основних криптовалютах, забезпечуючи мерчантам можливість приймати цифрові активи.
ОбмеженняТранзакції в криптовалюті в Sandbox є симуляціями; справжні криптоактиви не переводяться. Доступність певних криптовалют може бути обмежена в Sandbox для тестування.

 

Тестові картки: Успішні та відхилені сценарії

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

  1. Картки успішних транзакцій: Використовуйте їх для моделювання успішних платіжних транзакцій. Вони дозволяють тестувати типовий користувацький досвід, коли платіж схвалено.
  2. Картки для відхилення транзакцій: Ці картки викликають певні коди помилок та відхилення транзакцій. Корисні для тестування обробки невдалих платежів, наприклад, через недостатню суму коштів або шахрайські сценарії.
ВИКОРИСТОВУЙТЕ ТІЛЬКИ ТЕСТОВІ НОМЕРИ КАРТОК НИЖЧЕ

Ніколи не тестуйте за допомогою реальних номерів карток або реквізитів карток у середовищі пісочниці.

 

Тестові картки

Тестовий КейсНомер КарткиОчікуваний Результат
SuccessfulТранзакція Успішна
RejectТранзакція Відхилена

 

Виплати IBAN

Тестовий КейсНомер IBANОчікуваний Результат
Успішна виплата UAHТранзакція Успішна
Успішна виплата EURТранзакція Успішна
Відхилена виплата UAHТранзакція Відхилена
Відхилена виплата EURТранзакція Відхилена

 

Тестові реквізити - крипто (виплата)

Тестовий Кейс (Payout)ВалютаРеквізитиОчікуваний Результат
SuccessfulUSDT (trc20)Транзакція Успішна
RejectedUSDT (trc20)Транзакція Відхилена
SuccessfulBTCТранзакція Успішна

Тестовий checkout

Test checkout

ЗВЕРНІТЬ УВАГУ

Поля «Дата закінчення терміну дії» та «CVV/CVC2» заповнюються автоматично в тестовому випадку.

"Особистий кабінет мерчанта" є централізованим центром для управління обліковим записом Sandbox та налаштуваннями. У кабінеті ви можете:

  1. Переглядати журнали транзакцій: Відстежувати та переглядати тестові транзакції для діагностики та перевірки.
  2. Отримати доступ до тестових даних: Всі дані в Sandbox є симульованими, що забезпечує реалістичний, але безпечний досвід тестування без впливу на реальну продукцію.

Налаштування Sandbox

Середовище Sandbox пропонує можливість налаштування, що дозволяє симулювати умови реального світу настільки, наскільки це можливо.

  1. Часовий пояс (UTC): Транзакції та журнали в Sandbox позначені часом у UTC, що забезпечує послідовність у тестуванні.
  2. Підтримувані валюти: Оберіть серед різних валют для тестування поведінки обробки платежів, залежно від валюти. Це допомагає переконатися, що API правильно обробляє валютні конверсії та багатовалютні транзакції.
  3. Облікові дані API: Унікальні облікові дані Sandbox необхідні для доступу до середовища.
    INFO
    Ці дані відрізняються від облікових даних для продукції та повинні використовуватися лише в Sandbox.
  4. Управління транзакціями: Типи транзакцій, такі як авторизація, підтвердження, повернення коштів та анулювання, можна протестувати в Sandbox для моделювання різних етапів обробки платежів.

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

ЗВЕРНІТЬ УВАГУ

Після інтеграції та тестування в пісочниці, єдині зміни, які будуть потрібні — це публічний ключ та URL продуктивного середовища. Всі інші налаштування залишаться без змін.

Are there any inquiries still outstanding?

Our team of experts is available 24/7 to answer all your questions. Feel free to reach out to us at any time, and we will be happy to help you address any inquiries or issues. Your comfort and satisfaction are our priority.

Need help?

Contact support