Тестирование
У каждого магазина есть тестовый близнец с номером <номер>DEMO и своим ключом sk_test_…. Он создаётся при регистрации и работает с тестовым стендом ПЦ (test.paygine.com): платежи, возвраты, чеки и вебхуки проходят полностью, деньги не двигаются. Переключение между магазинами — в списке магазинов в кабинете.
Тестовые данные
| Что | Где взять |
|---|---|
| ID и ключ тестового магазина | Кабинет → тестовый магазин → Интеграция → Подключение. |
| Тестовая карта | Номер выдаёт ПЦ; он показан в кабинете тестового магазина на вкладке Интеграция → Тестирование. Срок — любой в будущем, CVC — любые три цифры. Реальные карты на тестовом стенде не работают. |
| СБП | Реального банка нет. Под QR в виджете тестового магазина есть кнопки «Оплата успешна (150)» и «Отказ (151)» — стенд ПЦ пришлёт уведомление, как настоящий банк, и виджет покажет результат. |
| Вебхуки | Отправляются так же, как в боевом магазине, со своим секретом. Для тестов укажите отдельный адрес. |
Тест-кейсы
На вкладке Интеграция → Тестирование тестового магазина есть список кейсов; каждый отмечается пройденным автоматически по событиям магазина, кнопка «Проверить» обновляет результат. Прохождение необязательно, но мы рекомендуем закрыть хотя бы первые пять до переключения на боевой ключ.
- Первый запрос к API с ключом тестового магазина.
- Оплата картой на форме ПЦ: POST /payments → виджет или payment_url → «Оплатить картой».
- Оплата по СБП (method: "sbp", сценарий 150).
- Доставка вебхука payment.succeeded с ответом 2xx.
- order_id вернулся в вебхуке — по нему вы находите оплаченный заказ.
- Холд и списание (capture: manual → POST /payments/{id}/capture).
- Отмена холда (POST /payments/{id}/cancel).
- Отмена неоплаченного платежа (POST /payments/{id}/cancel для pending).
- Отказ банка (сценарий 151) — проверьте обработку status = canceled и поля decline.
- Полный и частичный возврат (POST /refunds).
- Чек по платежу (receipt.ready).
Переход на боевой магазин
- Подайте заявку на подключение в кабинете боевого магазина и дождитесь активации: до неё боевой ключ не выпущен, а запросы с ним отвечают 403 live_disabled.
- После активации скопируйте ключ sk_live_… (он показывается один раз) и замените его в интеграции вместе с адресом вебхука.
- Объекты тестового магазина в боевом недоступны: идентификаторы платежей, ссылок и вебхуков не переносятся.
- Первый боевой платёж проведите сами на небольшую сумму и проверьте чек и вебхук.