Chargeback

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

Solicitar revisión de chargeback

POST /credit/transactions/{transaction_id}/chargeback — solicita una revisión de chargeback para una transacción especificada.

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",
  "documents": [
    { "label": "FILE_NAME", "data": "JVBERi0xLjQKMSAwI==" }
  ]
}

Campo	Tipo	Requerido	Descripción
datetime	string	sí	Fecha y hora de la solicitud de 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 de la solicitud de chargeback.
observation	string	no	Observaciones generales sobre la solicitud.
documents	array	no	Documentos relacionados con el chargeback. Hasta 3 elementos, cada uno codificado en Base64 — solo PDF.
documents[].label	string	sí (por elemento)	Nombre o descripción del archivo.
documents[].data	string	sí (por elemento)	Archivo PDF codificado en Base64.

200 OK

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

Campo	Descripción
id	ID de chargeback generado.

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

Obtener estado de la revisión de 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.

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.