Consultar Estado del Retiro

Utilice este endpoint para consultar solo el estado de un retiro específico por su id.

La respuesta trae únicamente el id y el status, sin el resto de los datos del retiro. Cuando necesite el registro completo, use Consultar Retiro.

Entornos Disponibles

Producción

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

Endpoint

• Método: GET
• Endpoint: /withdrawal/{id}/status
• Autenticación: Bearer token

Path Params

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

Ejemplo de Solicitud

cURL

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

JavaScript

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

Respuesta Exitosa

Campo	Tipo	Obligatorio	Descripción
id	string (UUID)	Sí	Identificador único del retiro
status	string (enum) - PENDING, PROCESSING, PROCESSED, FAILED, CANCELED, REFUNDED, REJECTED, PENDING_COMPLIANCE	Sí	PENDING: retiro creado, esperando procesamiento PROCESSING: retiro en procesamiento PROCESSED: retiro procesado con éxito FAILED: error en el procesamiento CANCELED: retiro cancelado REFUNDED: retiro reembolsado REJECTED: retiro rechazado por el gateway PENDING_COMPLIANCE: retiro pendiente de análisis de compliance

Ejemplo de Respuesta

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

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