--- title: Платёжные транзакции description: Справочник REST API для создания платёжных транзакций, проверки статуса, получения доказательств и повторной отправки уведомлений в Верификации без предъявления карты. canonical: https://developer.unico.io/ru/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/payment-transactions locale: ru generated_by: markdown-export --- - [/ru/](/ru/) - Региональные решения - [Верификация без предъявления карты](/ru/dual-api/developers/regional-solutions/card-not-present-verification) - [Интеграция](/ru/dual-api/developers/regional-solutions/card-not-present-verification/integration/overview) - [API](/ru/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis) - [Справочник API](/ru/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference) - Платёжные транзакции **На этой странице# Платёжные транзакции ### Прежде чем начать​ Ваши запросы к API аутентифицируются с помощью токена доступа. Любой запрос без действительного токена доступа вернёт ошибку. Подробнее в разделе [Аутентификация](/ru/developers/regional-solutions/card-not-present-verification/integration/authentication). Базовый URL **UAT**: `https://transactions.transactional.uat.unico.app/api/public/v1` **Продакшн**: `https://transactions.transactional.unico.app/api/public/v1` ### Создание транзакции​ `POST /credit/transaction` — создаёт новую транзакцию. опасностьЧтобы обеспечить лучшую конверсию, создавайте транзакцию **только после** завершения любой предварительной аутентификации или валидации, которая могла бы завершить операцию до начала работы с Верификацией без предъявления карты. опасностьПоле `orderNumber` должно быть заполнено **уникальным** номером заказа этой покупки в системе электронной коммерции — использование отдельного транзакционного идентификатора неверно. Повторное использование может привести к низкой конверсии (номер заказа помогает конечному пользователю завершить поток) и к ошибкам API, таким как `replicated transaction`, если используются одинаковые номер заказа, CPF, BIN и последние 4 цифры. Заголовки ЗаголовокЗначение`Authorization``Bearer {token}` — действительный токен доступа. Тело запроса ``` { "identity": { "key": "cpf", "value": "12345678900" }, "orderNumber": "order-98765", "company": "company-id", "redirectUrl": "https://yourapp.com/checkout/return", "card": { "binDigits": "12345678", "lastDigits": "1234", "expirationDate": "12/2028", "name": "John Doe" }, "value": 199.90, "mainContacts": [ { "key": "phone", "value": "5543999999999" } ], "additionalInfo": { "externalUserID": "YOUR_EXTERNAL_USER_ID" }} ``` ПолеТипОбязательноеОписание`identity`objectдаДанные идентификации пользователя.`identity.key`stringдаТип ключа идентификации пользователя. Рекомендуется `cpf` — более высокий процент конверсии.`identity.value`stringдаЗначение ключа идентификации пользователя, без точек и дефисов.`orderNumber`stringдаНомер заказа, связанный с транзакцией. Используется как индекс в портале и как внешний ключ между вашей системой и Верификацией без предъявления карты.`company`stringдаИдентификатор компании, ответственной за транзакцию, предоставленный Unico.`redirectUrl`stringнетURL для перенаправления пользователя после завершения транзакции (HTTPS-URL для веб или URL-схема для нативных мобильных приложений).`card`objectдаИнформация о карте, использованной в транзакции.`card.binDigits`stringдаПервые 8 цифр карты.`card.lastDigits`stringдаПоследние 4 цифры карты.`card.expirationDate`stringнетСрок действия карты.`card.name`stringдаИмя держателя карты. Отправляйте его корректно, избегая проблем с кодировкой — эти данные используются в пользовательском опыте и коммуникации.`value`numberдаОбщая сумма покупки.`mainContacts`arrayнетСписок основных контактов (email и/или телефоны), используемых для уведомления пользователя, когда за уведомление отвечает Верификация без предъявления карты.`fallbackContacts`arrayнетСписок резервных контактов, задействуемых, если попытки уведомления через основные контакты не удались.`additionalInfo`objectнетОтправьте этот объект с `externalUserID`, чтобы включить [Тихую верификацию](/ru/developers/regional-solutions/card-not-present-verification/integration/silent-verification) для этой транзакции.`additionalInfo.externalUserID`stringда (если отправлен `additionalInfo`)Тот же идентификатор, который настроен через `externalUserId` SDK при сборе метаданных устройства. Требуется для запуска тихой валидации — без него транзакция создаётся в обычном режиме, но всегда следует стандартному визуальному потоку. 200 OK ``` { "id": "6ab1771e-dfab-4e47-8316-2452268e5481", "status": "processing", "link": "https://developers/regional-solutions/card-not-present-verification.unico.app/t/6ab1771e-dfab-4e47-8316-2452268e5481", "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "expiresAt": "2026-07-22T15:30:00Z"} ``` ПолеОписание`id`Идентификатор созданной транзакции.`status`Текущий статус транзакции.`link`Ссылка, связанная с транзакцией.`token`Подписанный токен, содержащий параметры, необходимые для инициализации веб-SDK Верификации без предъявления карты.`expiresAt`Дата и время истечения срока действия транзакции, ISO 8601 (UTC). предупреждениеЕсли проверки определяют, что биометрический захват не требуется, ответ будет иметь другой статус, и ссылка на захват не генерируется:``` { "id": "6ab1771e-dfab-4e47-8316-2452268e5481", "status": "fast-inconclusive"} ``` Это происходит при использовании модулей Pre или Super Pre для Checkout, согласно [Feature](/ru/developers/regional-solutions/card-not-present-verification/about-idpay/feature). примечаниеЕсли был отправлен `additionalInfo.externalUserID` и транзакция одобрена в тихом режиме, ответ также не содержит ссылки на захват:``` { "id": "6ab1771e-dfab-4e47-8316-2452268e5481", "status": "approved"} ``` Полный процесс, включая настройку SDK и требования по времени, см. в разделе [Тихая верификация](/ru/developers/regional-solutions/card-not-present-verification/integration/silent-verification). Об ответах с ошибками см. в разделе [Ошибки — Создание транзакции](/ru/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#transaction-creation). ### Получение статуса транзакции​ `GET /credit/transactions/{transaction_id}` — проверяет текущий статус конкретной транзакции. Заголовки ЗаголовокЗначение`Authorization``Bearer {token}` — действительный токен доступа. 200 OK ``` { "status": "processing"} ``` ПолеОписание`status`Текущий статус транзакции. См. [Перечисления](/ru/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/enumerated) для всех возможных статусов. Для оптимизации производительности реализуйте Webhook вместо опроса (polling) этого эндпоинта. Об ответах с ошибками см. в разделе [Ошибки — Получение статуса транзакции](/ru/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#get-transaction-status). ### Получение доказательного набора транзакции​ `GET /credit/transactions/{transaction_id}/probative` — получает доказательный набор конкретной транзакции. предупреждениеДоказательный набор может быть сформирован только для **одобренных** транзакций. опасностьСсылка, возвращаемая для доказательного набора, действительна в течение **пяти минут** с момента её получения — не сохраняйте её, а используйте немедленно для скачивания доказательного набора. Заголовки ЗаголовокЗначение`Authorization``Bearer {token}` — действительный токен доступа. 200 OK ``` { "link": "https://unico.io/probative.pdf"} ``` ПолеОписание`link`URL доказательного файла. Об ответах с ошибками см. в разделе [Ошибки — Получение доказательного набора транзакции](/ru/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#recovery-of-the-evidentiary-set-of-the-transaction). ### Повторная отправка уведомления о транзакции​ `POST /credit/transactions/{transaction_id}/notify` — повторно отправляет уведомления по email и/или телефону для конкретной транзакции. примечаниеТакже можно настроить повторную отправку уведомлений через портал, не реализуя это через API. Обратитесь к контактному лицу вашего проекта, чтобы узнать о возможностях. Заголовки ЗаголовокЗначение`Authorization``Bearer {token}` — действительный токен доступа. Тело запроса ``` { "phone": "NOTIFICATION_PHONE", "email": "NOTIFICATION_EMAIL"} ``` ПолеТипОбязательноеОписание`phone`stringдаНомер телефона для отправки уведомления.`email`stringдаАдрес электронной почты для отправки уведомления. 200 OK ``` { "id": "b50ee24c-71eb-4a5d-ade1-41c48b44c240", "link": "https://aces.so/example"} ``` ПолеОписание`id`Уникальный идентификатор сгенерированного уведомления.`link`Сгенерированная ссылка для уведомления. Об ответах с ошибками см. в разделе [Ошибки — Повторная отправка уведомления о транзакции](/ru/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#resending-the-transaction-notification).Последнее обновление 8 окт. 2026 г.**