От первого проекта до ежедневной сверки.
Практические руководства Meridian: подготовка проекта, первая оплата и ежедневная сверка. Без лишней теории.
Подготовьте проект к подключению
Сначала определите границы проекта. Это сократит переписку и поможет сразу согласовать подходящую схему.
- Подготовьте ссылку на работающий сайт или приложение, описание услуги, страны покупателей и ожидаемый оборот. Если продукт закрыт, объясните менеджеру, как его посмотреть.
- Заполните заявку: Telegram, сайт, сфера деятельности и тип верификации. Если не знаете нужный тип, выберите «Уточнить с менеджером».
- До интеграции согласуйте доступные методы, комиссию, срок разблокировки средств и порядок выплат. Условия одного проекта не обязательно подходят другому.
- После одобрения войдите в выданную учётную запись. Проверьте название проекта и расчётный режим. Если они отличаются от согласованных, остановитесь и обратитесь в поддержку.
- В блоке API & Webhooks нажмите «Управлять интеграцией». Создайте ключ с понятным названием, сохраните показанный секрет в защищённом хранилище сервера. Повторно раскрыть его нельзя.
Ключ доступа относится к проекту. Не размещайте его в браузере, скриншотах, публичном репозитории или переписке.
Проведите первую тестовую оплату
Проверяйте не только успешный экран, но и то, как ваш заказ получает подтверждение.
- Убедитесь, что проект работает в тестовом режиме. Попросите команду подтвердить среду и ограничения до отправки запросов.
- Создайте заказ с собственным уникальным orderId. В действующем API сумма передаётся строкой в копейках: 235000 означает 2 350 рублей. Используйте поддерживаемый метод SBP или CARD.
- Передавайте ключ проекта в X-Api-Key и отдельный Idempotency-Key для операции. При сетевом повторе того же запроса сохраняйте тот же ключ идемпотентности.
- Пройдите размещённую тестовую форму. Отдельно проверьте успешную оплату, отказ и истечение срока. Не используйте реальные реквизиты для имитации операций.
- Сопоставьте заказ с платежом на сервере. Возврат покупателя на страницу успеха сам по себе не подтверждает оплату: проверьте статус через API или обработанное подписанное событие.
Тестовая операция проверяет интеграцию, но не означает, что рабочий эквайринг уже включён. Запуск согласуется отдельно.
Сверяйте операции без догадок
Разделяйте статус платежа, оборот и доступность денег. Эти показатели отвечают на разные вопросы.
- Выберите период в кабинете и проверьте проект. Сравнивайте одинаковые периоды и валюты в своей системе и Meridian.
- Начните с количества успешных операций и оборота. Затем проверьте комиссии и возвраты: они объясняют разницу между суммой заказов и итоговыми средствами.
- Найдите спорную операцию по её ID или номеру заказа. Зафиксируйте статус и время проверки, прежде чем повторять запрос или обращаться в поддержку.
- Настройте HTTPS-адрес в разделе API & Webhooks. Сохраните секрет подписи на сервере и проверяйте подлинность каждого уведомления.
- Обрабатывайте повторные уведомления без повторной выдачи услуги. Если событий недостаточно для сверки, запросите актуальное состояние платежа через API.
Для обращения приложите ID проекта, ID платежа и описание ожидаемого результата. Пароли, ключи и полные реквизиты карт прикладывать нельзя.
Проверьте доступность средств перед выплатой
Успешный платёж и доступный к выводу баланс — не одно и то же. Между ними действует расчётный режим проекта.
- Посмотрите отдельно ожидающие, доступные и зарезервированные средства. Не складывайте их как немедленно доступный остаток.
- Откройте «Все холды», чтобы проверить ближайшие разблокировки. Срок T+N применяется к новым платежам; изменение настройки не переписывает историю.
- Для выплаты в USDT используйте согласованную сеть и подтверждённый адрес. Действующий API работает с адресами TRC20 из разрешённого списка.
- Проверьте сумму и доступный баланс. Заявка резервирует средства, поэтому повторять её с новым ключом только из-за задержки ответа нельзя.
- Для массовых расчётов с исполнителями заранее согласуйте получателей, график и способ передачи операций с менеджером. Загрузки реестра и автоматического расписания в текущем кабинете нет.
Подтверждение заявки не равно завершению перевода. Ориентируйтесь на конечный статус и согласованный порядок сверки.
Начнём с вашего проекта.
Расскажите, что вы продаёте и где работаете. Вернёмся с вопросами и предложением по подключению.
support@meridian-pay.io