Reembolsar Transacción

Utilice este endpoint para solicitar el reembolso de una transacción pagada.

Entornos Disponibles

Producción

https://api.gateway.com.br/core

Endpoint

• Método: POST
• Endpoint: /transaction/{id}/refund
• Autenticación: Bearer token

Path Params

Nombre	Tipo	Obligatorio	Descripción	Validaciones
id	string (UUID)	Sí	Identificador de la transacción	Debe ser un UUID válido

Ejemplo de Solicitud

cURL

curl --request POST \
--url https://api.gateway.com.br/core/transaction/553e8400-e29b-41d4-a716-436251480000/refund \
--header 'Authorization: Bearer su-token-jwt'

JavaScript

const response = await fetch('https://api.gateway.com.br/core/transaction/553e8400-e29b-41d4-a716-436251480000/refund', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer su-token-jwt'
  }
});

const data = await response.json();

Respuesta Exitosa

Campo	Tipo	Obligatorio	Descripción
id	string (UUID)	Sí	Identificador de la transacción
status	string (enum) - PROCESSING_REFUND	Sí	Reembolso en proceso

Ejemplo de Respuesta

{
  "id": "553e8400-e29b-41d4-a716-436251480000",
  "status": "PROCESSING_REFUND"
}

Errores Posibles

Código	Descripción	Solución
401	Credenciales inválidas	Verifique sus credenciales
403	Sin permiso/autorización	Contacte al soporte
404	Registro no encontrado	Verifique el id enviado
422	Datos inválidos o faltantes	Verifique el formato de los datos
422	Validaciones	Contacte al soporte
500	Error interno	Contacte al soporte