QvaPay API
Merchants

Detalle de Transacción

Obtener los detalles de una transacción específica.

POST /v2/transactions/:uuid

Retorna los detalles completos de una transacción específica, incluyendo información del pagador si la transacción fue completada.

Autenticación

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

Request

curl -X POST https://api.qvapay.com/v2/transactions/7c9e6679-7425-40de-944b-e07fc1f90ae7 \
  -H "Content-Type: application/json" \
  -H "app-id: {tu-app-uuid}" \
  -H "app-secret: {tu-app-secret}"

Parámetros de URL

ParámetroTipoDescripción
uuidstringUUID de la transacción

Response

{
  "message": "APP Transaction",
  "transaction": {
    "uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "amount": 25.00,
    "description": "Compra de producto",
    "products": [
      {
        "name": "Producto 1",
        "price": 25.00,
        "quantity": 1
      }
    ],
    "remote_id": "order-12345",
    "status": "paid",
    "created_at": "2024-06-20T14:30:00.000Z",
    "updated_at": "2024-06-20T14:30:00.000Z",
    "PaidBy": {
      "uuid": "user-uuid",
      "name": "Juan",
      "username": "juan123",
      "lastname": "Pérez",
      "image": "avatars/juan.jpg",
      "vip": false,
      "kyc": "verified",
      "golden_check": false
    }
  }
}

Campos adicionales

CampoTipoDescripción
PaidByobject | nullInformación del pagador (null si no se ha pagado)
PaidBy.uuidstringUUID del usuario pagador
PaidBy.namestringNombre del pagador
PaidBy.usernamestringUsername del pagador
PaidBy.lastnamestringApellido del pagador
PaidBy.imagestringAvatar del pagador
PaidBy.vipbooleanSi el usuario es VIP
PaidBy.kycstringEstado de verificación KYC
PaidBy.golden_checkbooleanSi tiene verificación golden

Errores

CódigoDescripción
404Transacción no encontrada o no pertenece a tu app