Оплата с помощью платёжного токена¶

Партнёру BaaS, который выпускает банковские карты для своих клиентов, может потребоваться списывать денежные средства с этих карт без:

ввода карточных данных;
аутентификации с помощью 3D-Secure.

Пример бизнес-сценария — оплата покупки частями, когда денежные средства списываются по графику.

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

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

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

Под банковской картой понимается карта, выпущенная в рамках использования продукта BaaS.

Создание платёжного токена¶

Для создания токена необходимо выполнить запрос на создание платёжного токена к Cards-lifecycle API.

Списание средств с карты¶

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

интернет-эквайринг;
способ оплаты платёжным токеном.

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

Для списания средств с банковской карты необходимо выполнить запрос на создание платежа к API приёма платежей. Тело запроса должно содержать следующие параметры:

Параметр	Значение
`amount.currency`	Валюта платежа
`amount.value`	Сумма платежа
`paymentMethod.type`	TOKEN
`paymentMethod.paymentToken`	Значение `paymentTokenId`, полученное на этапе создания платёжного токена
`customer.account`	Значение `clientId` клиента, которому принадлежит карта. Указывается значение `clientId` из запроса на выпуск карты

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

PUT /partner/payin/v1/sites/test-02/payments/1815 HTTP/1.1
Accept: application/json
Authorization: Bearer 7uc4b25xx93xxx5d9cb8cd17480356f9
Content-type: application/json
Host: api.qiwi.com

{
  "amount": {
    "currency": "RUB",
    "value": 2000.00
  },
  "paymentMethod" : {
    "type": "TOKEN",
    "paymentToken" : "a2232f25-f224-4087-96d0-be2c6b440b12"
  },
  "customer": {
        "account": "clientUID123"
  }
}

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

В результате успешного проведения платежа средства списываются с баланса клиента и зачисляются на баланс партнёра, который ведётся в рамках продукта «Интернет-эквайринг».