--- title: Onboarding de cartão de crédito description: Referência da REST API para validar um cartão de crédito e consultar o status de validação na funcionalidade de Onboarding de Cartão de Crédito da Verificação de Cartão Não Presente. canonical: https://developer.unico.io/pt-BR/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/credit-card-onboarding locale: pt-BR generated_by: markdown-export --- - [/pt-BR/](/pt-BR/) - Soluções Regionais - [Verificação de Cartão Não Presente](/pt-BR/dual-api/developers/regional-solutions/card-not-present-verification) - [Integração](/pt-BR/dual-api/developers/regional-solutions/card-not-present-verification/integration/overview) - [APIs](/pt-BR/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis) - [Referência de API](/pt-BR/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference) - Onboarding de cartão de crédito **Nesta página# Onboarding de cartão de crédito ### Antes de começar​ Suas requisições de API são autenticadas utilizando um access-token. Qualquer requisição que não inclua um access-token válido retornará um erro. Saiba mais em [Autenticação](/pt-BR/developers/regional-solutions/card-not-present-verification/integration/authentication). Base URL **UAT**: `https://transactions.transactional.uat.unico.app/api/public/v1` **Produção**: `https://transactions.transactional.unico.app/api/public/v1` ImportanteÉ possível realizar o Onboarding do cartão de crédito solicitando a selfie do usuário final e realizando todo o cadastro, **ou** reutilizando as capturas biométricas dos processos de outros produtos da plataforma Unico IDCloud: Para reutilizar os processos gerados pelos outros produtos da plataforma Unico IDCloud, informe o ID do processo de referência no campo `additionalInfo.processID`; Os processos de referência utilizados devem ter sido concluídos em no máximo **1 hora**. ### Validar cartão de crédito​ `POST /walletid/transaction` — valida um cartão de crédito. Headers HeaderValor`Authorization``Bearer {token}` — um access-token válido. Body ``` { "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" }} ``` CampoTipoObrigatórioDescrição`identity`objectsimDados de identificação do usuário.`identity.key`stringsimTipo de chave de identificação do usuário.`identity.value`stringsimValor da chave de identificação do usuário.`orderNumber`stringsimNúmero associado ao onboarding. Usado como indexador no portal e como chave de associação entre seu sistema e a Verificação de Cartão Não Presente.`company`stringsimID da empresa responsável pela transação, fornecido pela Unico.`redirectUrl`stringnãoURL para redirecionar o usuário após a transação (URL HTTPS para web, ou URL Schema para apps móveis nativos).`card`objectsimInformações do cartão utilizado na transação.`card.binDigits`stringsim8 primeiros dígitos do cartão.`card.lastDigits`stringsimÚltimos 4 dígitos do cartão.`card.expirationDate`stringnãoData de validade do cartão.`card.name`stringsimNome do titular do cartão — envie corretamente para evitar problemas de encode ou aprovação.`value`numbernãoValor máximo assegurado.`additionalInfo`objectnãoEnvie este objeto com `processID` para reutilizar capturas biométricas de outros produtos da plataforma Unico IDCloud e/ou `externalUserID` para habilitar a [Verificação Silenciosa](/pt-BR/developers/regional-solutions/card-not-present-verification/integration/silent-verification) para essa transação.`additionalInfo.processID`stringnãoProcesso de referência da plataforma IDCloud.`additionalInfo.externalUserID`stringnãoO mesmo identificador configurado via `externalUserId` do SDK ao coletar os metadados do dispositivo. Obrigatório apenas para acionar a validação silenciosa — sem ele, a transação é criada normalmente, mas sempre segue o fluxo visual padrão. perigoO campo `orderNumber` deve ser preenchido com o número de pedido **único** daquela compra no e-commerce, sendo errado o envio de um ID distinto transacional, e reutilizar valores pode gerar erros do tipo `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..."} ``` CampoDescrição`id`ID da transação criada.`status`Status atual da transação.`link`Link relacionado à transação. Retornado apenas se `additionalInfo.processID` **não** for enviado.`token`Token assinado para inicializar o SDK web da Verificação de Cartão Não Presente. Retornado apenas se `additionalInfo.processID` **não** for enviado. observaçãoSe `additionalInfo.externalUserID` foi enviado e a transação for aprovada silenciosamente, a resposta também omite o link de captura:``` { "id": "6ab1771e-dfab-4e47-8316-2452268e5481", "status": "approved"} ``` Veja [Verificação Silenciosa](/pt-BR/developers/regional-solutions/card-not-present-verification/integration/silent-verification) para o fluxo completo, incluindo a configuração do SDK e os requisitos de tempo. ### Consultar status de validação​ `GET /walletid/transactions/{transaction_id}` — consulta o status atual de uma transação específica. Headers HeaderValor`Authorization``Bearer {token}` — um access-token válido. 200 OK ``` { "status": "processing", "hasIdentityChanged": false} ``` CampoDescrição`status`Status atual da transação.`hasIdentityChanged`Opcional. Se houve troca de identidade na transação. Veja [Enumerados](/pt-BR/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/enumerated) para todos os status possíveis. Para otimizar a performance, implemente o [Webhook](/pt-BR/developers/regional-solutions/card-not-present-verification/integration/webhook) ao invés de consultar este endpoint repetidamente. Para respostas de erro, veja [Erros — Onboarding de cartão de crédito](/pt-BR/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#onboarding-de-cart%C3%A3o-de-cr%C3%A9dito).Última atualização em 8 de out. de 2026**