Detalle de Transacción

`GET /transaction/:uuid`

Retorna los detalles completos de una transacción específica, incluyendo información de usuarios, app, wallet, P2P, retiros y servicios asociados.

Autenticación

Bearer Token o Credenciales de App (app-id + app-secret en headers).

Request

curl -X GET "https://api.qvapay.com/transaction/7c9e6679-7425-40de-944b-e07fc1f90ae7" \
  -H "Authorization: Bearer <token>"

Parámetros

Parámetro	Tipo	Requerido	Descripción
`uuid`	string	Si	UUID de la transacción (en la URL)

Response

{
  "message": "Transaction 7c9e6679",
  "data": {
    "uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "amount": "25.00",
    "created_at": "2024-06-20T14:30:00.000Z",
    "updated_at": "2024-06-20T14:30:00.000Z",
    "status": "paid",
    "description": "Pago de servicio",
    "remote_id": "order-12345",
    "user": {
      "uuid": "660e8400-e29b-41d4-a716-446655440001",
      "name": "Jane",
      "lastname": "Doe",
      "username": "janedoe",
      "image": "https://example.com/avatar.png",
      "vip": false,
      "kyc": true,
      "golden_check": false
    },
    "paid_by": {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "name": "John",
      "lastname": "Doe",
      "username": "johndoe",
      "image": "https://example.com/avatar2.png",
      "vip": false,
      "kyc": true,
      "golden_check": false
    },
    "app": {
      "uuid": "app-uuid-here",
      "name": "Mi App",
      "url": "https://example.com",
      "logo": "https://example.com/logo.png",
      "desc": "Descripción de la app"
    },
    "wallet": {
      "wallet_type": "crypto",
      "wallet": "TXyz...abc",
      "value": 0.0025,
      "received": 0.0025,
      "txid": "abc123def456",
      "status": "confirmed",
      "created_at": "2024-06-20T14:30:00.000Z",
      "coin": {
        "tick": "BTC",
        "name": "Bitcoin",
        "logo": "https://example.com/btc.png"
      }
    },
    "p2p": {
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "type": "buy",
      "amount": 50.00,
      "receive": 45.00,
      "status": "completed",
      "created_at": "2024-06-20T14:30:00.000Z",
      "coin": {
        "tick": "USDT",
        "name": "Tether",
        "logo": "https://example.com/usdt.png"
      },
      "user": { "uuid": "...", "name": "...", "username": "..." },
      "peer": { "uuid": "...", "name": "...", "username": "..." }
    },
    "cart": {
      "products": [],
      "paid": true,
      "purchased": true,
      "delivered": false,
      "cancelled": false,
      "address": "123 Main St",
      "store_id": 1,
      "tracking_code": "TRACK123",
      "note": "Entregar en horario de oficina",
      "created_at": "2024-06-20T14:30:00.000Z"
    },
    "withdraw": {
      "amount": 25.00,
      "receive": 23.50,
      "payment_method": "paypal",
      "status": "paid",
      "tx_id": "PAYPAL-TX-123",
      "evidence_url": "https://example.com/evidence.png",
      "created_at": "2024-06-20T14:30:00.000Z",
      "coin": {
        "tick": "USDT",
        "name": "Tether",
        "logo": "https://example.com/usdt.png"
      }
    },
    "service": {
      "amount": 10.00,
      "status": "completed",
      "created_at": "2024-06-20T14:30:00.000Z",
      "service": {
        "uuid": "svc-uuid",
        "name": "Recarga Cubacel",
        "logo": "https://example.com/cubacel.png",
        "sublogo": "https://example.com/cubacel-sub.png"
      }
    }
  }
}

Campos de respuesta

Campo	Tipo	Descripción
`uuid`	string	UUID de la transacción
`amount`	string	Monto con 2 decimales
`status`	string	Estado: `pending`, `paid`, `cancelled`
`description`	string	Descripción de la transacción
`remote_id`	string	Identificador externo
`created_at`	string	Fecha de creación
`updated_at`	string	Fecha de actualización
`user`	object \| null	Usuario que recibe el pago
`paid_by`	object \| null	Usuario que realizó el pago
`app`	object \| null	Aplicación asociada
`wallet`	object \| null	Wallet: `wallet_type`, `wallet`, `value`, `received`, `txid`, `status`, `created_at`, `coin` (`tick`, `name`, `logo`)
`p2p`	object \| null	P2P: `uuid`, `type`, `amount`, `receive`, `status`, `created_at`, `coin` (`tick`, `name`, `logo`), `user`, `peer`
`cart`	object \| null	Carrito: `products`, `paid`, `purchased`, `delivered`, `cancelled`, `address`, `store_id`, `tracking_code`, `note`, `created_at`
`withdraw`	object \| null	Retiro: `amount`, `receive`, `payment_method`, `status`, `tx_id`, `evidence_url`, `created_at`, `coin` (`tick`, `name`, `logo`)
`service`	object \| null	Servicio: `amount`, `status`, `created_at`, `service` (`uuid`, `name`, `logo`, `sublogo`)

Errores

Código	Descripción
`401`	Token de autenticación inválido o ausente
`404`	Transacción no encontrada o no pertenece al usuario

GET /transaction/:uuid