Detalle de Retiro

`GET /withdraw/:id`

Retorna los detalles completos de un retiro específico. Solo el propietario del retiro puede consultar sus detalles.

Autenticación

Bearer Token (Authorization: Bearer {token}) o Credenciales de App (app-id + app-secret en headers).

Request

curl -X GET https://api.qvapay.com/withdraw/12345 \
  -H "Authorization: Bearer {tu-token}"

Parámetros de URL

Parámetro	Tipo	Descripción
`id`	number	ID del retiro

Response

{
  "result": "OK",
  "data": {
    "id": 12345,
    "amount": 50.00,
    "receive": 48.50,
    "payment_method": "tron_usdt",
    "status": "completed",
    "details": {
      "wallet": "TXxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    },
    "tx_id": "abc123def456...",
    "evidence_url": "https://tronscan.org/#/transaction/abc123def456...",
    "created_at": "2025-06-20T14:30:00.000Z",
    "updated_at": "2025-06-20T15:00:00.000Z",
    "transaction": {
      "uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "amount": 50.00,
      "description": "Retiro tron_usdt",
      "status": "completed",
      "created_at": "2025-06-20T14:30:00.000Z",
      "updated_at": "2025-06-20T15:00:00.000Z"
    }
  }
}

Campos de respuesta

Campo	Tipo	Descripción
`id`	number	ID del retiro
`amount`	number	Monto solicitado
`receive`	number	Monto recibido después de fees
`payment_method`	string	Método de pago / moneda utilizada
`status`	string	Estado del retiro (pending, processing, completed, failed)
`details`	object	Detalles del retiro (wallet, etc.)
`tx_id`	string \| null	ID de transacción en la blockchain
`evidence_url`	string \| null	URL de evidencia o explorador de blockchain
`created_at`	string	Fecha de creación (ISO 8601)
`updated_at`	string	Fecha de última actualización (ISO 8601)
`transaction`	object	Transacción asociada en QvaPay
`transaction.uuid`	string	UUID de la transacción
`transaction.amount`	number	Monto de la transacción
`transaction.description`	string	Descripción de la transacción
`transaction.status`	string	Estado de la transacción
`transaction.created_at`	string	Fecha de creación de la transacción
`transaction.updated_at`	string	Fecha de actualización de la transacción

Errores

Código	Descripción
`400`	ID de retiro no proporcionado o inválido
`403`	El retiro no pertenece al usuario autenticado
`404`	Retiro no encontrado

GET /withdraw/:id