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

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

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

• из авторизованной зоны, в частности в интерфейсе партнёра;
• из неавторизованной зоны, в частности в интерфейсе стороннего банка.

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

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

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

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

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

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

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

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

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

2. Партнёр выполняет сценарий «Получение комиссии».

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

9. Клиент видит на форме информацию об успешности платежа.

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

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

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

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

%%{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: 
    B->>-P: 
    Note left of B: clientCommission
    P->>+С: 
    С->>P: 
    Note left of P: clientCommission
    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 позволяет списать денежные средства с банковской карты клиента. В нашем случае эти средства зачисляются на его счёт в платформе.

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

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

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

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

Пример формы

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

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

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

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

Тестирование¶

Общие правила тестирования описаны в статье BaaS → «Тестирование». Здесь мы расскажем об особенностях тестирования сценариев пополнения c банковской карты из авторизованной зоны.

Тестовые данные

На форме используйте следующие реквизиты карты:

• номер карты — 4444448103367030;
• срок действия (месяц/год) — 12/2023;
• CVV — 123.

Особенности

• В тестовой среде на форме может отображаться несколько способов оплаты, однако использовать необходимо оплату с банковской карты — остальные способы технически недоступны.
• В тестовой среде не удастся проверить перенаправление на successUrl — доступно только в производственной среде.

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

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

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

1. Клиент:

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

2. Интернет-банк с помощью платёжной системы, которая обслуживает карту, проводит платёж.

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