Перейти к содержанию

Пополнение с банковской карты

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

Клиент может пополнить счёт с карты:

Пополнение из авторизованной зоны

Описание авторизованной зоны см. в статье «Термины и бизнес-сущности».

Пополнение из такой зоны является операцией домена PAYMENTS. Партнёр может реализовать его c помощью API.

Для пополнения c помощью API партнёру необходимо:

  • использовать платёжную форму QIWI;
  • знать идентификатор счёта (accountId) клиента-получателя — возвращается при выполнении сценария «Создание клиента и счёта».

Обратите внимание

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

Пример успешного сценария пополнения с банковской карты c помощью API описан и изображён ниже.

  1. Клиент указывает сумму и нажимает «Пополнить» в интерфейсе партнёра.

    Опциональные шаги

    П.2 - п.5 являются опциональными и выполняются лишь в том случае, если бизнес-сценарием предусмотрена комиссия с клиента за совершение пополнения.

  2. Партнёр отправляет QIWI (BaaS) запрос на получение комиссии.

  3. QIWI (BaaS) возвращает партнёру размер комиссии за пополнение.
  4. Партнёр информирует клиента о размере комиссии.
  5. Клиент соглашается с условиями и подтверждает пополнение.
  6. Партнёр отправляет QIWI (BaaS) запрос на пополнение с банковской карты, в котором передаёт сумму пополнения и размер полученной комиссии.
  7. QIWI (BaaS) осуществляет проверку возможности пополнения и возвращает партнёру статус проведения платежа «В процессе проведения» (status:PROCESSING), а также URL-адрес платёжной формы QIWI (payUrl).
  8. Партнёр направляет клиента на полученный payUrl.
  9. Клиент вводит данные банковской карты и подтверждает пополнение.
  10. QIWI проводит аутентификацию клиента с помощью 3D-Secure.
  11. QIWI проводит операцию пополнения.
  12. Клиент видит на форме информацию об успешности платежа.

    Опциональные шаги

    П.13 является опциональным и выполняется лишь в том случае, если для партнёра настроен successUrl. Подробности см. в разделе «Платёжная форма»«URL-адрес страницы для успешного платежа».

  13. Форма QIWI направляет клиента на «URL-адрес страницы для успешного платежа».

  14. Партнёр принимает решение об успешности проведения платежа — выполняет действия, указанные в статье «Общие принципы и правила» → «Решение об успешности платежа» → «Асинхронный вариант проведения платежа».
%%{init: {
    "sequence" : {
        "wrap":true,
        "messageFontSize":16,
        "noteFontSize":15,
        "actorMargin":
        75 }}}%%
sequenceDiagram
    participant С as Клиент
    participant P as Партнёр
    participant B as QIWI
    С->>P: Пополнение с карты в интерфейсе
    Note right of С: Сумма пополнения. «Пополнить»
    opt Получение комиссии (опционально)
    P->>+B: Запрос на получение комиссии
    Note over P, B: productId, clientId, txnType, value, currency
    B->>-P: Ответ на запрос получения комиссии
    Note over P, B: clientCommission
    P->>С: Коммуникация с клиентом
    Note left of P: Размер комиссии. Запрос подтверждения
    С->>P: Подтверждение пополнения
    end
    P->>+B: Запрос на пополнение
    Note over P, B: productId, transactionId, toClientId, transactionAmount, clientCommission
    B->>-P: Ответ на запрос пополнения
    Note over P, B: status:PROCESSING, payUrl
    rect rgb(230, 230, 230)
    P->>С: Направление на 'payUrl'
    Note left of P: Платёжная форма
    С->>С: Ввод данных на форме
    Note over С: PAN, CVV, exp. date
    С->>B: Выполнение кода (вызов API формой)
    opt Аутентификация клиента с помощью 3D-Secure
    B->>+С: 
    С->>-B: 
    end
    B->>B: Проведение пополнения
    B->>С: Отображение результата на форме
    Note left of P: «Платёж успешен»
    opt Направление на URL-адрес 'successUrl' (опционально)
    С->>P: 
    Note left of P: Страница статуса платежа в интерфейсе партнёра
    end
    end
    rect rgb(255, 238, 223)
    P->>+B: Сценарий «Решение об успешности платежа»
    B-->>-P: 
    Note left of B: status:SUCCESS
    end
    P->>С: Коммуникация с клиентом

Запросы описаны в документации Payments API. Сценарий принятия решения об успешности платежа см. в статье «Общие принципы и правила» → «Решение об успешности платежа» → «Асинхронный вариант проведения платежа».

Жизненный цикл операции пополнения описан в этой статье.

Обратите внимание

  • Партнёр не получает, не обрабатывает и не хранит данные карты отправителя. Это делает форма QIWI. Данный этап выделен на схеме серым цветом.
  • Действия, указанные в статье «Общие принципы и правила» → «Решение об успешности платежа» → «Асинхронный вариант проведения платежа», обязательны для выполнения.

Важная информация

При реализации сценария необходимо учитывать существующие правила и ограничения.

Платёжная форма

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

Кастомизация

Кастомизация позволяет настроить внешний вид формы.

Настраиваются:

  • логотип;
  • цвет фона;
  • изображение для фона;
  • цвет кнопок;
  • название провайдера/услуги;
  • краткое описание;
  • ссылка на оферту.

Пример формы

LINKS

URL-адрес страницы для успешного платежа (successUrl)

После пополнения клиента можно направить с формы на определённую страницу, например со статусом платежа на сайте партнёраsuccessUrl. Клиент окажется на successUrl через 3-10 секунд после успешного совершения операции.

По переходу клиента на successUrl партнёр может понять, что пополнение подтверждено и вскоре статус операции в BaaS изменится на финальный успешный или финальный неуспешный.

Для установки URL-адреса страницы для успешного платежа обратитесь к вашему контактному менеджеру.

Пополнение из неавторизованной зоны

Описание неавторизованной зоны см. в статье «Термины и бизнес-сущности».

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

  1. Клиент:

    • заходит на сайт или в мобильное приложение интернет-банка;
    • выбирает перевод по номеру карты;
    • указывает данные карты QIWI в качестве получателя;
    • выбирает карту другого банка в качестве отправителя;
    • вводит сумму и нажимает «Перевести».
  2. Интернет-банк с помощью платёжной системы, которая обслуживает карту, проводит платёж.

Партнёр узнаёт о факте совершения перевода, получив уведомление, подробности см. в статье «Уведомление»«Уведомление об операциях домена CARDS».