--- title: Transações de pagamento description: Referência da REST API para criar transações de pagamento, consultar status, recuperar evidências e reenviar notificações na 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/payment-transactions 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) - Transações de pagamento **Nesta página# Transações de pagamento ### 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` ### Criar transação​ `POST /credit/transaction` — cria uma nova transação. perigoPara garantir a melhor conversão, crie a transação somente após concluir qualquer pré-autenticação ou validação que possa encerrar a operação antes da experiência da Verificação de Cartão Não Presente. 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. Reutilizar esse valor pode causar baixa conversão (o número do pedido ajuda o usuário a concluir o fluxo) e erros na API como `replicated transaction`, caso seja usado o mesmo número do pedido, CPF, BIN e últimos 4 dígitos. Headers HeaderValor`Authorization``Bearer {token}` — um access-token válido. Body ``` { "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" }} ``` CampoTipoObrigatórioDescrição`identity`objectsimDados de identificação do usuário.`identity.key`stringsimTipo de chave de identificação do usuário. Recomenda-se `cpf` — maior conversão.`identity.value`stringsimValor da chave de identificação do usuário, sem pontos ou traços.`orderNumber`stringsimNúmero do pedido associado à transação. 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, evitando problemas de encode — esse dado é usado na experiência e comunicação com o usuário.`value`numbersimValor total da compra.`mainContacts`arraynãoLista de contatos principais (e-mails e/ou telefones) usados para notificar o usuário, quando a Verificação de Cartão Não Presente é responsável pela notificação.`fallbackContacts`arraynãoLista de contatos secundários, acionados caso as tentativas de notificação dos contatos principais falhem.`additionalInfo`objectnãoEnvie este objeto com `externalUserID` para habilitar a [Verificação Silenciosa](/pt-BR/developers/regional-solutions/card-not-present-verification/integration/silent-verification) para esta transação.`additionalInfo.externalUserID`stringsim (se `additionalInfo` for enviado)O mesmo identificador configurado através do `externalUserId` do SDK ao coletar os metadados do dispositivo. Obrigatório para acionar a validação silenciosa — sem ele, a transação é criada normalmente, mas sempre segue o fluxo visual padrão. 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"} ``` CampoDescrição`id`ID da transação criada.`status`Status atual da transação.`link`Link relacionado à transação.`token`Token assinado com os parâmetros necessários para inicializar o SDK web da Verificação de Cartão Não Presente.`expiresAt`Data e hora de expiração da transação, ISO 8601 (UTC). avisoCaso as validações determinem que a captura biométrica não é necessária, a resposta terá um status diferente e não será gerado um link de captura:``` { "id": "6ab1771e-dfab-4e47-8316-2452268e5481", "status": "fast-inconclusive"} ``` Isso acontece ao utilizar os módulos Pré ou Super Pré, conforme especificado em [Funcionalidades](/pt-BR/developers/regional-solutions/card-not-present-verification/about-idpay/feature). observaçãoSe `additionalInfo.externalUserID` foi enviado e a transação for aprovada silenciosamente, a resposta também não inclui 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. Para respostas de erro, veja [Erros — Criação da transação](/pt-BR/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#cria%C3%A7%C3%A3o-da-transa%C3%A7%C3%A3o). ### Consultar status da transação​ `GET /credit/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"} ``` CampoDescrição`status`Status atual da 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 — Consulta do status da transação](/pt-BR/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#consulta-do-status-da-transa%C3%A7%C3%A3o). ### Recuperar conjunto probatório da transação​ `GET /credit/transactions/{transaction_id}/probative` — recupera o conjunto probatório de uma transação específica. avisoSó é possível gerar o conjunto probatório de transações **aprovadas**. perigoO link retornado para o conjunto probatório tem validade de **cinco minutos** após a obtenção — não o salve, use-o para baixar o conjunto probatório imediatamente. Headers HeaderValor`Authorization``Bearer {token}` — um access-token válido. 200 OK ``` { "link": "https://unico.io/probative.pdf"} ``` CampoDescrição`link`URL do arquivo probatório. Para respostas de erro, veja [Erros — Recuperação do conjunto probatório da transação](/pt-BR/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#recupera%C3%A7%C3%A3o-do-conjunto-probat%C3%B3rio-da-transa%C3%A7%C3%A3o). ### Reenviar notificação da transação​ `POST /credit/transactions/{transaction_id}/notify` — reenvia notificações via e-mail e/ou telefone para uma transação específica. observaçãoTambém é possível configurar o reenvio de notificações através do portal, sem a necessidade de implementar via API. Fale com o responsável pelo seu projeto para entender as possibilidades. Headers HeaderValor`Authorization``Bearer {token}` — um access-token válido. Body ``` { "phone": "NOTIFICATION_PHONE", "email": "NOTIFICATION_EMAIL"} ``` CampoTipoObrigatórioDescrição`phone`stringsimNúmero de telefone para o envio da notificação.`email`stringsimEndereço de e-mail para o envio da notificação. 200 OK ``` { "id": "b50ee24c-71eb-4a5d-ade1-41c48b44c240", "link": "https://aces.so/example"} ``` CampoDescrição`id`ID único da notificação gerada.`link`Link gerado para a notificação. Para respostas de erro, veja [Erros — Reenvio da notificação da transação](/pt-BR/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#reenvio-da-notifica%C3%A7%C3%A3o-da-transa%C3%A7%C3%A3o).Última atualização em 8 de out. de 2026**