Выпуск виртуальной карты¶
Виртуальная карта — это реквизиты (номер карты, срок действия и CVV-код), которые выпускаются мгновенно.
Способы получения реквизитов:
- с помощью API — если партнёр отвечает стандартам безопасности PCI DSS и имеет соответствующий сертификат;
- с помощью формы — если у партнёра нет сертификата PCI DSS или партнёр желает воспользоваться готовым решением.
Успешный сценарий выпуска виртуальной карты изображён на диаграмме ниже.
%%{init: {
"sequence" : {
"wrap":true,
"messageFontSize":14,
"noteFontSize":12,
"actorMargin":
115 }}}%%
sequenceDiagram
participant С as Клиент
participant P as Партнёр
participant Q as QIWI
С->>P: Заказ карты в интерфейсе
rect rgb(230, 230, 230)
P->>+Q: Сценарий «Аутентификация с помощью OTP»
Note right of P: OTP для confirmationOperationType:ORDER_VIRTUAL_CARD
Q-->>-P:
Note left of Q: confirmationId, confirmationStatus:CONFIRMED
end
P->>+Q: Запрос на создание заказа
Note over P, Q: productId, orderId, clientId, accountId, confirmationId, cardPaymentSystem, cardType:VIRTUAL
Q->>-P: Ответ на запрос создания заказа
Note over P, Q: orderId, orderStatus:DELIVERED, cardTokenId, expiryDate, maskedPan, status:ACTIVE
alt Получение реквизитов с помощью API
rect rgb(255, 238, 223)
P->>+Q: Сценарий «Получение данных с помощью API»
Q-->>-P:
P->>С: Коммуникация с клиентом
Note left of P: Полные реквизиты карты
end
else Получение реквизитов с помощью формы
rect rgb(230, 230, 230)
P->>С: Перенаправление
Note left of P: Страница с реквизитами
P->>+Q: Сценарий «Получение данных с помощью формы»
Q-->>-С: Отображение всех реквизитов на странице (в форме)
end
end
Элемент диаграммы QIWI — совокупность участников процесса управления жизненным циклом карты.
Запросы описаны в документации Cards-lifecycle API. Упомянутые на диаграмме сценарии см. в статьях:
- «Общие принципы и правила» → «Подтверждение операций»
- «Получение данных карты» → «Получение данных с помощью API»;
- «Получение данных карты» → «Получение данных с помощью формы».
Жизненный цикл заказа на выпуск карты, а также самой карты описан в этой статье.
Обратите внимание
- Заказ на выпуск карты не может быть создан без предварительной аутентификации клиента.
- Виртуальная карта по умолчанию выпускается активной.
- При реализации сценария необходимо учитывать существующие правила и ограничения.
Тестирование¶
Общие правила тестирования описаны в статье BaaS → «Тестирование». Здесь мы расскажем об особенностях тестирования сценария выпуска виртуальной карты.
Особенности
QIWI выделяет партнёру определённое количество виртуальных карт, доступных для заказа в тестовой среде — обратитесь к курирующему менеджеру для выделения нужного количества.