Платёж по токену карты
В Протоколе приема платежей поддерживается генерация платежных токенов карт. Они могут быть использованы для последующих списаний без дополнительного ввода реквизитов карт. При выпуске платежного токена карты ее реквизиты сохраняются в зашифрованном виде.
Платежный токен карты выпускается только после успешной авторизации платеж а банком-эмитентом.
Выпуск платежного токена карты
В процессе проведения платежа. Воспользуйтесь запросом Создание счета. В запросе укажите дополнительные параметры:
"flags": ["BIND_PAYMENT_TOKEN"]
— флаг для выпуска платежного токена.customer.account
— уникальный идентификатор Покупателя в системе ТСП.
Необходимо использовать разные параметры account
для разных покупателей, чтобы гарантировать безопасность карточных данных покупателей.
Вы получите информацию о платежном токене карты после успешного завершения платежа в уведомлении в поле tokenData
.
Платежный токен будет связан с идентификатором сайта и идентификатором Покупателя, которые вы указали в запросе API. Покупатель сможет совершать оплату платежным токеном только на этом сайте.
Создание платежа по токену карты
Чтобы инициировать платеж с предварительным холдированием средств на карте (двухшаговый платеж), передайте в запросе API Платеж:
- ключ API;
- сумму платежа;
- платежный токен в объекте
paymentMethod
, - идентификатор покупателя, для которого был выпущен платежный токен, в параметре
customer.account
. - другая информация для создания платежа.
В двухшаговом платеже возмещение формируется только после подтверждения платежа.
По умолчанию, при холдировании сервис QIWI ожидает подтверждения платежа в течение 72 часов. По истечении срока выполняется автоподтверждение платежа. Чтобы увеличить или уменьшить период ожидания, или настроить автоотмену платежа обратитесь в Службу поддержки. Период ожидания не может длиться более 5 суток.
Для платежа без авторизации (одношаговый платеж) укажите в запросе API Платеж параметр "flags":["SALE"]
. Если не передать этот параметр, то будет выполнено безусловное холдирование средств для выполнения платежа
Подтверждение платежа
Это действие требуется только для двухшагового платежа с холдированием. Чтобы подтвердить платеж:
- Получите
paymentId
платежа:- Из серверного уведомления после успешного холдирования средств.
- Из ответа на запрос Статус платежа.
- Отправьте запрос API Подтверждение платежа с полученным
paymentId
.