Как узнать номер КИВИ-кошелька — номер счета, реквизиты QIWI

Содержание

Как пополнить QIWI-кошелек?

Чтобы пользоваться Киви-кошельком, нужно его пополнить. Сделать это просто – для удобства пользователей предусмотрено несколько способов пополнения:

  • через терминалы,
  • через интернет-банк,
  • с пластиковой карты.

Пополнение через терминалы

Всего есть несколько видов терминалов, через которые вы можете перечислить деньги на счет своего QIWI-кошелька: терминалы QIWI, которые можно назвать официальными терминалами системы, терминалы партнеров QIWI и терминалы других фирм. Это один из простейших методов пополнения кошелька. При этом при пополнении счета на сумму от 1 501 рубля в фирменных терминалах комиссия взиматься не будет.

Чтобы пополнить счет через терминал QIWI, нужно:

  • Найдите терминал QIWI и кликните кнопку «QIWI кошелек».
  • Нажмите кнопку «Пополнить кошелек».
  • В открывшемся окне введите номер телефона, на который зарегистрирован аккаунт Киви.
  • Перепроверьте правильность номера и нажмите «Далее».
  • Вставьте купюры в приемник.

Деньги будут зачислены на ваш счет мгновенно. Распечатанный терминалом чек следует сохранить до зачисления средства на ваш счет – он может пригодиться в случае, если перевод по каким-то причинам не был совершен в течение 24 часов. Если это все-таки произошло, обратитесь в службу поддержки по номеру, указанному на чеке.

Пополнение через Сбербанк Онлайн и другие банкинг-сервисы

Услугами Сбербанка РФ пользуются многие россияне, и потому не удивительно, что перевод через Сбербанк Online – один из самых распространенных способов пополнить счет QIWI-кошелька.

Если у вас есть карта Сбербанка и доступ в Сбербанк Онлайн, вы можете перевести деньги на счет:

  • перейдите в раздел «Платежи и переводы»,
  • выберите пункт «QIWI кошелек»,
  • укажите номер телефона, к которому привязан кошелек и нажмите «Продолжить»,
  • в появившемся поле введите необходимую сумму и выберите карту, с которой хотите совершить перевод, нажмите «Продолжить»,
  • Подтвердите операцию с помощью одноразовых СМС-паролей.

Для владельцев карт других банков схема может отличаться одним-двумя пунктами меню. Переводы на Киви кошелек могут находиться в меню «Электронные кошельки» и «Другое».

Пополнение Киви-кошелька с карты

Есть несколько способов пополнить счет QIWI с помощью карты:

  • через официальный сайт QIWI,
  • через банкоматы,
  • через систему Сбербанк Online и другие банкинг-сервисы.

Пополнение пластиковой картой с официального сайта QIWI

Для транзакции вам необходимо знать номер карты, состоящий из 15 знаков, срок ее действия и CVC-код – вся эта информация указана на самой карте. Стоит отметить, что система Qiwi принимает карты VISA, MasterCard и МИР.

  • Зайдите на сайт QIWI и выберите пункт «Пополнение кошелька».
  • Из предложенных вариантов пополнения воспользуйтесь «Картой любого банка».
  • Укажите данные карты.
  • Введите необходимую сумму и нажмите «Оплатить».

Пополнение пластиковой картой через банкомат

У каждого банка свои банкоматы со своими уникальными интерфейсами, однако схема пополнения, по сути, для каждого одинакова. Порядок действий примерно таков:

  • Вставьте карту в банкомат и наберите свой пинкод, чтобы попасть в основное меню.
  • Найдите пункт «Оплата услуг», в котором вам потребуется меню «Электронная коммерция» или «Другое».
  • Среди перечисленных систем найдите систему QIWI.
  • Укажите номер телефона, к которому привязан кошелек, введите требуемую сумму и подтвердите перевод.
  • Полученный чек сохраните до подтверждения зачисления средств на счет QIWI.

Киви-кошелек на телефоне

Смартфоны – еще один удобный вариант управления Киви-кошельком. Приложение QIWI кошелек поддерживает многие возможности сайта, поэтому, установив его на свой смартфон, вы сможете не только зарегистрироваться в системе, но и управлять своими финансами, не дожидаясь момента, когда вы окажетесь у компьютера.

Чтобы установить программу, найдите Киви-кошелек в магазине, поддерживаемом вашим смартфоном – для устройств на iOS это AppStore, для Android – Google Play.

  • Откройте программу и выберите пункт «Регистрация».
  • Введите номер мобильного телефона.
  • Придумайте пароль – он должен быть сложным и состоять из цифр и латинских букв, при этом вы должны легко его запомнить.
  • Подтвердите пароль и дождитесь СМС с кодом активации, который необходимо ввести, чтобы попасть на главную страницу приложения.

Для входа в уже существующий Киви-кошелек необходимо ввести телефон, пароль и код подтверждения.

Установив Киви-кошелек на свой телефон, вы сможете использовать все функции, доступные для вашего пользовательского пакета в браузерной версии.

Пополнить кошелек через приложение очень просто.

  • Откройте приложение QIWI-кошелек,
  • найдите пункт «Пополнить»,
  • в открывшемся меню выберите подходящий вам способ пополнения,
  • введите необходимую сумму перевода и подтвердите перевод.

Способов пополнения всего четыре:

  • банковской картой, если у вас имеется таковая, можно пополнить счет Киви-кошелька через приложение;
  • наличными – выбрав этот пункт, вы увидите все ближайшие пункты пополнения;
  • интернет банк – приложение выдаст список всех доступных финансовых учреждений. Если среди них представлен банк, в котором вы обслуживаетесь, выберите это вариант;
  • с баланса телефона – если на счету вашего телефона достаточно денег, вы можете перевести их на счет Киви-кошелька.

Пополнение по банковским реквизитам

Банковский перевод — выгодный и удобный способ пополнения QIWI Кошелька. Перевод можно оформить в банковском отделении или прямо из дома с помощью интернет-банка. С зачисления — до 3 рабочих дней. Комиссия зависит от вашего банка. Такой вариант пополнения доступен только для физических лиц.

Займы в Киви-кошельке

Хорошо разработанная и безопасная система платежей сделала Киви желанным партнером многих МФО. Услугу онлайн-займа через Киви-кошелек предлагают многие кредитные организации, и часто клиенты платежного сервиса берут в долг именно посредством Киви. Однако всегда стоит проверять кредиторов – прежде, чем обратиться в МФО, узнайте имеется ли у этой организации лицензия.

Для того, чтобы получать займ на счет Киви-кошелька, необходимы:

  • Счет Киви-кошелька,
  • Полностью заполненный профиль,
  • Киви-карта,
  • Активная сим-карта, зарегистрированная на клиента.

Заемщик должен быть совершеннолетним. Кроме того, необходимо указать место работы и источник дохода – этого требуют все кредитные организации.

Есть два способа получения займа на Киви-кошелек:

  • Непосредственно на сайте микроорганизации,
  • С помощью Киви-кошелька.

Если вы нашли подходящую организацию, предлагающую займы на Qiwi-кошелек, вы можете оформить займ прямо на ее сайте. Для этого:

  • Зарегистрируйте аккаунт на сайте организации, предоставляющей кредит.
  • Привяжите этот аккаунт к Киви-кошельку, следуя подсказкам на сайте.
  • Оформите заявку (анкету). Здесь же указывается срок, на который клиент получает деньги, размер займа, способ получения и номер телефона заемщика.
  • Дождитесь рассмотрения заявки – обычно это занимает максимум полчаса.
  • Получите деньги на свой счет Киви.

Через Киви-кошелек получить микрокредит несколько быстрее:

  • В личном кабинете выберите опцию «Пополнение кошелька».
  • Нажмите «Пополнение онлайн-займом».
  • Выберите подходящую организацию (партнерами QIWI являются «Займер», «Е-капуста», «Веб-займ» и «Moneyman»).
  • Оформите заявку, следуя подсказкам на экране.
  • Получите деньги на счет. Также деньги можно получить на банковскую карту или наличными в офисах CONTACT.

Банковские карты QIWI

QIWI предлагает оформить своим клиентам карты, чтобы пользоваться кошельком стало еще удобнее. Предлагается несколько вариантов.

Карта Qiwi payWave (Visa) позволит вам расплачиваться в российских магазинах и кафе с баланса кошелька. Обслуживается карта бесплатно, срок действия – 3 года. Выдача наличных облагается комиссией: 2% + 50 рублей. Заказать карту можно онлайн на сайте QIWI; доставка на почту бесплатная, а за доставку курьером придется доплатить 300 рублей.

Виртуальная карта QIWI подходит для покупок и снятия наличных. Платите виртуальной картой на сайтах, где не принимают QIWI кошелек, но принимают карты Visa. C «Профессиональным» статусом кошелька можно привязать карту к Google Play, Apple Music и PlayStation Store. Если привязать карту к Apple Pay, Google Pay или Samsung Pay, то вы сможете снимать наличные в любом банкомате, где можно осуществлять бесконтактные платежи, а также оплачивать покупки на кассе. Срок действия карты – 1 год; обслуживание карты бесплатно.

Виртуальная карта QIWI Мир для оплаты покупок в онлайн магазинах, в которых принимают карты МИР. Если же привязать карту к смартфону через Mir Pay, то вы сможете пользоваться картой в кафе, ресторанах и магазинах, везде, где принимают карты МИР. Срок действия карты – 3 года, бесплатное обслуживание.

В связи с санкциями в работе QIWI кошелька произошли некоторые изменения, поэтому некоторые зарубежные переводы временно недоступны. Но вы по-прежнему можете:

  • Переводить деньги в рублях на зарубежные QIWI кошельки.
  • Отправлять деньги в некоторые страны через CONTACT (список стран постоянно меняется – проверяйте возможность отправки в форме перевода).
  • Делать покупки на зарубежных сайтах, таких как AliExpress или Joom.
  • Переводить из кошелька деньги на некоторые зарубежные карты и в банки.

Обзор протокола

Протокол приема платежей предоставляет быстрые и безопасные решения для приема и отправки платежей в интернете. Протокол дает вашим покупателям возможность использовать разнообразные методы платежей, включая:

  • Банковские карты Visa, Mastercard, МИР.
  • Yandex Pay.
  • QIWI Кошелек.
  • Система Быстрых Платежей (СБП).
  • Баланс мобильного телефона.
Читать еще:   Как пополнить Киви-кошелек через Сбербанк

Термины и сокращения

Ключ доступа к API — Символьная строка для авторизации мерчанта в API согласно стандарту OAuth 2. 0 RFC 6749 RFC 6750.

Платежный токен — Символьная строка, созданная по данным карты для безакцептных платежей.

API: Application Programming Interface — набор готовых методов, предоставляемых приложением (системой) для использования во внешних программных продуктах.

REST: Representational State Transfer — архитектурный стиль взаимодействия компонентов распределённого приложения в сети.

3DS: 3-D Secure — протокол защиты карточных данных, используемый для аутентификации держателя банковской карты во время совершения платежной операции через интернет. QIWI поддерживает как версию 3DS 1. 0, так и версию 3DS 2. 0 протокола.

ТСП, Мерчант — Торгово-сервисное предприятие.

MPI: Merchant Plug-In — модуль, выполняющий 3DS аутентификацию покупателя.

PCI DSS: Payment Card Industry Data Security Standard — стандарт безопасности данных индустрии платёжных карт, учреждённым международными платёжными системами Visa, MasterCard, American Express, JCB и Discover.

Способы подключения

Протокол приема платежей поддерживает несколько вариантов взаимодействия:

  • Платеж через форму QIWI.
  • Платеж через форму мерчанта.

Типы операций

В Протоколе доступны следующие операции:

  • Счет (Invoice) — электронный документ, выставляемый продавцом покупателю. Содержит информацию о сумме и номере заказа. Не является финансовой сущностью и имеет ограниченный срок жизни. Выставление счета необходимо для получения ссылки на платежную форму QIWI.
  • Платеж (Payment) — операция списания денежных средств от покупателя в пользу продавца. Фактическое списание происходит только после подтверждения (Capture). При работе через платежную форму QIWI, Payment — попытка оплаты счета (Invoice).
  • Завершение (Complete) — завершение 3DS-верификации Покупателя. Используется при работе через Платежную форму мерчанта.
  • Подтверждение (Capture) — операция подтверждения авторизации (списания) средств.
  • Возврат (Refund) — возврат средств покупателю по успешному платежу. Финансовая операция списания денежных средств от продавца в пользу покупателя. Если подтверждения операции Payment не было, то в ответе на операцию Refund вы получите флаг Reversal и деньги со счета Покупателя на счет продавца не перечислятся (комиссия за эквайринг также не удерживается).

Формат взаимодействия

API Протокола приема платежей основано на принципах REST-архитектуры.

Параметры API помещаются в JSON-тело запроса. В GET-запросах параметры помещаются в URL запроса.

API всегда возвращает ответ в формате JSON.

Тестовый режим

При подключении ваш идентификатор siteId находится в тестовом режиме. В этом режиме вы можете проводить операции без списания средств с банковской карты. Также можно запросить переключение в режим тестирования любого своего siteId, либо добавление нового siteId в режиме тестирования через вашего сопровождающего менеджера.

Для тестирования операций оплаты используются URL протокола.

Тестовый режим для метода оплаты с баланса КИВИ Кошелька не предусмотрен.

Когда интеграция на вашей стороне закончена, мы переводим siteId в производственный режим. В этом режиме выполняются реальные списания средств с карт.

При переходе в производственный режим перевыпускать ключ доступа к API не нужно.

Оплата картой в тестовом режиме

В тестовом режиме можно использовать любой номер карты, удовлетворяющий алгоритму Luhn.

Тестовые номера карт

В тестовом режиме из валют (параметр currency) разрешен только рубль РФ (643).

CVV в тестовом режиме может быть любым (произвольные 3 цифры).

Для тестирования различных вариантов оплаты и ответов необходимо использовать различные сроки действия карты:

  • Если месяц срока действия — 02, то операция будет проведена неуспешно.
  • Если месяц срока действия — 03, то операция будет проведена успешно с задержкой в 3 секунды.
  • Если месяц срока действия — 04, то операция будет проведена неуспешно с задержкой в 3 секунды.
  • Во всех остальных случая операция выполняется успешно.

В тестовой среде установлено ограничение на сумму и количество тестовых операций. По умолчанию максимальная сумма тестовых транзакций — 10 рублей. Максимум — 100 транзакций в сутки (учитываются операции за текущие сутки, время по МСК). Учитываются операции с суммой не более установленного лимита.

Для проведения операции с 3DS необходимо использовать строку unknown name в имени держателя карты. Прохождение 3DS в режиме тестирования можно проверить только при вводе номера реальной карты.

Оплата через СБП в тестовом режиме

Для тестирования различных вариантов оплаты и ответов указывайте разные суммы платежа (поле amount):

  • 200 — операция пройдет успешно с задержкой. При первом запросе статуса платежа вы получите статус «WAITING», после второго запроса статуса платежа — статус «SUCCESS».
  • Для других сумм платеж пройдет неуспешно.

Платеж через форму QIWI

При подключении платежей через форму QIWI покупателю доступен только способ оплаты банковскими картами. Другие способы оплаты включаются по запросу:

  • Платежные токены карт.
  • Система быстрых платежей.
  • QIWI Кошелек.

Чтобы выполнить платеж через форму QIWI, выставите счет покупателю. Воспользуйтесь выставлением счета через API или перенаправьте покупателя на форму QIWI по прямой ссылке с параметрами счета.

Процесс платежа

sequenceDiagram
participant customer as Покупатель
participant store as Магазин
participant qb as QIWI (эквайер)
participant ips as Эмитент
customer->>store:Выбор товаров, Старт оплаты
activate store
store->>qb:Выставление счетаОдношаговый платеж — все способы оплатыДвухшаговый платеж — только карты
activate qb
qb->>store:Ссылка на платежную форму QIWI (payUrl)
store->>customer:Переадресация покупателя на payUrl
customer->>qb:Открытие платежной формы,выбор способа оплаты,указание платежных данных для выбранного способа
qb->>customer:Аутентификация покупателя:Для карт — 3-D Secure
customer->>qb:Аутентификация
qb->>ips:Запрос списания денежных средств
activate ips
ips->>qb:Статус операции
qb->>store:Уведомление о статусе операции
qb->>customer: Переадресация на страницу статуса платежа (successUrl)
rect rgb(237, 243, 255)
Note over store, ips:Двухшаговый платеж
store->>qb:Подтверждение операции (capture)
qb->>ips:Подтверждение списания
deactivate ips
qb->>store:Уведомление о подтверждении платежа
end
deactivate qb
deactivate store

Интеграция c Платежной формой QIWI без использования API

Это простой способ интеграции с Платежной формой QIWI. При открытии формы покупателю автоматически выставляется счет. Параметры счета передаются в открытом виде в ссылке на форму. Покупателю отображается платежная форма с выбором способов оплаты.

Для вызова формы в ссылке необходимо указывать ключ PUBLIC_KEY. Для каждого siteId выпускается уникальный ключ. Ключ можно посмотреть в Личном кабинете в разделе Настройки.

При оплате счета, выставленного таким способом, платеж автоматически авторизуется без участия мерчанта. Так как используется двухшаговая схема, то для завершения платежа необходимо выполнить запрос Подтверждение платежа или подтвердить платеж через Личный кабинет.

По умолчанию сервис QIWI ожидает подтверждения платежа в течение 72 часов. По истечении срока выполняется автоматическое подтверждение платежа.

Выставление счета с передачей суммы платежа

Выставление счета без указания суммы платежа (сумму заполняет покупатель)

По умолчанию, после оплаты счета автоматически выполняется аутентификация покупателя. Завершение аутентификации также происходит автоматически.

Выставление счета и получение ссылки на оплату через API

Пример выставления счета с оплатой через холдирование (двухшаговый платеж)

Пример выставления счета с оплатой без авторизации Покупателя (одношаговый платеж)

Пример уведомления об оплате счета

Протокол приема платежей поддерживает выставление счетов с оплатой двухшаговым платежом с холдированием средств на карте покупателя, так и одношаговым платежом без авторизации покупателя.

  • ключ API;
  • сумму счета (amount);
  • дату, до которой необходимо оплатить счет (expirationDateTime);
  • информация о покупателе (customer, address) и получателе платежа (receiverData);
  • дополнительные данные по операции (customFields).
  • Перенаправьте покупателя на Платежную форму по ссылке из параметра payUrl ответа.
  • Дождитесь завершения платежа: вам придет уведомление, или периодически отправляйте запрос API Статус счета, чтобы получить информацию о платеже.

Для двухшагового сценария (платеж с холдированием средств) требуется выполнить подтверждение платежа. Возмещение формируется только после подтверждения.

Чтобы подтвердить платеж в двухшаговом сценарии:

  • Получите идентификатор платежа paymentId:
  • Отправьте запрос API Подтверждение платежа с полученным paymentId.

Платежный токен

Выставление счета с оплатой платежным токеном

Платежные токены используются для списаний с карт или QIWI кошельков без ввода реквизитов карты или номера кошелька. Метод оплаты платежным токеном по умолчанию отключен. Чтобы подключить его, обратитесь к вашему сопровождающему менеджеру.

О выпуске платежного токена читайте в разделе по ссылке.

Чтобы выставить счет для оплаты платежным токеном:

  • Передайте в запросе API Создание счета следующую информацию:
    ключ API;сумму счета (amount);дату, до которой необходимо оплатить счет (expirationDateTime);идентификатор покупателя, для которого был выпущен платежный токен, в параметре customer.account. Без этого параметра оплата платежным токеном невозможна.(опционально) другую информацию о счете.
  • ключ API;
  • сумму счета (amount);
  • дату, до которой необходимо оплатить счет (expirationDateTime);
  • идентификатор покупателя, для которого был выпущен платежный токен, в параметре customer.account. Без этого параметра оплата платежным токеном невозможна.
  • (опционально) другую информацию о счете.
  • Перенаправьте покупателя на Платежную форму по ссылке из параметра payUrl ответа.
  • Если для покупателя был выпущен один или несколько платежных токенов, то на Платежной форме отобразится список его привязанных карт.Для оплаты покупателю достаточно выбрать одну из своих привязанных карт. При этом не понадобится указывать карточные данные и проходить проверку 3-D Secure.
Читать еще:   Как Удалить Свою Карту Из Гугл Плей? - Электромотоциклы и электроскутеры Skaut

Для списания средств по платежному токену без участия Покупателя воспользуйтесь методом API Платеж. подробнее описание использования платежного токена на Платежной форме мерчанта.

Перенаправление на форму QIWI

Пример ответа с payUrl

Чтобы покупатель смог оплатить выставленный счет, перенаправьте его на Платежную форму по ссылке из поля payUrl ответа на запрос выставления счета.

По умолчанию, на Платежной форме QIWI 3-D Secure покупателя обязателен.

Пример ссылки с successUrl

К ссылке можно добавить следующий параметр:

ПараметрОписаниеТипsuccessUrlURL для переадресации в случае успешной оплаты. Переадресация произойдет после успешной 3DS аутентификации. Ссылку необходимо зашифровать в utf-8 формат. URL-закодированная строка

Пример обработчика событий iframe

// Форма загружена

// Попытка платежа

// Платеж прошел успешно

// Платеж не прошел

При открытии ссылки в :

вы можете использовать метод postMessage для отслеживания состояния формы. Возможные значения состояния:

  • INITIALIZED — Форма загружена.
  • PAYMENT_ATTEMPT — Попытка платежа.
  • PAYMENT_SUCCEEDED — Платеж прошел успешно.
  • PAYMENT_FAILED — Платеж не прошел.
  • INITIALIZATION_FAILED — Ошибка загрузки формы.

Настройка Платежной формы

  • уникальный псевдоним стиля, привязанный к идентификатору siteId (цифры, латинские буквы и символ дефиса -);
  • название мерчанта, которое будет отображаться на форме;
  • краткое описание деятельности (не более 120 символов);
  • лого в формате PNG или SVG и размера 310×36 или пропорционально больше;
  • цвет фона и цвет кнопок в HEX-формате.

Необязательные данные для настройки:

  • картинка для фона в формате PNG или SVG и размера 382×560 или пропорционально больше;
  • варианты предвыбранных сумм платежа (не более трех);
  • контактный e-mail для отображения на странице;
  • URL страницы успешного платежа;
  • номер счетчика Яндекс.Метрики;
  • ссылка на оферту вашего сервиса.

Пример передачи параметра стиля при выставлении счета через API

Чтобы применить ваш стиль на Платежной форме:

Название псевдонима стиля регистрозависимое.

Пример настройки Платежной формы:

Платеж через форму мерчанта

При подключении платежей через собственную платежную форму по умолчанию сразу доступен способ оплаты Банковские карты. Другие способы оплаты доступны по запросу:

  • Платежные токены карт и QIWI Кошелька.
  • Yandex Pay.
  • Система Быстрых Платежей (СБП).
  • Баланс мобильного телефона

Процесс платежа

sequenceDiagram
participant customer as Покупатель
participant store as Магазин
participant qb as QIWI (эквайер)
participant ips as Эмитент
customer->>store:Выбор товаров, Старт оплаты,ввод платежных данных
activate store
store->>qb:ПлатежОдношаговый платеж — все способы оплатыДвухшаговый платеж — только карты
activate qb
qb->>store:Статус операции, данные для 3DS или QR-код СБП
rect rgb(237, 243, 255)
Note over customer, ips:3-D Secure
store->>customer:Переадресация покупателя на acsUrl или в приложение банка
activate ips
ips->>customer:Аутентификация покупателя:3DS — карты,СБП — подтверждение операции в интерфейсе эмитента карты
customer->>ips:Аутентификация
ips->>store:Результат аутентификации (PaRes)
store->>qb:Завершение аутентификации (complete)
end
qb->>ips:Запрос списания денежных средств
activate ips
ips->>qb:Статус операции
qb->>store:Уведомление о статусе операции
rect rgb(237, 243, 255)
Note over store, ips:Двухшаговый платеж
store->>qb:Подтверждение операции (capture)
qb->>ips:Подтверждение списания
deactivate ips
qb->>store:Уведомление о подтверждении платежа
end
deactivate qb
deactivate store

Чтобы создать платеж, передайте в запросе API Платеж:

  • ключ API;
  • сумму платежа;
  • метод платежа;
  • другую информацию для создания платежа.

Банковская карта

Протокол приема платежей поддерживает как двухшаговый платеж с холдированием средств на карте покупателя, так и одношаговый платеж без авторизации покупателя.

Создание платежа

Пример платежа с холдированием (двухшаговый платеж)

Пример платежа с немедленной оплатой (одношаговый платеж)

Чтобы инициировать платеж с предварительным холдированием средств на карте (двухшаговый платеж), передайте в запросе API Платеж:

  • ключ API;
  • сумму платежа;
  • метод платежа CARD и карточные данные покупателя;
  • другая информация для создания платежа.

В двухшаговом платеже возмещение формируется только после подтверждения платежа.

Ожидание аутентификации покупателя (3-D Secure)

Пример ответа с требованием аутентификации покупателя

Перенаправление для аутентификации 3-D Secure

Завершение аутентификации покупателя

Если требуется 3DS аутентификация покупателя, понадобится пройти дополнительную проверку у эмитента. В этом случае в ответе на запрос платежа добавляется объект requirements. threeDS с полями:

  • acsUrl — URL сервера аутентификации 3-D Secure, для перенаправления на страницу подтверждения от эмитента;
  • pareq — зашифрованный запрос на аутентификацию 3-D Secure.

Чтобы получить результат проверки (PaReS), сделайте POST-запрос на URL сервера аутентификации 3-D Secure с параметрами:

  • TermUrl — URL перенаправления покупателя после успешной аутентификации 3-D Secure;
  • MD — уникальный идентификатор транзакции;
  • PaReq — значение параметра pareq из ответа на платежный запрос.

Чтобы сохранять обратную совместимость, использование протокола 3-D Secure 1. 0 или 3-D Secure 2. 0 не влияет на вашу интеграцию с API.

Информация о покупателе передаётся в платежную систему карты. Банк-эмитент либо предоставляет разрешение на списание средств без аутентификации (frictionless flow), либо принимает решение о необходимости аутентификации с помощью одноразового пароля (challenge flow). После прохождения проверки покупатель перенаправляется по адресу TermUrl с зашифрованным результатом проверки в параметре PaRes.

Чтобы завершить аутентификацию покупателя, передайте в запросе API Завершение аутентификации клиента:

  • уникальный ID мерчанта;
  • номер платежа (параметр paymentId) из ответа на запрос платежа;
  • результат 3-D Secure (значение параметра PaRes).

Подтверждение платежа

Это действие требуется только для двухшагового платежа с холдированием.

Чтобы подтвердить платеж:

  • Получите paymentId платежа:
    Из серверного уведомления после успешного холдирования средств.Из ответа на запрос Статус платежа.
  • Из серверного уведомления после успешного холдирования средств.
  • Из ответа на запрос Статус платежа.
  • Отправьте запрос API Подтверждение платежа с полученным paymentId.

Платежный токен

Использование платежного токена в запросе платежа

Платежные токены используются для списаний с карт или QIWI кошельков без ввода реквизитов карты или номера кошелька. Метод оплаты платежным токеном по умолчанию отключен. Чтобы подключить его, обратитесь к вашему сопровождающему менеджеру.

О выпуске платежного токена читайте в разделе по ссылке.

Чтобы оплатить покупку платежным токеном, передайте в запросе API Платеж:

  • платежный токен в объекте paymentMethod,
  • идентификатор покупателя, для которого был выпущен платежный токен, в параметре customer.account.

ПараметрТипОписаниеpaymentMethod. typeStringТип операции. Только TOKENpaymentMethod. paymentTokenStringСтрока платежного токенаcustomer. accountStringУникальный идентификатор Покупателя в системе ТСП, для которого выпущен платежный токен. Без этого параметра оплата платежным токеном невозможна.

Покупатель не будет указывать свои карточные данные и проходить проверку 3-D Secure.

Yandex Pay

Оплата покупок с Yandex Pay происходит без ввода данных карты.

Для включения способа оплаты Yandex Pay обратитесь к вашему сопровождающему менеджеру.

Как отправлять платеж

Пример платежа с данными расшифрованного платежного токена Yandex Pay (метод CLOUD_TOKEN)

Пример платежа с данными расшифрованного платежного токена Yandex Pay (метод PAN_ONLY)

При отправке платежа, формат платежных данных зависит от способа аутентификации, указанного в поле authMethod расшифрованного платежного токена Yandex Pay:

  • CLOUD_TOKEN. Без дополнительной аутентификации покупателя.Для отправки платежных данных в QIWI передайте в запросе API Платеж объект paymentMethod с параметрами:

    type — всегда CARD;данные из расшифрованного платежного токена Yandex Pay:
    PAN в поле «pan»;срок действия в формате MM/YY в поле «expiryDate»;объект external3dSec с элементами:
    type — всегда YANDEX_PAY;cryptogram — содержимое поля cryptogram платежного токена Yandex Pay(Base64-закодированная строка);eciIndicator — ECI индикатор. Необходимо передавать, если поле eciIndicator получено в платежном токене Yandex Pay. В противном случае параметр не передавать.

  • type — всегда CARD;
  • данные из расшифрованного платежного токена Yandex Pay:
    PAN в поле «pan»;срок действия в формате MM/YY в поле «expiryDate»;объект external3dSec с элементами:
    type — всегда YANDEX_PAY;cryptogram — содержимое поля cryptogram платежного токена Yandex Pay(Base64-закодированная строка);eciIndicator — ECI индикатор. Необходимо передавать, если поле eciIndicator получено в платежном токене Yandex Pay. В противном случае параметр не передавать.
  • PAN в поле «pan»;
  • срок действия в формате MM/YY в поле «expiryDate»;
  • объект external3dSec с элементами:
    type — всегда YANDEX_PAY;cryptogram — содержимое поля cryptogram платежного токена Yandex Pay(Base64-закодированная строка);eciIndicator — ECI индикатор. Необходимо передавать, если поле eciIndicator получено в платежном токене Yandex Pay. В противном случае параметр не передавать.
  • type — всегда YANDEX_PAY;
  • cryptogram — содержимое поля cryptogram платежного токена Yandex Pay(Base64-закодированная строка);
  • eciIndicator — ECI индикатор. Необходимо передавать, если поле eciIndicator получено в платежном токене Yandex Pay. В противном случае параметр не передавать.
  • PAN_ONLY. С дополнительной аутентификацией покупателя (3-D Secure).Для отправки платежных данных в QIWI передайте в запросе API Платеж объект paymentMethod с параметрами:

    type — всегда CARD;данные из расшифрованного платежного токена Yandex Pay:
    PAN в поле «pan»;срок действия в формате MM/YY в поле «expiryDate»;объект external3dSec с полем type, всегда равным YANDEX_PAY.

  • type — всегда CARD;
  • данные из расшифрованного платежного токена Yandex Pay:
    PAN в поле «pan»;срок действия в формате MM/YY в поле «expiryDate»;объект external3dSec с полем type, всегда равным YANDEX_PAY.
  • PAN в поле «pan»;
  • срок действия в формате MM/YY в поле «expiryDate»;
  • объект external3dSec с полем type, всегда равным YANDEX_PAY.

Оплата через СБП

Протокол приема платежей поддерживает списание средств с покупателя через Систему быстрых платежей (СБП). Через СБП можно выполнять платежи в пользу юридических лиц, в том числе с использованием QR-кодов.

По умолчанию прием оплаты через СБП отключен. Чтобы подключить этот способ оплаты, обратитесь к вашему сопровождающему менеджеру.

Получение QR-кода

Пример тела запроса для платежа через СБП

«Flower for my girlfriend»

Пример ответа c QR-кодом

«Flower for my girlfriend»

Чтобы покупатель смог произвести оплату через СБП, выпустите QR-код. Для этого отправьте запрос API Получение QR-кода СБП. В запросе укажите:

  • Объект qrCode с характеристиками запрашиваемого QR-кода:
    Тип QR-кода в параметре qrCode.type:
    DYNAMIC — динамический QR-код, индивидуальный для каждой оплаты.STATIC — статический QR-код, формируется один раз, удобно для товаров с фиксированной ценой.
    Срок действия кода в минутах в параметре qrCode.ttl. Указывается только для qrCode.type=DYNAMIC. По умолчанию динамический QR-код активен в течение 72 часов, по истечении срока деактивируется.Тип и размер изображения QR-кода в блоке qrCode.image.
  • Тип QR-кода в параметре qrCode.type:
    DYNAMIC — динамический QR-код, индивидуальный для каждой оплаты.STATIC — статический QR-код, формируется один раз, удобно для товаров с фиксированной ценой.
  • DYNAMIC — динамический QR-код, индивидуальный для каждой оплаты.
  • STATIC — статический QR-код, формируется один раз, удобно для товаров с фиксированной ценой.
  • Срок действия кода в минутах в параметре qrCode.ttl. Указывается только для qrCode.type=DYNAMIC. По умолчанию динамический QR-код активен в течение 72 часов, по истечении срока деактивируется.
  • Тип и размер изображения QR-кода в блоке qrCode.image.
  • Сумму платежа.
  • Чтобы добавить описание платежа, используйте поле запроса paymentPurpose. Если это поле не заполнено, в приложении банка покупателя отобразится название вашего магазина.

В ответе на запрос в объекте qrCode содержатся данные QR-кода:

  • image.content — base64-encoded QR-код. После расшифровки вы получите изображение для отображения покупателю.
  • payload — URL-based QR для перенаправления покупателя в приложение банка.

Статус платежа через СБП

После оплаты платеж перейдет в финальный статус. Актуальный статус платежа по идентификатору paymentUid можно получить через API.

Статус QR-кода

Пример ответа на запрос статуса QR-кода

«Flower for my girlfriend»

Используйте запрос Статус QR-кода СБП. В ответе возвращается информация о QR-коде, в том числе его текущий статус. Так вы можете определить действует ли QR-код.

Выпуск токена для оплаты через СБП

Пример тела запроса выпуска токена СБП

Вы можете выпустить платежный токен СБП для привязки карты покупателя и последующих оплат через СБП.

Чтобы выпустить платежный токен, воспользуйтесь запросом Получение QR-кода СБП. В запросе укажите:

  • Объект qrCode с характеристиками запрашиваемого QR-кода:
    Тип QR-кода в параметре qrCode.type — TOKEN.Тип и размер изображения QR-кода в блоке qrCode.image.
  • Тип QR-кода в параметре qrCode.type — TOKEN.
  • Тип и размер изображения QR-кода в блоке qrCode.image.
  • Сумму платежа.
  • Параметр tokenizationAccount — уникальный идентификатор Покупателя в системе ТСП.
  • Описание токена в параметре tokenizationPurpose.

Необходимо использовать разные параметры tokenizationAccount для разных покупателей, чтобы гарантировать безопасность привязанных карточных данных покупателей.

Вы получите информацию о платежном токене СБП в объекте token ответа.

Оплата токеном через СБП

Пример тела запроса

Чтобы оплатить покупку платежным токеном СБП, передайте в запросе API Платеж токеном СБП:

  • платежный токен в параметре token,
  • идентификатор покупателя, для которого был выпущен платежный токен, в параметре tokenizationAccount.

Оплата со счета мобильного телефона

Оплата покупок со счета мобильного телефона происходит без ввода данных карты. Сразу после инициирования платежа покупатель получает SMS-сообщение от своего мобильного оператора с информацией о платеже и подтверждает или отклоняет оплату ответным SMS.

Для включения этого способа оплаты обратитесь к вашему сопровождающему менеджеру.

Как отправлять платеж

При отправке платежа укажите в блоке paymentMethod в запросе API Платеж параметры:

  • type — всегда MOBILE_COMMERCE.
  • phone — номер телефона, с баланса которого выполняется оплата. Номер указывается в международном формате со знаком +.

Серверные уведомления

Уведомление от QIWI — входящий POST-запрос с информацией о событии. Тело запроса содержит JSON-сериализованные данные платежа/счета (кодировка UTF-8).

Протокол поддерживает следующие типы уведомлений о событиях API:

  • PAYMENT — отправляются при совершении операций платежа;
  • CAPTURE — отправляются при совершении операций подтверждения платежа;
  • REFUND — отправляются при совершении операций возврата платежа;
  • CHECK_CARD — отправляются при совершении операций проверки карты.

Адрес вашего сервера для обработки уведомлений указывается в Личном кабинете в разделе Настройки.

Чтобы указать URL сервера обработки уведомлений для отдельной операции, используйте:

  • параметр callbackUrl — в запросах API Платеж, Подтверждение платежа, Операция возврата;
  • параметр customFields.invoice_callback_url — в запросе API Создание счета.

Сертификат сайта должен быть выпущен доверенным центром сертификации (например Comodo, Verisign, Thawte и т.

Для дополнительной уверенности следует принимать уведомления о платежах только с указанных ниже IP-адресов компании QIWI:

  • 79.142.16.0/20
  • 195.189.100.0/22
  • 91.232.230.0/23
  • 91.213.51.0/24

Частота отправки уведомлений

Сервис отправки уведомлений распределяет неуспешные уведомления по очередям:

  • 1 попытка с отложенным временем 5 секунд
  • 1 попытка с отложенным временем 1 минута
  • 3 попытки с отложенным временем по 5 минут

Время повторной отправки может сдвигаться в бОльшую сторону.

Формат уведомления PAYMENT

ПолеОписаниеТипcaptureОписание подтверждения. ObjecttypeТип операцииString(200)captureIdУникальный идентификатор подтверждения в системе ТСП. String(200)createdDatetimeДата создания операцииURL-закодированная строкаГГГГ-ММ-ДДTЧЧ:ММ:ССZamountИнформация о сумме операцииObjectvalueСумма операции, округленная до двух десятичных знаков в меньшую сторонуNumber(6. 2)currencyИдентификатор валюты операции (Alpha-3 ISO 4217 код)String(3)billIdID счета, соответствующего операцииString(200)statusИнформация о статусе операцииObjectvalueСтроковое значение статусаStringchangedDatetimeДата обновления статусаURL-закодированная строкаГГГГ-ММ-ДДTЧЧ:ММ:ССZreasonCodeКод причины отклоненияString(200)reasonMessageОписание причины отклоненияString(200)errorCodeКод ошибкиNumberpaymentMethodИнформация о средстве платежаObjecttypeТип метода оплатыStringmaskedPanМаскированный PAN картыStringrrnRRN платежа (по ISO 8583)NumberauthCodeAuth-code платежаNumbercustomerИнформация о покупателеObjectphoneНомер телефона покупателяStringemailE-mail покупателяStringaccountИдентификатор покупателя в системе ТСПStringipIP адрес покупателяStringcountryСтрана адреса покупателяStringcustomFieldsПоля с произвольной информацией, дополняющей данные по операцииObjectcf1Поле с произвольной информацией, дополняющей данные по операцииString(256)cf2Поле с произвольной информацией, дополняющей данные по операцииString(256)cf3Поле с произвольной информацией, дополняющей данные по операцииString(256)cf4Поле с произвольной информацией, дополняющей данные по операцииString(256)cf5Поле с произвольной информацией, дополняющей данные по операцииString(256)FROM_MERCHANT_CONTRACT_IDНомер договораString(256)FROM_MERCHANT_BOOKING_NUMBERНомер бронированияString(256)FROM_MERCHANT_PHONEМобильный телефон покупателяString(256)FROM_MERCHANT_FULL_NAMEФИО покупателяString(256)flagsДополнительные команды, переданные в APIМассив. Возможные элементы — SALE/REVERSALtypeТип уведомленияString(200)versionВерсия уведомленийString

Формат уведомления CHECK_CARD

ПолеОписаниеТипcheckPaymentMethodОписание результата проверки картыObjectcheckOperationDateДата проверки картыURL-закодированная строкаГГГГ-ММ-ДДTЧЧ:ММ:ССZrequestUidИдентификатор операции проверки картыStringstatusИнформация о статусе проверки картыStringisValidCardПризнак валидности карты для платежейBoolthreeDsStatusИнформация о статусе дополнительной аутентификации при проверке карты. Возможные значения — PASSED (3-D Secure пройден), NOT_PASSED (3-D Secure не пройден), WITHOUT (3-D Secure не требовалось)StringpaymentMethodИнформация о средстве платежаObjecttypeТип метода оплатыStringmaskedPanМаскированный PAN картыStringcardExpireDateСрок действия картыStringcardHolderИмя держателя картыStringcardInfoИнформация о карте. ObjectissuingCountryКод страны эмитентаString(3)issuingBankБанк-эмитентStringpaymentSystemТип платежной системыStringfundingSourceТип картыStringpaymentSystemProductКатегория картыStringcreatedTokenОбъект с информацией о выпущенном вместе с проверкой карты платежном токенеObjecttokenСтрока платежного токенаStringnameМаскированный PAN карты, для которой выпущен платежный токенStringexpiredDateДата окончания срока действия платежного токена. Формат даты соответствует стандарту ISO-8601:YYYY-MM-DDThh:mm:ss±hh:mmStringaccountИдентификатор покупателя, указанный при выпуске платежного токенаStringtypeТип уведомленияString(200)versionВерсия уведомленийString

Возвраты и отмены

Операции возврата и отмены доступны не для всех способов платежей:

  • Возвраты доступны только для успешно завершенных операций платежа.
  • Отмена операции возможна только при двухшаговом сценарии платежа и только для операций, по которым ещё не было подтверждения (CAPTURE).

При возврате платежа комиссия QIWI за проведение платежа не возвращается. Исключение — если при возврате платежа выполнена операция отмены. В этом случае финансовой операции (списания средств со счета покупателя) не происходит и комиссия не взимается.

Возвраты по оплаченным счетам

Чтобы сделать возврат средств по оплаченному счету, используйте запрос API Возврат по платежу.

Возвраты по проведенным платежам

Возврат по платежу возможен только для успешно проведенного платежа. Возврат может быть как частичным, так и полным. В первом случае возвращается вся сумма принятого платежа. Во втором — только часть от суммы платежа. Перед возвратом платежа проверьте, что платеж успешно завершен и находится в статусе COMPLETED.

Чтобы выполнить возврат по платежу, используйте метод API Операция возврата.

Чтобы выполнить возврат по платежу через СБП, используйте метод API Операция возврата по платежу СБП.

Сплитование платежей

Сплитование платежей — решение, разработанное специально для маркетплейсов. Сплитование платежей позволяет рассчитываться с несколькими поставщиками услуг, производя одно списание с карты покупателя.

Чтобы подключить сплитование платежей, обратитесь к вашему сопровождающему менеджеру и запросите подключение решения.

Читать еще:   Как перевести деньги с телефона на Киви кошелек - перевод с мобильного баланса
Lopatniki.ru
Добавить комментарий