---
title: Chargeback
description: Referência da REST API para comunicar um chargeback e consultar seu status na Verificação de Cartão Não Presente.
canonical: https://developer.unico.io/pt-BR/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/chargeback
locale: pt-BR
generated_by: markdown-export
---

- [/pt-BR/](/pt-BR/)
- Soluções Regionais
- [Verificação de Cartão Não Presente](/pt-BR/developers/regional-solutions/card-not-present-verification)
- [Integração](/pt-BR/developers/regional-solutions/card-not-present-verification/integration/overview)
- [APIs](/pt-BR/developers/regional-solutions/card-not-present-verification/integration/apis)
- [Referência de API](/pt-BR/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference)
- Chargeback

**Nesta página# Chargeback

### 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`

### Comunicar um chargeback​

`POST /credit/transactions/{transaction_id}/chargeback` — comunica à Unico que um chargeback foi recebido para uma transação especificada.
Comunicar não é contestarEste endpoint apenas comunica o chargeback. Ele não abre uma análise de chargeback e não aciona a [garantia de liability](/pt-BR/developers/regional-solutions/card-not-present-verification/about-idpay/chargeback). Para que a Unico analise o chargeback, abra uma contestação da transação no portal.
Headers
HeaderValor`Authorization``Bearer {token}` — um access-token válido.
Body
```
{  "datetime": "2023-01-05T03:00:00.000Z",  "requestor": { "key": "cpf", "value": "USER_CPF" },  "name": "USER_NAME",  "reason": "REQUEST_REASON",  "observation": "GENERAL_OBSERVATIONS"}
```

CampoTipoObrigatórioDescrição`datetime`stringsimData e hora em que o chargeback foi recebido, formato ISO 8601.`requestor`objectsimInformações do solicitante.`requestor.key`stringsimTipo da chave de identificação do solicitante (ex.: `cpf`).`requestor.value`stringsimValor da chave de identificação do solicitante.`name`stringsimNome do solicitante.`reason`stringsimMotivo do chargeback.`observation`stringnãoObservações gerais sobre o chargeback.
201 Created
```
{  "id": "8263a268-5388-492a-bca2-28e1ff4a69f0"}
```

CampoDescrição`id`ID do chargeback.
Uma transação tem um único chargeback. Comunicar uma transação que já possui um retorna `200 OK` com o `id` do chargeback existente, sem alterá-lo.
Para respostas de erro, veja [Erros — Criação da transação](/pt-BR/developers/regional-solutions/card-not-present-verification/integration/apis/errors#cria%C3%A7%C3%A3o-da-transa%C3%A7%C3%A3o).
### Consultar status do chargeback​

`GET /credit/transactions/{transaction_id}/chargeback/{chargeback_id}` — consulta o status de um chargeback específico.
Headers
HeaderValor`Authorization``Bearer {token}` — um access-token válido.
200 OK
```
{  "id": "8263a268-5388-492a-bca2-28e1ff4a69f0",  "status": "waiting"}
```

CampoDescrição`id`ID do chargeback.`status`Status atual do chargeback.
O chargeback comunicado permanece `waiting`. Se a transação for contestada no portal, o mesmo `id` mostra o andamento e o resultado da análise. Veja [Enumerados — Resultado do Chargeback](/pt-BR/developers/regional-solutions/card-not-present-verification/integration/apis/enumerated#resultado-do-chargeback) 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.Última atualização em 23 de out. de 2026**