# Chargeback

### Antes de começar <a href="#antes-de-comecar" id="antes-de-comecar"></a>

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.

Você pode ver mais sobre como gerar um access-token [<mark style="color:blue;">**aqui**</mark>](https://devcenter.unico.io/unico-idpay/integracao/autenticacao).

{% hint style="info" %}

#### **Base URL**: <a href="#endpoints" id="endpoints"></a>

* UAT: <mark style="color:blue;">`https://transactions.transactional.uat.unico.app/api/public/v1`</mark>;
* Produção: <mark style="color:blue;">`https://transactions.transactional.unico.app/api/public/v1`</mark>.
  {% endhint %}

## Solicitar análise de chargeback

> Endpoint para solicitar a análise do chargeback de uma transação especificada.

```json
{"openapi":"3.0.0","info":{"title":"Chargeback Transaction API","version":"1.0.0"},"servers":[{"url":"https://transactions.transactional.uat.unico.app/api/public/v1"}],"paths":{"/credit/transactions/{transaction_id}/chargeback":{"post":{"summary":"Solicitar análise de chargeback","description":"Endpoint para solicitar a análise do chargeback de uma transação especificada.","parameters":[{"name":"transaction_id","in":"path","required":true,"description":"ID da transação que será submetida ao chargeback.","schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Access-token válido. O valor deve ser enviado no formato Bearer {token}\".","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["datetime","requestor","name","reason"],"properties":{"datetime":{"type":"string","format":"date-time","description":"Data e hora do pedido de chargeback no formato ISO 8601."},"requestor":{"type":"object","description":"Informações do solicitante.","required":["key","value"],"properties":{"key":{"type":"string","description":"Tipo da chave de identificação do solicitante."},"value":{"type":"string","description":"Valor da chave de identificação do solicitante."}}},"name":{"type":"string","description":"Nome do solicitante."},"reason":{"type":"string","description":"Motivo da solicitação de chargeback."},"observation":{"type":"string","description":"Observações gerais sobre o pedido."},"documents":{"type":"array","description":"Documentos relacionados ao chargeback. Até 3 itens são permitidos, e cada documento deve estar codificado em Base64. Apenas arquivos PDF serão aceitos.","items":{"type":"object","required":["label","data"],"properties":{"label":{"type":"string","description":"Nome ou descrição do arquivo."},"data":{"type":"string","description":"Arquivo PDF codificado em Base64."}}}}}}}}},"responses":{"200":{"description":"Solicitação de chargeback bem-sucedida.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID do chargeback gerado."}}}}}},"400":{"description":"Dados inválidos na requisição.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Código do erro."},"message":{"type":"string","description":"Detalhes do erro."}}}}}},"403":{"description":"Proibição de acesso (token inválido ou permissões insuficientes).","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Código do erro."},"message":{"type":"string","description":"Detalhes do erro."}}}}}},"404":{"description":"Transação não encontrada.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Código do erro."},"message":{"type":"string","description":"Detalhes do erro."}}}}}},"500":{"description":"Erro interno do servidor.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Código do erro."},"message":{"type":"string","description":"Detalhes do erro."}}}}}}}}}}}
```

## Consultar status da análise de chargeback

> Endpoint para consultar o status de um chargeback específico de uma transação.

```json
{"openapi":"3.0.0","info":{"title":"Chargeback Status API","version":"1.0.0"},"servers":[{"url":"https://transactions.transactional.uat.unico.app/api/public/v1"}],"paths":{"/credit/transactions/{transaction_id}/chargeback/{chargeback_id}":{"get":{"summary":"Consultar status da análise de chargeback","description":"Endpoint para consultar o status de um chargeback específico de uma transação.","parameters":[{"name":"transaction_id","in":"path","required":true,"description":"ID da transação relacionada ao chargeback.","schema":{"type":"string"}},{"name":"chargeback_id","in":"path","required":true,"description":"ID do chargeback a ser consultado.","schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"description":"Access-token válido. O valor deve ser enviado no formato Bearer {token}\".","schema":{"type":"string"}}],"responses":{"200":{"description":"Consulta do status do chargeback bem-sucedida.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID do chargeback."},"status":{"type":"string","description":"Status atual do chargeback."}}}}}},"400":{"description":"Dados inválidos na requisição.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Código do erro."},"message":{"type":"string","description":"Detalhes do erro."}}}}}},"403":{"description":"Proibição de acesso (token inválido ou permissões insuficientes).","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Código do erro."},"message":{"type":"string","description":"Detalhes do erro."}}}}}},"404":{"description":"Transação não encontrada.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Código do erro."},"message":{"type":"string","description":"Detalhes do erro."}}}}}},"500":{"description":"Erro interno do servidor.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Código do erro."},"message":{"type":"string","description":"Detalhes do erro."}}}}}}}}}}}
```

{% hint style="info" %}
Para ver todos os status possíveis, consulte a seção [<mark style="color:blue;">Enumerados</mark>](https://devcenter.unico.io/unico-idpay/integracao/apis/enumerados).
{% endhint %}

{% hint style="success" %}
Para otimizar a performance da sua aplicação, você também pode implementar nosso [<mark style="color:blue;">Webhook</mark>](https://devcenter.unico.io/idcloud/integracao/webhook) para saber quando realizar a consulta do status do Chargeback.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://devcenter.unico.io/unico-idpay/integracao/apis/api-reference/chargeback.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.