Chargeback

Markdown

Antes de empezar

Tus solicitudes a la API se autentican mediante un token de acceso. Cualquier solicitud que no incluya un token de acceso válido devolverá un error. Obtén más información en Autenticación.

URL base

• UAT: https://transactions.transactional.uat.unico.app/api/public/v1
• Producción: https://transactions.transactional.unico.app/api/public/v1

Reportar un chargeback

POST /credit/transactions/{transaction_id}/chargeback — informa a Unico que se recibió un chargeback para una transacción especificada.

Reportar no es una impugnación

Este endpoint solo reporta el chargeback. No abre un análisis de chargeback y no activa la garantía de responsabilidad. Para que Unico analice el chargeback, abre una impugnación de la transacción en el portal.

Encabezados

Encabezado	Valor
Authorization	Bearer {token} — un token de acceso válido.

Cuerpo

{
  "datetime": "2023-01-05T03:00:00.000Z",
  "requestor": { "key": "cpf", "value": "USER_CPF" },
  "name": "USER_NAME",
  "reason": "REQUEST_REASON",
  "observation": "GENERAL_OBSERVATIONS"
}

Campo	Tipo	Requerido	Descripción
datetime	string	sí	Fecha y hora en que se recibió el chargeback, formato ISO 8601.
requestor	object	sí	Información del solicitante.
requestor.key	string	sí	Tipo de clave de identificación del solicitante (por ejemplo, cpf).
requestor.value	string	sí	Valor de la clave de identificación del solicitante.
name	string	sí	Nombre del solicitante.
reason	string	sí	Motivo del chargeback.
observation	string	no	Observaciones generales sobre el chargeback.

201 Created

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

Campo	Descripción
id	ID del chargeback.

Una transacción tiene un único chargeback. Reportar una transacción que ya tiene uno devuelve 200 OK con el id del chargeback existente, y no lo modifica.

Para respuestas de error, consulta Errores — Creación de transacción.

Obtener estado del chargeback

GET /credit/transactions/{transaction_id}/chargeback/{chargeback_id} — verifica el estado de un chargeback específico.

Encabezados

Encabezado	Valor
Authorization	Bearer {token} — un token de acceso válido.

200 OK

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

Campo	Descripción
id	ID del chargeback.
status	Estado actual del chargeback.

Un chargeback reportado permanece en waiting. Si la transacción se impugna en el portal, el mismo id muestra el progreso y el resultado del análisis. Consulta Enumerados — Resultado del chargeback para ver todos los estados posibles. Para optimizar el rendimiento, implementa el Webhook en lugar de hacer polling a este endpoint.