что такое push код в киви
QIWI Push
Обзор
Характеристика
| Тип платёжного метода | платежи с использованием электронных кошельков |
|---|---|
| Регионы использования | RU |
| Валюты платежей | RUB |
| Конвертация валют | – |
| Оплаты | + |
| Выплаты | – |
| Оплаты по сохранённым данным | – |
| Полные возвраты | – |
| Частичные возвраты | – |
| Опротестования | – |
| Особенности | – |
| Организация и стоимость подключения | по согласованию с курирующим менеджером ECommPay |
Схема работы
Основные операции
Сценарии использования
Рис.: Пополнение лицевого счёта
Детальные сведения о том, что необходимо делать со стороны мерчанта для проведения платежей, а также о том, что можно использовать для анализа информации о проведённых платежах и операциях, представлены далее.
Пополнение лицевого счёта
Общая информация
При пополнении лицевого счёта с использованием платёжного метода QIWI Push со стороны веб-сервиса необходимо:
Рис.: Пополнение лицевого счёта
Информация о формате запросов и параметрах инициирования пополнения лицевого счёта при работе с методом QIWI Push и о формате оповещений о результатах пополнения лицевого счёта приведена далее.
Формат запросов
При работе с запросами на проверку существования лицевого счёта пользователя необходимо учитывать следующее:
Рис.: Пример запроса на проверку существования лицевого счёта пользователя
| Код | Описание |
|---|---|
| 0 | Операция успешна |
| 400 | Ошибка подписи |
| 404 | Лицевой счёт пользователя не существует |
| 500 | Общая ошибка, причина должна быть описана в необязательном параметре errors.message |
Рис.: Пример ответа на запрос
При работе с запросами на получение идентификатора платежа необходимо учитывать следующее:
Рис.: Пример запроса на получение идентификатора платежа на стороне веб-сервиса
| Код | Описание |
|---|---|
| 0 | Операция успешна |
| 400 | Ошибка подписи |
| 404 | Лицевой счёт пользователя не существует |
| 500 | Общая ошибка, причина должна быть описана в необязательном параметре errors.message |
Рис.: Пример ответа на запрос
Формат оповещений
Для оповещений о результатах пополнения лицевого счёта с применением метода QIWI Push используется стандартный формат, описание которого представлено в разделе Оповещения.
Рис.: Пример оповещения о пополнении лицевого счёта
Анализ результатов проведения платежей
Также можно выгружать нужную информацию для последующего анализа с помощью специализированных аналитических средств сторонних разработчиков:
Что такое Push в киви кошельке?
QIWI Push — платёжный метод для проведения платежей с использованием электронного кошелька QIWI. При работе с этим методом поддерживается пополнение лицевых счетов пользователей в веб-сервисе мерчанта через сервис QIWI Push.
Как отключить информационные услуги киви?
Как отключить? Отключить SMS-оповещение вы также можете в настройках. Нажмите на переключатель напротив «SMS-оповещения», и услуга отключится автоматически в конце месяца.
Почему не приходят смс на телефон с киви?
Если вы не получили SMS от QIWI, следует проверить несколько пунктов: Является ли ваша SIM-карта активной Баланс на вашем счету положительный Память SMS-сообщений на вашем телефоне не заполнена
Как убрать код подтверждения в киви?
Как отключить СМС подтверждения Qiwi
Как удалить аккаунт в киви?
Удаление кошелька происходит автоматически по истечении 366 дней со дня последней транзакции или пополнения баланса. Если вы хотите удалить кошелек быстрее, то авторизуйтесь в QIWI Кошельке и заполните форму ниже, которая будет доступна после авторизации.
Как позвонить в киви кошелек Казахстан?
При возникновении вопросов при оплате, Вы можете обратиться к специалистам службы поддержки QIWI по телефонам 8-727-356-12-12 или 8-777-773-14-14 (звонок для абонентов Билайн бесплатный). Мы уверены, что оплаты через самые популярные и доступные способы сделают Ваше сотрудничество с Hoster.KZ еще удобнее и приятнее!
Что делать если не приходит смс с кодом?
Не приходит смс с кодом. Что делать?
Как восстановить доступ к киви кошельку?
Почему я не могу войти в киви кошелек?
Не стоит паниковать, следуйте простому алгоритму действий: Необходимо проверить правильность раскладки клавиатуры. Убедитесь что не включен6а клавиша Caps Lock; После проверки выполните повторный ввод данных. Зайдите на qiwi с другого браузера. …
Как подтвердить перевод денег на киви?
Как активировать Киви Кошелек в Казахстане?
Входим на сайт qiwi.kz или qiwi.com, нажимаем «Создать кошелек».
Что нужно для создания киви кошелька?
Зарегистрировать QIWI Кошелек можно всего за 1 минуту на сайте, в мобильном приложении или в QIWI Терминале. Просто укажите номер своего мобильного телефона и получите SMS с паролем для входа в кошелек.
Как перевести деньги с киви на телефон через смс?
Перевести деньги другому пользователю.
Отправьте на номер 7494 SMS с текстом perevod или перевод, через пробел укажите номер кошелька и сумму перевода. Например: perevod 9161234567 500. Вы получите SMS с одноразовым кодом – перешлите его в ответ.
Как пополнить счёт на киви кошельке?
Как можно приобрести киви кошелек?
На главной странице сайта Киви находим опцию «Создать кошелек»:
SMS-подтверждение операций в QIWI
В платежной системе КИВИ есть много полезных функций, которые повышают безопасность денежных онлайн-переводов и защиту платежей. Одна из них это подтверждение транзакций с помощью смс-сообщений.
Эта опция заключается в генерации одноразовых кодов для цели подтверждения операций пользователей. При этом такие пароли практически невозможно угадать, так как они определяются случайным образом без какого-либо заданного алгоритма. При совершении оплаты секретный код отправляется на мобильный пользователя QIWI Кошелька в виде сообщения SMS, который вводится им в специальном поле.
Данный функционал позволяет получить значительную степень защиты электронных денежных средств на счете кошелька, так как даже если хакеры и смогут узнать пароль аккаунта и взломать его, то получить доступ к деньгам у них не получится, так как смски им будут недоступны и отключить их также будет невозможно без доступа к телефону.
Активировать SMS-подтверждения можно в любое время также как и, при необходимости, отключить их. При создании кошелька КИВИ этот механизм защиты включен по умолчанию и он абсолютно бесплатен, а деактивировать его крайне не рекомендуется.
Как подключить или отключить СМС-коды в Visa QIWI Кошельке
В личном кабинете в верхнем меню кликните ссылку «Настройки» и затем в левом столбце найдите раздел под названием «Настройки безопасности». Здесь нужно будет убрать или установить галочку в квадратике «Подтверждение платежей по SMS» и подтвердить свои действия кодом из поступившего сообщения.
Итак, чтобы максимально защитить и обезопасить свои средства и контролировать их движение «в режиме онлайн», подключите в КИВИ Кошельке бесплатное SMS-подтверждение платежей.
Общие принципы протокола
Взаимодействие инофрмационных систем QIWI и провайдера строится в режиме «запрос-ответ», где инициатором запроса всегда является QIWI, а отвечающей стороной – провайдер.
Каждый платеж в QIWI имеет уникальный идентификатор, который передается в каждом запросе. По этому идентификатору производится дальнейшая сверка взаиморасчетов и решение спорных вопросов.
При обработке запроса от QIWI провайдер должен выполнить требуемую операцию, а затем передать в ответе данные (если это требуется) и код выполнения операции.
Требования к интерфейсу провайдера
Процесс платежа
В процессе платежа информационная система QIWI последовательно выполняет следующие шаги:
Обработку запросов на каждом из этих шагов провайдеру необходимо реализовать на своей стороне. При этом необходимо соблюдать правила обработки запросов.
Описание операций
Запрос check
При получении запроса check провайдер должен проверить наличие в своей базе абонента с указанным идентификатором и выполнить внутренние проверки идентификатора и суммы платежа в соответствии с принятой логикой пополнения лицевых счетов через платежные системы.
Параметры запроса
Пример запроса с дополнительными параметрами
Параметры ответа
Пример ответа с дополнительными параметрами
Запрос pay
При получении запроса pay провайдер должен произвести пополнение баланса абонента.
Параметры запроса
Пример запроса с дополнительными параметрами
Параметры ответа
Пример ответа с дополнительными параметрами
Ежедневная сверка
До 10:00 по московскому времени система генерирует и отправляет по указанному адресу электронный реестр принятых платежей за предыдущий день.
Реестр является текстовым файлом и имеет следующую структуру:
Первая строка содержит заголовок:
Transaction date (Moscow);Report date;Type;Transaction number;Transaction currency ID;Transaction amount;Merchant’s comment;Merchant’s transaction/invoice number;Invoice date of issue;QW ID;Account;Refund ID
Вторая и последующие строки содержат данные:
27.02.2019 00:04:00;27.02.2019 00:00:00;Payment;3464968912;RUB;10.34;;;;;test@example.org;;
27.02.2019 00:11:00;27.02.2019 00:00:00;Payment;3464974548;EUR;4.72;;;;;ABC-12345;;
Информационная система QIWI включает в реестр только успешно проведенные платежи.
Подтвержденными считаются платежи, которые поступили как в онлайн-обмене сообщениями, так и в реестре.
Дополнительные возможности авторизации запросов
В заявке на подключение провайдер может задать идентификатор (логин) и секретный пароль к нему, используемые для авторизации при запросах от QIWI.
Также поддерживается авторизация запросов от QIWI по клиентскому SSL-сертификату. Укажите необходимость такой авторизации в заявке на подключение.
Правила обработки запросов
В списке отдельно отмечены фатальные и нефатальные ошибки:
Например, отсутствие связи с сервером провайдера является нефатальной ошибкой. Отсутствие в ответе тега является фатальной ошибкой.
Общие принципы протокола
Взаимодействие сервиса QIWI Wallet и провайдера строится в режиме «запрос-ответ», где инициатором запроса всегда является QIWI Wallet, а отвечающей стороной – провайдер.
Каждый платеж в сервисе QIWI Wallet имеет уникальный идентификатор, который передается в каждом запросе. По этому идентификатору производится дальнейшая сверка взаиморасчетов и решение спорных вопросов.
При обработке запроса от сервиса QIWI Wallet провайдер должен выполнить требуемую операцию, а затем вернуть в ответе данные (если это требуется) и результат выполнения операции.
Для поддержки расширяемости и сохранения работоспособности сервиса провайдера в период включения различных функций, предусмотренных протоколом (например, включение передачи новых реквизитов платежа), предполагается, что провайдер не препятствует появлению в запросах новых HTTP-параметров.
Гарантируется, что появление новых параметров в запросах не приведет к необходимости изменения обработки запросов со стороны провайдера, за исключением случаев, когда такое изменение логики было согласовано с провайдером.
Требования к интерфейсу провайдера
Процесс платежа
В процессе платежа система QIWI Wallet последовательно выполняет следующие шаги:
Обработку запросов на каждом из этих шагов провайдеру необходимо реализовать на своей стороне. При этом необходимо соблюдать правила обработки запросов.
Описание операций
Запрос getInfo
Параметры запроса
| Параметр | Формат | Условие | Описание |
|---|---|---|---|
| command | getInfo | Обязательно | Идентификация типа запроса: запрос на получение дополнительных данных платежа для абонента. Всегда равен getInfo |
| account | Строка, содержащая буквы, цифры и спецсимволы, длиной до 200 символов | Обязательно | Уникальный идентификатор абонента в информационной системе провайдера (номер лицевого счета, телефона, логин и т.д.). Перед отправкой провайдеру, идентификатор проходит проверку корректности в соответствии с регулярным выражением, которое предоставляет провайдер при подключении |
| prvId | Целое число | Обязательно | Идентификатор сервиса в общей системе провайдера |
| parameter_name | Формат имени и значения параметров указывается провайдером при подключении | Опционально | Дополнительные параметры для идентификации абонента |
Параметры ответа
Запрос check
При получении запроса check провайдер должен проверить наличие в своей базе абонента с указанным идентификатором и выполнить внутренние проверки идентификатора, суммы платежа в соответствии с принятой логикой пополнения лицевых счетов через платежные системы.
Параметры запроса
Пример запроса с дополнительными параметрами
Параметры ответа
| Тег | Условие | Описание |
|---|---|---|
| osmp_txn_id | Обязательно | Идентификатор транзакции в QIWI Wallet ( txn_id из запроса) |
| prv_txn | Обязательно | Уникальный номер операции пополнения баланса абонент в системе провайдера |
| sum | Обязательно | Параметр sum из запроса |
| ccy | Обязательно | Параметр ccy из запроса |
| result | Обязательно | Код результата операции ( 0 в случае возможности принятия платежа) |
| comment | Опционально | Комментарий к операции |
Запрос pay
При получении запроса pay провайдер должен произвести пополнение баланса абонента.
Параметры запроса
Параметры ответа
| Тег | Условие | Описание |
|---|---|---|
| osmp_txn_id | Обязательно | Идентификатор транзакции в QIWI Wallet ( txn_id из запроса) |
| prv_txn | Обязательно | Уникальный номер операции пополнения баланса абонент в системе провайдера |
| sum | Обязательно | Параметр sum из запроса |
| ccy | Обязательно | Параметр ccy из запроса |
| result | Обязательно | Код результата операции ( 0 в случае возможности принятия платежа) |
| field name=»prv-date» | Обязательно | Дата и время принятия платежа в системе провайдера в формате ГГГГ-ММ-ДД T ЧЧ:ММ:СС (например, 2011-02-03T00:00:07). Эта дата используется для бухгалтерских взаиморасчетов. |
| comment | Опционально | Комментарий к операции |
Ежедневная сверка
До 10:00 по московскому времени система генерирует и отправляет по указанному адресу электронный реестр принятых платежей за предыдущий день.
Реестр имеет следующую структуру:
Первая строка содержит заголовок:
Transaction date (Moscow);Report date;Type;Transaction number;Transaction currency ID;Transaction amount;Merchant’s comment;Merchant’s transaction/invoice number;Invoice date of issue;QW ID;Account;Refund ID
Вторая и последующие строки содержат данные:
27.02.2019 00:04:00;27.02.2019 00:00:00;Payment;3464968912;RUB;10.34;;;;;test@example.org;;
27.02.2019 00:11:00;27.02.2019 00:00:00;Payment;3464974548;EUR;4.72;;;;;ABC-12345;;
Сервис QIWI Wallet включает в реестр только успешно проведенные платежи.
Подтвержденными считаются платежи, которые поступили как при онлайн-обмене сообщениями, так и в реестре.
Если в реестре отсутствуют платежи, которые проведены в базе провайдера, или содержатся платежи, которых нет в базе провайдера, или при неполучении реестра необходимо связаться с контактным лицом QIWI, указанным в договоре, до 12:00 для выяснения ситуации и принятия решения.
Дополнительные возможности авторизации запросов
В заявке на подключение провайдер может указать идентификатор (логин) и секретный пароль к нему для авторизации запросов от QIWI Wallet.
Эти авторизационные данные будут передаваться по стандартным правилам basic-аутентификации при запросах по HTTP(S):
В заголовке указывается строка Basic (с пробелом на конце) и пара «логин:пароль», закодированная в BASE64:
Также поддерживается авторизация запросов от QIWI по клиентскому SSL-сертификату. Для использования такой авторизации приложите клиентский сертификат для QIWI Wallet в формате PKCS12 в заявке на подключение.
Заявка на подключение (образец)
Юридическое наименование организации провайдера (как в договоре).
Короткое название провайдера (для отображении в клиентском интерфейсе).
Приглашение для ввода пользователя (для отображении в клиентском интерфейсе) (например «Введите номер»).
URL платежного приложения (например, https://yourservice.prv.ru:8443/payment_app).
Логин и пароль, если требуется basic-авторизация.
E-mail адрес для отправки ежедневных реестров.
Размер вознаграждения в %, перечисляемый QIWI Wallet за каждый платеж.
Регулярное выражение для проверки правильности идентификатора.
Несуществующий идентификатор в системе провайдера (данный идентификатор должен удовлетворять регулярному выражению, проверяющему правильность идентификаторов, но не должен существовать в системе; он будет использоваться при тестировании подключения, платежи на данный идентификатор во взаиморасчетах участвовать не будут).
Тестовые (минимум два) идентификаторы в системе провайдера (данные идентификаторы будут использоваться при тестировании подключения, платежи на данный идентификатор во взаиморасчетах участвовать не будут).
Серверный сертификат провайдера в формате X.509.
E-mail адрес для обращений в случае технических проблем в работе шлюза.
Дополнительные реквизиты платежа.
| Техническое название параметра | Название, отображаемое пользователю | Описание | Регулярное выражение | Маска ввода данных |
|---|---|---|---|---|
| valid_thru | Срок истечения карты | Месяц и год истечения срока действия карты. Месяц и год включаются в срок действия карты. | \d<2>/\d | dd/dd |
Правила обработки запросов
Знак + в столбце «фатальность» указывает на признак фатальности ошибки. Для системы QIWI Wallet фатальная ошибка означает, что повторная отправка запроса с теми же параметрами приведет к 100% повторению той же ошибки – следовательно, система прекращает обработку клиентского запроса и завершает его с ошибкой.
Нефатальная ошибка означает для системы, что повторение запроса с теми же параметрами через некоторый промежуток времени, возможно, приведет к успеху. Сервис QIWI Wallet будет повторять запросы, завершающиеся нефатальной ошибкой, постоянно увеличивая интервал, пока операция не завершится успехом или фатальной ошибкой, либо пока не истечет срок жизни запроса – 24 часа.
Отсутствие связи с сервером провайдера является нефатальной ошибкой.