---
title: "Двухстадийная оплата по токену"
method: POST
path: "/payments/tokens/auth"
tags: ["Payments"]
---

# Двухстадийная оплата по токену

`POST /payments/tokens/auth`

Двухстадийная оплата по токену (рекарринг)

Выполняет авторизацию (холдирование средств) по сохранённому токену карты.
Для списания необходимо вызвать метод confirm.

## Request body

- TokenPaymentRequest — Запрос на оплату по токену (рекарринг)
  - `Amount` number, double, required — Сумма платежа (до 2 знаков после точки)
  - `Currency` string — Валюта (RUB по умолчанию)
  - `AccountId` string, required — Идентификатор пользователя
  - `TrInitiatorCode` integer, required — Признак инициатора транзакции: 0 — мерчант, 1 — держатель карты
  - `PaymentScheduled` integer — Признак регулярного платежа: 0 — нет, 1 — да
  - `Token` string, required — Токен карты
  - `InvoiceId` string — Номер заказа
  - `Description` string — Описание платежа
  - `IpAddress` string — IP-адрес плательщика
  - `Email` string — Email плательщика
  - `Payer` Payer — Информация о плательщике
    - `FirstName` string — Имя
    - `LastName` string — Фамилия
    - `MiddleName` string — Отчество
    - `Birth` string — Дата рождения (YYYY-MM-DD)
    - `Street` string — Улица
    - `Address` string — Адрес
    - `City` string — Город
    - `Country` string — Страна (код ISO)
    - `Phone` string — Телефон
    - `Postcode` string — Почтовый индекс
  - `JsonData` object — Дополнительные данные (JSON)

## Response `200`

The request has succeeded.

- object — Базовый ответ API
  - `Success` boolean, required — Результат выполнения запроса
  - `Message` string — Описание ошибки (при наличии)
  - `Model` TransactionModel — Модель транзакции в ответе API
    - `ReasonCode` integer, required — Код причины отклонения (0 = успех)
    - `PublicId` string, required — Public ID терминала
    - `TerminalUrl` string, required — URL терминала
    - `TransactionId` integer, required — Номер транзакции
    - `Amount` number, double, required — Сумма платежа
    - `Currency` string, required — Валюта платежа
    - `CurrencyCode` integer, required — Код валюты
    - `PaymentAmount` number, double, required — Сумма платежа в валюте оплаты
    - `PaymentCurrency` string, required — Валюта оплаты
    - `PaymentCurrencyCode` integer, required — Код валюты оплаты
    - `InvoiceId` string — Номер заказа
    - `AccountId` string — Идентификатор пользователя
    - `Email` string — Email плательщика
    - `Description` string — Описание платежа
    - `JsonData` string — Дополнительные данные JSON
    - `CreatedDate` string, required — Дата создания (формат /Date(...)/)
    - `PayoutDate` string — Дата выплаты
    - `PayoutDateIso` string — Дата выплаты ISO
    - `PayoutAmount` number, double — Сумма выплаты
    - `CreatedDateIso` string, required — Дата создания ISO
    - `AuthDate` string — Дата авторизации
    - `AuthDateIso` string — Дата авторизации ISO
    - `ConfirmDate` string — Дата подтверждения
    - `ConfirmDateIso` string — Дата подтверждения ISO
    - `AuthCode` string — Код авторизации
    - `TestMode` boolean, required — Режим тестирования
    - `Rrn` string — Retrieval Reference Number
    - `OriginalTransactionId` integer — ID оригинальной транзакции
    - `FallBackScenarioDeclinedTransactionId` integer — ID отклоненной транзакции fallback сценария
    - `IpAddress` string, required — IP-адрес плательщика
    - `IpCountry` string, required — Страна по IP
    - `IpCity` string — Город по IP
    - `IpRegion` string — Регион по IP
    - `IpDistrict` string — Округ по IP
    - `IpLatitude` number, double — Широта по IP
    - `IpLongitude` number, double — Долгота по IP
    - `CardFirstSix` string, required — Первые 6 цифр карты
    - `CardLastFour` string, required — Последние 4 цифры карты
    - `CardExpDate` string, required — Срок действия карты
    - `CardType` string, required — Тип карты (Visa, MasterCard, etc.)
    - `CardProduct` string — Продукт карты
    - `CardCategory` string — Категория карты
    - `EscrowAccumulationId` string — ID накопления для безопасной сделки
    - `IssuerBankCountry` string, required — Страна банка-эмитента
    - `Issuer` string, required — Банк-эмитент
    - `CardTypeCode` integer, required — Код типа карты
    - `Status` string, required — Статус транзакции (текст)
    - `StatusCode` integer, required — Код статуса транзакции
    - `CultureName` string, required — Язык
    - `Reason` string, required — Причина (текст)
    - `CardHolderMessage` string, required — Сообщение для держателя карты
    - `Type` integer, required — Тип операции
    - `Refunded` boolean, required — Признак возврата
    - `Name` string — Имя держателя карты
    - `Token` string — Токен карты для повторных платежей
    - `SubscriptionId` string — ID подписки
    - `GatewayName` string, required — Имя шлюза
    - `AndroidPay` boolean, required — Признак Android Pay
    - `WalletType` string, required — Тип кошелька
    - `TotalFee` number, double, required — Общая комиссия

---

[API](https://skmtc.net/hexlet/apis/cloudpayments-api.md) · [All operations](https://skmtc.net/hexlet/apis/cloudpayments-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hexlet/cloudpayments-api/versions/737bf804f9ef/schema)