---
title: Onboarding кредитной карты
description: Справочник REST API для валидации кредитной карты и проверки статуса валидации в функции регистрации кредитной карты Верификации без предъявления карты.
canonical: https://developer.unico.io/ru/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/credit-card-onboarding
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)
- Onboarding кредитной карты

**На этой странице# Onboarding кредитной карты

### Прежде чем начать​

Ваши запросы к 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`

ВажноOnboarding кредитной карты может быть выполнен либо путём запроса селфи у конечного пользователя и завершения полной регистрации, **либо** путём повторного использования биометрических захватов из процессов, выполненных другими продуктами платформы Unico IDCloud:
Чтобы повторно использовать процессы, сгенерированные другими продуктами IDCloud, укажите идентификатор эталонного процесса в `additionalInfo.processID`;
Используемый эталонный процесс должен был быть завершён не более чем **1 час** назад.

### Валидация кредитной карты​

`POST /walletid/transaction` — выполняет валидацию кредитной карты.
Заголовки
ЗаголовокЗначение`Authorization``Bearer {token}` — действительный токен доступа.
Тело запроса
```
{  "identity": { "key": "cpf", "value": "12345678900" },  "orderNumber": "onboarding-98765",  "company": "company-id",  "redirectUrl": "https://yourapp.com/wallet/return",  "card": {    "binDigits": "12345678",    "lastDigits": "1234",    "expirationDate": "12/2028",    "name": "John Doe"  },  "value": 5000.00,  "additionalInfo": {    "externalUserID": "YOUR_EXTERNAL_USER_ID"  }}
```

ПолеТипОбязательноеОписание`identity`objectдаИнформация об идентификации пользователя.`identity.key`stringдаТип ключа идентификации пользователя.`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нетМаксимальная застрахованная сумма.`additionalInfo`objectнетОтправьте этот объект с `processID`, чтобы повторно использовать биометрические захваты из других продуктов платформы Unico IDCloud, и/или с `externalUserID`, чтобы включить [Тихую верификацию](/ru/developers/regional-solutions/card-not-present-verification/integration/silent-verification) для этой транзакции.`additionalInfo.processID`stringнетИдентификатор эталонного процесса платформы IDCloud.`additionalInfo.externalUserID`stringнетТот же идентификатор, который был настроен через `externalUserId` SDK при сборе метаданных устройства. Требуется только для запуска тихой валидации — без него транзакция создаётся нормально, но всегда следует стандартному визуальному потоку.
опасностьПоле `orderNumber` должно быть заполнено **уникальным** номером заказа этой покупки в системе электронной коммерции — использование отдельного транзакционного идентификатора неверно, а повторное использование значений может вызвать ошибки `replicated transaction`.
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..."}
```

ПолеОписание`id`Идентификатор созданной транзакции.`status`Текущий статус транзакции.`link`Ссылка, связанная с транзакцией. Возвращается т олько если `additionalInfo.processID` **не** был указан.`token`Подписанный токен для инициализации веб-SDK Верификации без предъявления карты. Возвращается только если `additionalInfo.processID` **не** был указан.
примечаниеЕсли был отправлен `additionalInfo.externalUserID` и транзакция была одобрена тихо, ответ также не будет содержать ссылку для захвата:```
{    "id": "6ab1771e-dfab-4e47-8316-2452268e5481",    "status": "approved"}
```

См. [Тихую верификацию](/ru/developers/regional-solutions/card-not-present-verification/integration/silent-verification) для получения информации о полном процессе, включая настройку SDK и требования по времени.
### Проверка статуса валидации​

`GET /walletid/transactions/{transaction_id}` — проверяет текущий статус конкретной транзакции.
Заголовки
ЗаголовокЗначение`Authorization``Bearer {token}` — действительный токен доступа.
200 OK
```
{  "status": "processing",  "hasIdentityChanged": false}
```

ПолеОписание`status`Текущий статус транзакции.`hasIdentityChanged`Необязательное. Указывает, произошла ли в транзакции подмена личности.
См. [Перечисления](/ru/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/enumerated) для всех возможных статусов. Для оптимизации производительности реализуйте Webhook вместо опроса (polling) этого эндпоинта.
Об ответах с ошибками см. в разделе [Ошибки — Onboarding кредитной карты](/ru/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#credit-card-onboarding).Последнее обновление 8 окт. 2026 г.**