Chargeback

Markdown

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.

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 é contestar

Este endpoint apenas comunica o chargeback. Ele não abre uma análise de chargeback e não aciona a garantia de liability. Para que a Unico analise o chargeback, abra uma contestação da transação no portal.

Headers

Header	Valor
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"
}

Campo	Tipo	Obrigatório	Descrição
datetime	string	sim	Data e hora em que o chargeback foi recebido, formato ISO 8601.
requestor	object	sim	Informações do solicitante.
requestor.key	string	sim	Tipo da chave de identificação do solicitante (ex.: cpf).
requestor.value	string	sim	Valor da chave de identificação do solicitante.
name	string	sim	Nome do solicitante.
reason	string	sim	Motivo do chargeback.
observation	string	não	Observações gerais sobre o chargeback.

201 Created

{
  "id": "8263a268-5388-492a-bca2-28e1ff4a69f0"
}

Campo	Descriçã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.

Consultar status do chargeback

GET /credit/transactions/{transaction_id}/chargeback/{chargeback_id} — consulta o status de um chargeback específico.

Headers

Header	Valor
Authorization	Bearer {token} — um access-token válido.

200 OK

{
  "id": "8263a268-5388-492a-bca2-28e1ff4a69f0",
  "status": "waiting"
}

Campo	Descriçã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 para todos os status possíveis. Para otimizar a performance, implemente o Webhook ao invés de consultar este endpoint repetidamente.