Тестирование мерчанта: Sell → Spyder
Этот сценарий применяется, когда Spyder выступает провайдером, а мерчант отправляет на площадку Sell-заявки. В кабинете трейдера Sell соответствует PayIn и разделу Заявки на продажу.
1. Подготовьте тестового мерчанта
Заголовок раздела «1. Подготовьте тестового мерчанта»- Откройте Администрирование → Пользователи → Создать пользователя и создайте учетную запись с ролью Мерчант.
- В настройках учетной записи задайте согласованные ставки PayIn/PayOut и назначьте скрипты курсов.
- В строке мерчанта включите Онлайн. У нового мерчанта подпись callback включена по умолчанию. Проверьте её в редакторе пользователя и согласуйте способ проверки с мерчантом по инструкции ниже.
- В профиле мерчанта укажите (попросите указать) HTTPS Callback URL и сохраните его.
- Через Вайтлист свяжите мерчанта с подготовленным тестовым трейдером, выставьте приоритет и при необходимости индивидуальные ставки, курсы и уровни комиссий.




2. Подготовьте тестового трейдера
Заголовок раздела «2. Подготовьте тестового трейдера»- Создайте или выберите учетную запись с ролью Трейдер, разблокируйте ее и внесите тестовый рабочий баланс через действие Изменить баланс администратора.
- Для ручной работы без автоматики включите БТ; при автоматической работе подключите устройство и проверьте его доступность. Отдельно включите разрешение Онлайн в строке трейдера, затем сам трейдер включает собственный поток в кабинете.
- Создайте устройство в разделе устройств, безопасно подключите автоматику при необходимости и добавьте реквизит в разделе реквизитов. Для PayIn реквизит должен быть активен, подходить методу оплаты и иметь свободные лимиты.
- Свяжите трейдера с тестовым мерчантом в вайтлисте. Убедитесь, что у связки есть нужные PayIn-ставка и курс.
- Проверьте в трейдерском кабинете, что реквизит и поток трафика включены, а рабочий баланс достаточен для резерва новой заявки.


Для подробностей по устройству, реквизитам и балансу используйте страницы трейдера, автоматики и антифрода.
3. Передайте мерчанту доступ
Заголовок раздела «3. Передайте мерчанту доступ»Передавайте данные только по согласованному защищенному каналу:
- адрес площадки, логин и первоначальный пароль мерчанта;
- адрес встроенной API-документации:
https://<домен-площадки>/docs; - согласованные метод оплаты, валюту, Callback URL и правила проверки подписи;
- внешний ID теста, если он нужен для сопоставления с системой мерчанта.
Не отправляйте API-токен, пароль, QR-коды устройств или реальные платежные реквизиты в общих чатах и на скриншотах.
Подпись callback
Заголовок раздела «Подпись callback»У нового мерчанта подпись callback включена по умолчанию. Администратор проверяет её в Пользователи → Редактировать пользователя → Подпись колбеков: переключатель Подписывать колбеки и поле Ключ подписи колбеков. Согласуйте включённый режим с мерчантом и передайте ему ключ защищённым способом. Сам мерчант видит состояние подписи и свой ключ в профиле, но не включает подпись и не перевыпускает ключ.




Если контрагент — другая площадка Spyder, вместо ручного переноса ключей используйте подключение по Spyder-ссылке.
4. Пройдите матрицу тестов
Заголовок раздела «4. Пройдите матрицу тестов»| Проверка | Действие мерчанта | Что проверяет оператор Spyder |
|---|---|---|
| Создание | Создает Sell через публичный API с уникальным внешним orderId. |
Заявка получает платежные данные, появляется у подходящего трейдера и приходит callback о создании/изменении статуса. |
| Отмена | Отменяет Sell, пока он находится в допустимом начальном состоянии. | Статус и callback совпадают с API-контрактом; не создаются дубли и лишние движения баланса. |
| Успех | Отправляет тестовый платеж по выданному реквизиту; трейдер подтверждает только после фактической проверки. | Заявка становится успешной, финансовые движения и callback согласованы с внешним ID. |
| Диспут | Создает диспут по API для тестовой заявки. | Заявка появляется в диспутах, история и доказательства доступны трейдеру, саппорту и администратору по их правам. |
| Чек по API | Прикладывает документ через API заявки. | Документ появляется в карточке; если для мерчанта включено правило «чек открывает диспут», проверяется и этот переход. |
| Чек через чат | Если нельзя передать ссылку, использует согласованный ручной сценарий либо настроенного бота. | Саппорт сверяет UUID; для Albert и Klaus проверяет отдельный порядок передачи и разбора. |
Остальные методы, статусы и ответы сверяйте со встроенной страницей /docs. Не повторяйте отправку с новым orderId, если исходный запрос уже мог быть принят: сначала найдите заявку по внешнему ID.
Чек по API: PDF по ссылке
Заголовок раздела «Чек по API: PDF по ссылке»Мерчант прикрепляет чек к существующей Sell (PayIn)-заявке запросом POST /api/orders/{orderId}/merchant-document. В пути укажите публичный UUID заявки из data.id, а в JSON — ссылку в поле link:
curl -X POST 'https://example.com/api/orders/550e8400-e29b-41d4-a716-446655440000/merchant-document' \ -H 'Authorization: Bearer YOUR_API_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"link":"https://storage.example.com/receipts/payment.pdf"}'Замените https://example.com на адрес площадки, UUID — на UUID исходной заявки, а YOUR_API_TOKEN — на токен её мерчанта. Для PDF не нужен отдельный метод или загрузка файла в теле запроса.
Требования к ссылке:
- Абсолютная HTTP/HTTPS-ссылка, по которой сервер Spyder может скачать сам файл запросом
GETбез дополнительных заголовков авторизации и cookies. Страница просмотра файла или форма входа не подходит. - Редиректы разрешены. Конечный ответ должен быть HTTP
2xxи содержать непустой файл, не HTML. - Максимальный размер — 50 MiB (52 428 800 байт); скачивание должно завершиться за 60 секунд.
- Расширение
.pdfв URL необязательно: адрес вида/download/abc123тоже подходит. Для PDF рекомендуется заголовок ответаContent-Type: application/pdf. - Параметры URL, включая подпись доступа к хранилищу, допустимы.
Ссылка должна оставаться доступной после прикрепления. Файл запрашивается повторно при просмотре и дальнейшей обработке. Если срок действия подписанной ссылки истечёт или файл будет удалён, чек может перестать открываться. Одноразовые ссылки не подходят.
Для теста убедитесь, что чек открывается из карточки исходной заявки. Прикрепление может перевести заявку в DISPUTE: проверяйте newStatus и disputeOpened в ответе. При невозможности скачать файл API возвращает HTTP 400, а если спор уже открыт — HTTP 422 с documentAttached: false и documentError: "DOCUMENT_DOWNLOAD_FAILED". Не отправляйте чек повторной заявкой вместо привязки к исходной.
Если мерчант не может передавать чек ссылкой
Заголовок раздела «Если мерчант не может передавать чек ссылкой»- Мерчант открывает диспут по API для исходной заявки без чека, не передавая
documentUrlиdisputeReason. Текущий статус заявки должен допускать открытие спора. - Мерчант отправляет сам PDF или другой файл чека в согласованный Telegram-чат для споров и указывает публичный UUID заявки из
data.id. - Саппорт находит исходную заявку, сверяет UUID и вручную пересылает чек из чата для споров в чат трейдера по этой заявке.
Пример открытия диспута без чека:
curl -X PUT 'https://example.com/api/merchant/orders/550e8400-e29b-41d4-a716-446655440000/dispute' \ -H 'Authorization: Bearer YOUR_API_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"reason":"Чек будет отправлен в Telegram-чат для споров"}'Пересылка в Telegram не прикрепляет файл к заявке на платформе автоматически. Для теста проверьте отдельно, что диспут открыт на исходной заявке и трейдер получил чек в своём чате.
Если настроен Albert, используйте его прямой сценарий работы с медиа; для Klaus — предусмотренный им сценарий разбора. До теста проверьте регистрацию чатов, права участников и ответственных за ошибки. Это отдельные варианты: в описанном выше ручном сценарии саппорт самостоятельно сверяет и пересылает файл. Не обещайте мерчанту обработку ботом до проверки его настроек. Для обработки результата и финансовых последствий смотрите логику PayIn.
Контроль перед запуском
Заголовок раздела «Контроль перед запуском»Если мерчант получает Нет доступных трейдеров, пройдите диагностику трафика. Сверьте рабочие курсы PayIn нужной валютной пары, ставки, баланс трейдера с учётом резервов, валюту и вайтлист.
Для ручной работы без автоматики нужен БТ; для автоматики — подключённое доступное устройство. В обоих вариантах отдельно проверьте допуск Онлайн, собственный поток трейдера, активность реквизита и метода, диапазон суммы и остаток лимита. Не отключайте Использовать только уникальные суммы на работающей автоматике только ради теста: одинаковые суммы могут помешать сопоставлению платежей. Для отдельного ручного теста согласуйте настройку заранее.
Используйте безопасные данные из изолированного тестового контура и согласованный тестовый платёж. Не подтверждайте фиктивную оплату в рабочем кабинете и не отправляйте деньги на случайные номера. После запуска действуют реальные реквизиты и проверка фактического поступления.
Перед запуском проверьте не только успех:
- неподходящие сумма, валюта или метод не приводят к выдаче неподходящего реквизита;
- повтор запроса обрабатывается по правилам API и не используется для создания второго платежа;
- отмена и истечение освобождают резерв исходной заявки, а результат доходит мерчанту;
- первый чек обрабатывается по согласованным настройкам мерчанта, повторный не продлевает таймер снова;
- документ действительно открывается, а сохранение файла и открытие диспута проверены отдельно;
- если исход запроса неизвестен, заявка сначала найдена по внешнему ID; новый ID не используется для обхода проверки;
- при ошибке callback проверены адрес и принимающая сторона; если требуется повторная отправка, выполнен порядок через диспут со сверкой финансового результата.
После успешной сверки создания, успеха, поддерживаемой отмены, чека и диспута можно включать согласованный рабочий трафик. Для другого направления используйте тестирование buy/PayOut, а для настройки расчёта — индивидуальные ставки и курсы.