Вопросы и ответы¶
Здесь вы можете найти ответы на популярные вопросы об интеграции и взаимодействии с MilkyPay. Этот список не является исчерпывающим или окончательным, мы обновляем и дополняем его в процессе работы. Напишите нам , если у вас есть замечания или дополнения к нему.
Решение проблем с регистрацией и входом¶
Не приходит письмо с приглашением?
Для регистрации в платформе MilkyPay требуется передать администратору аккаунта адрес существующего e-mail для отправки приглашения. Если письмо не приходит, проверьте папку «Спам».
Если письма всё ещё нет, обратитесь к администратору аккаунта, чтобы проверить, правильно ли указан адрес в системе, и переотправить приглашение.
Забыли пароль или существующий пароль не подходит?
Воспользуйтесь кнопкой восстановления пароля: введите e-mail и запросите ссылку для смены пароля. Если письмо не приходит, проверьте папку «Спам».
Также свяжитесь с администратором аккаунта: возможно, ваш доступ был отозван или деактивирован профиль пользователя.
Включена двухфакторная аутентификация (2FA), но сейчас нет доступа к приложению?
Если для вашего аккаунта включена 2FA, но у вас под рукой нет связанного с ним мобильного устройства или отсутствует доступ к приложению:
-
Если вы используете приложение Authy, заранее скачали версию для ПК (или ноутбука) и синхронизировали аккаунт там — вы сможете генерировать коды доступа с помощью приложения для ПК и ноутбуков.
-
Также для Authy есть возможность сменить привязанный номер телефона , установив приложение на другое мобильное устройство.
-
Если у вас нет доступа к приложению, но заранее сохранен список из 10-значных кодов для восстановления доступа, вы можете ввести один из кодов в поле для двухфакторной идентификации.
-
Вы можете обратиться в нашу службу поддержки , чтобы мы отключили вам 2FA на время, и войти в панель управления, используя только пароль.
Если коды 2FA, которые я ввожу, не подходят?
-
Если код не подходит, убедитесь, что вы ввели 6 цифр без пробелов. Бывает, что при использовании версии Authy для ПК, цифровой код копируется и вставляется в поле формы, но с пробелами. Попробуйте ввести код вручную или стереть пробелы перед отправкой.
-
Если аутентификация не пройдена несколько раз подряд, возможно, необходимо синхронизировать часы смартфона с поставщиком услуг мобильной связи. Часто для этого необходимо установить флажок "установить автоматически" на часах устройства, а не указать собственный часовой пояс.
-
Воспользуйтесь 10-значными кодами из списка для восстановления доступа.
-
Обратитесь в нашу службу поддержки , чтобы мы отключили вам 2FA на время и вы смогли войти в панель управления, используя только пароль.
Работа с панелью управления¶
Ошибка «403: Доступ запрещён» при переходе между разделами
Существуют две возможные причины появления ошибки 403 при переходах:
- закончилась активная сессия работы с платформой на вашем устройстве — обновите страницу, чтобы заново залогиниться и продолжить работу;
- у вас нет прав на просмотр данного раздела — обратитесь к администратору аккаунта для уточнения ситуации.
Какому часовому поясу соответствуют дата и время проведенных транзакций?
При работе с панелью управления есть возможность кастомизировать дату и время согласно часовому поясу. Каждый пользователь настраивает часовой пояс у себя в профиле: учтите эту возможность, если в вашей команде есть люди из разных часовых поясов и вы обмениваетесь информацией о транзакциях в процессе работы, используйте уникальные ID платежа — не только дату и время.
Интеграция и взаимодействие с API¶
Что означает REST API в контексте платформы MilkyPay? Какой формат данных используется для запросов и ответов?
REST — это набор архитектурных принципов о проектировании сервисов. Наши API разработаны по принципам REST и используют HTTP-протокол. Каждый ресурс доступен по четко указанному URL-адресу, а коды HTTP-ответов используются для ретрансляции состояния.
Для взаимодействия с ресурсами используются HTTP-запросы GET и POST. Также используется JSON-формат для всех взаимодействий, включая сообщения об ошибках.
Все эти характеристики означают, что вы сможете использовать практически любой язык и готовые наборы разработки для создания и обработки данных и взаимодействия с нашей платформой.
Как получить ключи доступа к API?
Все ключи для интеграции с публичным API и приватным API находятся в настройках аккаунта в разделе «Интеграция» и доступны зарегистрированным пользователям с правами Владельца, Администратора или Разработчика.
Возможные коды статуса
- 201: ОК. Операция завершена успешно.
- 4xx: Создание не удалось. Детали — в резолюции платежа.
- 5xx: Ошибка сервера. Нужен дополнительный запрос к API для прояснения ситуации.
Сохраняется ли CVV при карточных платежах?
MilkyPay выполняет требования платёжных стандартов, согласно которым при обработке транзакций с картой, не предоставляемой клиентом лично, ни в каком виде нельзя сохранять CVV, отправленный клиентом в банк-эмитент при первой попытке платежа.
Поскольку CVV нельзя хранить (и отправлять, соответственно), в случае повторяющихся транзакций от доверенных клиентов есть возможность добавить флаг для оповещения банка-эмитента о том, что CVV не отправляется с этими повторными авторизациями. Обратитесь в нашу службу поддержки для обсуждения параметров, рисков и необходимости включения такой возможности.
Можно ли оставить проверку 3D-Secure только для определенных платежей и стран?
По умолчанию проверка 3DS включена для всех 3DS-карт, вне зависимости от страны. Однако существует возможность добавить флаг для оповещения банка-эмитента, что этот этап аутентификации пропускается при определенных условиях. Обратитесь в нашу службу поддержки для обсуждения параметров, рисков и необходимости включения такой возможности.
Можно ли сохранить номер карты, с которой совершен платеж, чтобы затем пополнить её в случае чарджбека?
Такая возможность доступна в случае, если при создании инвойса платежа для оплаты картой, была включена опция токенизации номера. В таком случае, на вашей стороне будут храниться не номера, а связанные с ними токены, которые затем можно будет использовать для выплат.
Для решения вопросов по возвратам остальных типов платежей вам необходимо обратиться в нашу службу поддержки — мы постараемся помочь вам в кратчайшие сроки.
Есть ли срок действия у токенов?
Токен остается действующим до тех пор, пока не истечет срок действия карты, с которой он связан.
Сколько времени требуется платформе для обработки запроса и ответа?
В среднем MilkyPay отвечает в течение одной-двух секунд. Немного больше времени требуется только при опросе цепочки платежных платформ сторонних провайдеров.
Полученная резолюция по транзакции «OK», а статус указывает на ошибку или незавершенный процесс?
Резолюция — это уточнение к статусу, но они не зависят напрямую. Резолюция OK
означает, что процесс завершен в рамках основного сценария. Обратитесь к нашей службе поддержки для воспроизведения ошибки и решения проблемы.
Общий перечень возможных резолюций можно посмотреть в статье про Обработку платежа.
Можно ли отправлять более одной транзакции возврата средств по одному и тому же платежу в один день?
Да, вы можете отправлять запрос на частичный рефанд по одной транзакции несколько раз в течение одного и того же дня. Однако учтите, что банковские правила некоторых стран (например, Аргентины, Бразилии, Мексики) могут накладывать ограничения на проведение нескольких транзакций с рефандом на один счет.
Как убедиться, что возврат (рефанд) осуществлен успешно?
Запросы на возврат средств выполняются как запросы на обратный платеж и занимают несколько рабочих дней в зависимости от страны и платежного провайдера, используемого для зачисления средств на счет клиента.
Вы получите в Callbacks статус refunded
или partially_refunded
, в зависимости от типа запроса на рефанд, когда процесс будет успешно завершен.
Вопросы безопасности¶
Требуется ли вносить мой IP в белый список доступа к API?
Настройка белого списка IP не обязательна для обращения к REST API.
Однако для усиления безопасности доступа и в качестве дополнительной проверки необходимо указать в настройках интеграции доверенные IP-адреса.
MilkyPay Checkout¶
Как адаптировать платежную страницу для разных устройств?
MilkyPay Checkout спроектирована с учетом адаптивного дизайна, поэтому вы можете не задумываться о типах девайсов, на которых она будет отображаться. Страница автоматически подстроится под размеры и ориентацию экрана пользователя.
Если же вы используете собственную платежную страницу, вы сможете создать определенные версии страницы платежей для определенных устройств и настроить взаимодействие через наши API для каждого из этих различных вариантов.
Можно ли скрыть хедер, футер или другие элементы базового дизайна Checkout?
Вы можете скрыть любой из элементов, кроме основного — сетки доступных клиенту методов оплаты.
Протестируйте возможности отображения Checkout в панели управления, в разделе Sandbox и подберите оптимальный для вас вариант.
В каких браузерах поддерживается отображение Checkout?
Мы гарантируем поддержку и корректную работу Checkout для:
-
десктопных браузеров:
- Google Chrome версии 41 и выше
- Mozilla Firefox версии 43 и выше
- Safari версии 8 и выше
- Opera версии 12 и выше
- Microsoft Edge версии 14 и выше
- Internet Explorer версии 11 и выше
-
мобильных браузеров:
- Google Chrome версии 41 и выше
- Mozilla Firefox версии 15 и выше
- Safari версии 9 и выше
- Samsung Internet версии 8.2 и выше
- Amazon Silk версии 72 и выше
В браузерах не из списка Checkout также работает, но может отсутствовать полная совместимость.
Не нашли ответа на свой вопрос?
Задайте его нашей службе поддержки , мы всегда готовы помочь!