User
GOLD
Consultar el estado GOLD del usuario y comprar o regalar planes GOLD.
GET /user/gold
Retorna el estado del plan GOLD del usuario autenticado.
Autenticacion
Bearer Token (Authorization: Bearer {token}).
Request
curl -X GET https://api.qvapay.com/user/gold \
-H "Authorization: Bearer {token}"Response
{
"user": {
"golden_check": true,
"golden_expire": "2026-06-01T00:00:00.000Z"
}
}Campos de respuesta
| Campo | Tipo | Descripcion |
|---|---|---|
user.golden_check | boolean | Si tiene plan GOLD activo |
user.golden_expire | string|null | Fecha de expiracion del plan GOLD |
POST /user/gold
Compra un plan GOLD para si mismo o para otro usuario. El costo se descuenta del balance del usuario autenticado.
Autenticacion
Bearer Token (Authorization: Bearer {token}).
Request
curl -X POST https://api.qvapay.com/user/gold \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"duration": 3
}'Parametros
| Parametro | Tipo | Requerido | Descripcion |
|---|---|---|---|
uuid | string | Si | UUID o username del usuario destino |
duration | number | Si | Duracion en meses |
Precios
| Duracion | Costo (USD) |
|---|---|
| 1 mes | $4.99 |
| 3 meses | $14.97 |
| 6 meses | $29.94 |
| 12 meses | $49.99 |
Response
{
"success": true,
"user": "juan123",
"isSelfPurchase": false,
"duration": 3
}Campos de respuesta
| Campo | Tipo | Descripcion |
|---|---|---|
success | boolean | Si la compra fue exitosa |
user | string | Username del usuario que recibio el GOLD |
isSelfPurchase | boolean | Si fue una compra para si mismo |
duration | number | Duracion en meses del plan adquirido |
Errores
| Codigo | Descripcion |
|---|---|
400 | Datos invalidos o balance insuficiente |
401 | No autorizado o token invalido |
404 | Usuario destino no encontrado |