Регистрация кредитной карты

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

Ваши запросы к API аутентифицируются с помощью токена доступа. Любой запрос без действительного токена доступа вернёт ошибку. Подробнее в разделе Аутентификация.

Базовый URL

• UAT: https://transactions.transactional.uat.unico.app/api/public/v1
• Продакшн: https://transactions.transactional.unico.app/api/public/v1

Важно

Регистрация кредитной карты может быть выполнена либо путём запроса селфи у конечного пользователя и завершения полной регистрации, либо путём повторного использования биометрических захватов из процессов, выполненных другими продуктами платформы 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
}

Поле	Тип	Обязательное	Описание
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.
additionalInfo.processID	string	да (если отправляется additionalInfo)	Идентификатор эталонного процесса платформы IDCloud.

опасность

Поле 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 не был указан.

Проверка статуса валидации

GET /walletid/transactions/{transaction_id} — проверяет текущий статус конкретной транзакции.

Заголовки

Заголовок	Значение
Authorization	Bearer {token} — действительный токен доступа.

200 OK

{
  "status": "processing",
  "hasIdentityChanged": false
}

Поле	Описание
status	Текущий статус транзакции.
hasIdentityChanged	Необязательное. Указывает, произошла ли в транзакции подмена личности.

См. Перечисления для всех возможных статусов. Для оптимизации производительности реализуйте Webhook вместо опроса (polling) этого эндпоинта.

Об ответах с ошибками см. в разделе Ошибки — Регистрация кредитной карты.