Легкий старт із Sandbox
Вступ по Sandbox
Середовище sandbox забезпечує безпечний, ізольований простір для розробників для тестування функціоналу API без впливу на реальні системи чи обробку справжніх транзакцій. Воно моделює повний спектр функцій, доступних у виробничому середовищі, що дозволяє переконатися, що інтеграція працює належним чином перед запуском у реальній роботі.
ЗВЕРНІТЬ УВАГУSandbox працює з тестовими даними, тому всі оброблені транзакції не є реальними і не залучають справжні кошти.
Тестові дані
Sandbox API хост
| API URL | https://sandbox-api.coocoopay.com/ |
| API КЛЮЧ | Для авторизації використовуйте публічний ключ, отриманий у "Sandbox Дашборд" або наданий службою підтримки. |
Sandbox дашборд
| URL | https://sandbox-app.coocoopay.com/ |
| ОБЛІКОВІ ДАНІ | Якщо ви бажаєте отримати свої облікові дані, будь ласка, зв'яжіться з нашою службою підтримки. |
Sandbox webhook public key
Публічний ключ завантажить "webhook-shared-public-key-sandbox.pem"
-----BEGIN PUBLIC KEY-----MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtpgcPVQ+pyTQRxuIq2zu6dm8lcA6EnSpGEjpzv4bhPOHboBFcRYdhY3ToqeILE383Zv7bvsWWqLqrSmKqYYzjo7pILfAWJ6+pPmp4jvMr78aP6eqc2jYxI/+ZXsV5QezU7oVZohihfWV/rq+BbArHhgk25XoX8Rb21KjvMDoAlVThbQ3+xEZKrEG5s/jDMQ7QFmijDlxiLq/1oDlJ8ihFxJc4wEKjhtlzRBBYq0q+W7b5d1T8VGExLHRwg7XZ4qosQHRTD45r74h2SHjzPvn2V5OK7UNBAkO5C9fepoitOSrV9w0OZpjPJcZ55VA5qodAEgANQl+6sjN8KSw/Wnm0QIDAQAB-----END PUBLIC KEY-----
Запит для тестування
POST /webhook-url/1697633610 HTTP/1.1Host: example.comSignature: kxztHjcNqibE/3ijq5mSrdwrJl7PFkcJWA3NqIlqHeb3Nyokj3GlqsVaCD9ytS+L/8jYS5srFIBt3OCknmASyTV6ywMKziU6IV1rayuINN6Qr0nbzOHT8XzFDt8U8h6hjS2r/VmL4OjIvp8aHYDn1OKKf6YwH+fxWxPkHpvlcQNyVoRjTewEtxgtlQCtwWAwCeF2j0SPjAk57FSd+rfg+HF/T574egz6ur+U4IQctaBvbXpURudfZ2PFPxMyagvJpCRi3a2vqo7ADqR0SwThyamWLWDpKTEUeEDZHJpwXQDRRQZ0ifstzBWCLJXRh6rg68MrCUq6HDML0bKqDRXQBg=={"data": {}, "error": null}
Webhook Verification algorithm
Початок роботи з Sandbox
Щоб почати використовувати Sandbox, виконайте наступні кроки:
- Отримайте облікові дані: Після налаштування облікового запису, спеціально для використання в Sandbox. Вони потрібні для автентифікації запитів у середовищі Sandbox.
- Налаштуйте тестову конфігурацію: Налаштуйте Sandbox відповідно до ваших очікувань, таких як часовий пояс (UTC), валюта та інші індивідуальні налаштування (детально описано у розділі "Sandbox Налаштування").
- Почніть виконувати тестові транзакції: З обліковими даними на руках ви можете розпочати виконання тестових транзакцій та використовувати тестові картки для різних сценаріїв (див. розділ "Тестові картки").
API calls link
Почніть насолоджуватись усіма перевагами Sandbox.
API приклад
Дізнайтесь про запити аутентифікації, відповіді та код.
Використання: Еквайринг та криптопроцесинг
API підтримує різноманітні сценарії використання, які відповідають як традиційним потребам еквайрингу, так і криптопроцесингу.
Використання еквайрингу
| Можливості | Забезпечує традиційну обробку платежів, дозволяючи мерчантам приймати платежі з кредитних та дебетових карт у різних валютах. Ідеально підходить для платформ електронної комерції, постачальників послуг та інших бізнесів, яким потрібна безпечна обробка платежів. |
| Обмеження | Транзакції в Sandbox є змодельованими, тому реальні кошти не переводяться. Деякі умови реального світу, такі як затримка мережі або неочікувані помилки, можуть не повністю відтворюватись у режимі Sandbox. |
Використання криптопроцесінгу
| Можливості | Дозволяє обробку транзакцій у основних криптовалютах, забезпечуючи мерчантам можливість приймати цифрові активи. |
| Обмеження | Транзакції в криптовалюті в Sandbox є симуляціями; справжні криптоактиви не переводяться. Доступність певних криптовалют може бути обмежена в Sandbox для тестування. |
Тестові картки: Успішні та відхилені сценарії
Для полегшення тестування доступний набір тестових номерів карток. Вони моделюють різні результати та дозволяють перевірити, як система обробляє різні платіжні сценарії:
- Картки успішних транзакцій: Використовуйте їх для моделювання успішних платіжних транзакцій. Вони дозволяють тестувати типовий користувацький досвід, коли платіж схвалено.
- Картки для відхилення транзакцій: Ці картки викликають певні коди помилок та відхилення транзакцій. Корисні для тестування обробки невдалих платежів, наприклад, через недостатню суму коштів або шахрайські сценарії.
ВИКОРИСТОВУЙТЕ ТІЛЬКИ ТЕСТОВІ НОМЕРИ КАРТОК НИЖЧЕНіколи не тестуйте за допомогою реальних номерів карток або реквізитів карток у середовищі пісочниці.
Тестові картки
| Тестовий Кейс | Номер Картки | Очікуваний Результат |
|---|---|---|
| Successful | Транзакція Успішна | |
| Reject | Транзакція Відхилена |
Виплати IBAN
| Тестовий Кейс | Номер IBAN | Очікуваний Результат |
|---|---|---|
| Успішна виплата UAH | Транзакція Успішна | |
| Успішна виплата EUR | Транзакція Успішна | |
| Відхилена виплата UAH | Транзакція Відхилена | |
| Відхилена виплата EUR | Транзакція Відхилена |
Тестові реквізити - крипто (виплата)
| Тестовий Кейс (Payout) | Валюта | Реквізити | Очікуваний Результат |
|---|---|---|---|
| Successful | USDT (trc20) | Транзакція Успішна | |
| Rejected | USDT (trc20) | Транзакція Відхилена | |
| Successful | BTC | Транзакція Успішна |
Тестовий checkout
ЗВЕРНІТЬ УВАГУПоля «Дата закінчення терміну дії» та «CVV/CVC2» заповнюються автоматично в тестовому випадку.
Sandbox акаунт (Особистий кабінет мерчанта)
"Особистий кабінет мерчанта" є централізованим центром для управління обліковим записом Sandbox та налаштуваннями. У кабінеті ви можете:
- Переглядати журнали транзакцій: Відстежувати та переглядати тестові транзакції для діагностики та перевірки.
- Отримати доступ до тестових даних: Всі дані в Sandbox є симульованими, що забезпечує реалістичний, але безпечний досвід тестування без впливу на реальну продукцію.
Налаштування Sandbox
Середовище Sandbox пропонує можливість налаштування, що дозволяє симулювати умови реального світу настільки, наскільки це можливо.
- Часовий пояс (UTC): Транзакції та журнали в Sandbox позначені часом у UTC, що забезпечує послідовність у тестуванні.
- Підтримувані валюти: Оберіть серед різних валют для тестування поведінки обробки платежів, залежно від валюти. Це допомагає переконатися, що API правильно обробляє валютні конверсії та багатовалютні транзакції.
- Облікові дані API: Унікальні облікові дані Sandbox необхідні для доступу до середовища. INFOЦі дані відрізняються від облікових даних для продукції та повинні використовуватися лише в Sandbox.
- Управління транзакціями: Типи транзакцій, такі як авторизація, підтвердження, повернення коштів та анулювання, можна протестувати в Sandbox для моделювання різних етапів обробки платежів.
Кожне з цих налаштувань допомагає імітувати реальне використання в контрольованому, безпечному середовищі, дозволяючи вам точно налаштувати вашу інтеграцію перед виходом в реальну експлуатацію.
ЗВЕРНІТЬ УВАГУПісля інтеграції та тестування в пісочниці, єдині зміни, які будуть потрібні — це публічний ключ та URL продуктивного середовища. Всі інші налаштування залишаться без змін.