POST - Login

Descripción: Utiliza tus credenciales para obtener un token válido

NOTA: Si tu cuenta tiene el 2FA activo, deberás validar tu sesión con tu código.

🔗 https://qvastores.com/api/version01/login

Encabezado
Content-Type: application/json

PARÁMETROS:
• email: Correo electrónico
• password: Contraseña

Respuesta: JSON

{
  "status": "success",
  "message": "Inicio de sesión exitoso.",
  "data": {
    "jwt": "TuTokenJWT"
  }
}

Respuesta: Error

{
  "status": "error",
  "message": "Contraseña incorrecta."
}

POST - Registro de usuario

Descripción: Registro de usuario en QvaStores

🔗 https://qvastores.com/api/version01/register

Encabezado
Content-Type: application/json

PARÁMETROS:
• full_name: Nombre y Apellidos
• email: Correo electrónico
• password: Contraseña
• confirm_password: Contraseña
• refer: ( Opcional ) Código de referido

Respuesta: JSON

{
  "status": "success",
  "message": "Registro exitoso. Verifica tu correo electrónico."
}

Respuesta: Error

{
  "status": "error",
  "message": "El correo electrónico ya está registrado."
}

Lista de monedas

Descripción: Estas son las Criptomonedas disponibles para el depósito en QvaStores de forma Manual

• usdttrc20: USDT TRC20
• trx: TRON ( TRX )
• usdtbep20: USDT BSC ( BEP20 )
• btc: Bitcoin
• eth: Ethereum
• bch: Bitcoin Cash
• ltc: Litecoin

Para obtener las monedas para el depósito de forma automática

GET - Obtener monedas
🔗 https://qvastores.com/api/version01/get_coins

Encabezado:
Content-Type: application/json

PARÁMETROS:
• coins

Ejemplo de respuesta: JSON

{
  "currencies": [
    {
      "currency": "BTC",
      "logo_url": "https://qvastores.com/coins/btc.svg",
      "network": "btc",
      "min_amount": 0.00011621,
      "fiat_equivalent": 13.78
    },
    {
      "currency": "USDTTRC20",
      "logo_url": "https://qvastores.com/coins/usdttrc20.svg",
      "network": "trx",
      "min_amount": 17.819761,
      "fiat_equivalent": 17.78
    },
    {
      "currency": "USDC",
      "logo_url": "https://qvastores.com/coins/usdc.svg",
      "network": "eth",
      "min_amount": 13.804252,
      "fiat_equivalent": 13.78
    }
  ]
}

DESCRIPCIÓN DE RESPUESTA:
• currency: Moneda
• logo_url: Logo de la moneda
• network: Red de depósito
• min_amount: Mínimo de depósito
• fiat_equivalent: Equivalente en USD al mínimo de depósito

POST - Depósito

Descripción: Realiza un depósito a tu cuenta

🔗 https://qvastores.com/api/version01/deposit

AUTENTICACIÓN:
La API requiere autenticación mediante un token JWT. El token debe ser incluido en el encabezado de autorización de la solicitud HTTP

Encabezado de Autenticación:

Authorization: Bearer <token_jwt>
Content-Type: application/json

PARÁMETROS:
• amount: Monto en dólares a depositar
• pay_method: Método de depósito
• pay_currency: Moneda a depositar/ consultar lista
• url_callback: ( Opcional ) Establece una url de notificación

NOTA: Hay 3 tipos de métodos de pago ( pay_method ) en QvaStores
• manual: Depósito manual
• automatic: Depósito automático
• qvapay: Depósito con QvaPay

Respuesta: JSON ( manual, automatic )

{
  "status": "Confirmando",
  "transaction": "dp-79e1-2208f8-584",
  "pay_method": "manual",
  "amount": 100,
  "pay_currency": "usdtbep20",
  "crypto_amount": "100.03901522",
  "address": "0x3e65f2bfe096a72d149f2502e42e331e746b7c2c",
  "created_at": "2025-01-26 19:49:01",
  "payment_url": "https://qvastores.com/invoice?id=dp-79e1-2208f8-584"
}

Respuesta: JSON ( qvapay )

{
  "status": "Confirmando",
  "transaction": "dp-4aff-a24be8-d55",
  "pay_method": "qvapay",
  "amount": 100,
  "created_at": "2025-01-26 20:01:10",
  "payment_url": "https://qvapay.com/pay/8ae62caa-8fc4-40c8-8b24-589e5ebdfc94?expires=1737941470&signature=29ff44362219bd68f95a187ebea371bbb10f492a78042e5f278b0f600cd3f4d8"
}

POST - Remesa

Descripción: Solicita una remesa

🔗 https://qvastores.com/api/version01/remesa

AUTENTICACIÓN:
La API requiere autenticación mediante un token JWT. El token debe ser incluido en el encabezado de autorización de la solicitud HTTP

Encabezado de Autenticación:

Authorization: Bearer <token_jwt>
Content-Type: application/json

PARÁMETROS:
• product_id: ID del producto ( 1 Remesa MLC, 2 Remesa CUP, 3 Remesa Clásica o Prepago BANDEC )
• amount: Monto a enviar
•cupon: ( Opcional ) Cupón de descuento
• card: Tarjeta destinataria
• type: Tipo de remesa ( mlc, cup o usd )
• url_callback: ( Opcional ) Establece una url de notificación

Respuesta: JSON

{
    "order_id": "or-9c74-f9080f-5f0",
    "product_id": 3,
    "name": "USD Clásica y PrepagoBANDE",
    "email": "soporte@qvastores.com",
    "amount": 100,
    "discount": 0,
    "total": 100,
    "cupon": "none",
    "acreditar": "104.00",
    "card": "9245111144447777",
    "type": "usd"
}

Respuesta: Error

{
  "error": "Fondos insuficientes."
}

IPN ( Notificaciones de pago instantáneo )

Descripción: Configura tu url_callback para las notificaciones de pago

Tu url_callback debe recibir datos de esta forma:
Método: POST
Cabeceras:
Content-Type: application/json

Ejemplo de notificación de Depósito:

{
    "type": "deposit",
    "transaction": "dp-a38e-30bcca-f6d",
    "status": "Cancelado",
    "updated_at": "2025-01-29 01:39:56"
}

Ejemplo de notificación de Orden:

{
    "type": "order",
    "order_id": "or-b00f-ec406c-7f3",
    "status": "Completado",
    "updated_at": "2025-01-29 01:43:56"
}

Ejemplo de notificación de Extracción:

{
    "transaction": "wt-e9c6-83c1f4-fc9",
    "status": "finished",
    "fee": "0.2"
    "hash": "0x3e65f2bfe096a72d149f2502e42e331e746b7c2c"
}

Ejemplo de notificación de SWAP:

{
    "transaction": "swap-e9c6-83c1f4-fc9",
    "status": "finished",
    "fee": "0.2"
    "hash": "0x3e65f2bfe096a72d149f2502e42e331e746b7c2c"
}

Estados:
• partially_paid: El depósito automático fue parcialmente pagado
• Confirmando: El depósito manual esta siendo revisado
• Confirmado: El depósito fue completado
• Cancelado: El depósito no se pagó luego de 24 horas
• Procesando: La orden esta siendo procesada
• Completado: La orden fue completada
• finished: Extracción/SWAP completado
• expired: Depósito o SWAP expirado

GET - Obtener transacciones

🔗 https://qvastores.com/api/version01/transactions

Parámetros:
• type: Utiliza order o deposit según lo que desee listar
• pageSize: Número de elementos por página
• pg: Número de la página

Encabezado de autorización:
Authorization: Bearer <token_jwt>
Content-Type: application/json

Ejemplo de respuesta: JSON

{
  "status": "success",
  "data": [
    {
      "transaction": "dp-3d79-bf6092-091",
      "address": "",
      "amount": "886.50",
      "pay_method": "qvapay",
      "pay_currency": "qvapay",
      "crypto_amount": "0.00000000",
      "status": "Confirmando",
      "url_callback": "",
      "created_at": "2025-01-29 00:42:20",
      "updated_at": null
    },
    {
      "transaction": "dp-cab5-607c55-202",
      "address": "",
      "amount": "98.50",
      "pay_method": "qvapay",
      "pay_currency": "qvapay",
      "crypto_amount": "0.00000000",
      "status": "Confirmando",
      "url_callback": "https://ejemplo.com/ipn",
      "created_at": "2025-01-29 00:41:50",
      "updated_at": null
    }
  ]
}

GET - Obtener estados de transacciones

🔗 https://qvastores.com/api/version01/last_transactions

Encabezado:
Content-Type: application/json

Parámetros:
• transaction: Puedes utilizar tanto números de ordenes o depósitos, el sistema lo reconocerá automáticamente

Ejemplo de respuesta: JSON

{
    "status": "success",
    "data": {
        "transaction": "dp-2d6e-7b3f49-af7",
        "status": "Confirmado"
    }
}

GET - Datos de usuario

🔗 https://qvastores.com/api/version01/user_data

Encabezado de Autenticación:

Authorization: Bearer <token_jwt>
Content-Type: application/json

Parámetros: Ninguno

Ejemplo de respuesta: JSON

{
  "status": "success",
  "data": {
    "full_name": "Tu nombre",
    "photo_profile": null,
    "balance": "822.89",
    "uid": 0101010101,
    "xp": "12.00",
    "plan": "Free",
    "refer": "TJiuTR",
    "refer_by": null,
    "phone": "Digita tu número",
    "bio": "Licenciado en..",
    "confirm_email": "enabled",
    "cupon_email": "enabled",
    "confirm_sms": "disabled",
    "created_at": "2025-01-04 13:06:30"
  }
}

POST - Validar tarjeta

Descripción: Valida el tipo de tarjeta según el tipo de remesa

🔗 https://qvastores.com/api/version01/validate_card

Encabezado:
Content-Type: application/json

Parámetros:
• card: Tarjeta bancaria
• type: Tipo de tarjeta ( mlc o cup )

Ejemplo de respuesta: JSON

{
  "status": "success",
  "card": "valid",
  "message": "Tarjeta válida"
}

GET - TAXES

Descripción: Obtén la tasa de cambio oficial actualizada de QvaStores

🔗 https://qvastores.com/api/version01/taxes

Encabezado:
Content-Type: application/json

Parámetros: Ninguno

Ejemplo de respuesta: JSON

{
  "MLC1Lv": "1.00",
  "MLC2Lv": "1.40",
  "MLC3Lv": "1.45",
  "CUP1Lv": "300.00",
  "CUP2Lv": "360.00",
  "CUP3Lv": "365.00",
  "USD1Lv": "1.01",
  "USD2Lv": "1.02",
  "USD3Lv": "1.02",
  "Recargas": "300.00",
  "created_at": "2024-08-16 09:13:08"
}

NOTA: 1Lv se utiliza para montos menores de 100$, 2Lv para montos de 100$ o más, 3Lv para montos de 200$ o más

GET - Calcular el monto a acreditar

Descripción:
Recibe la cantidad exacta que se acreditará a la tarjeta proporcionando monto y tipo de remesa

🔗 https://qvastores.com/api/version01/acreditar

Encabezado:
Content-Type: application/json

Parámetros:
• type: Tipo de remesa ( mlc, cup o usd para Tarjetas Clásicas o Prepago BANDEC )
• amount: Monto a enviar

Ejemplo de respuesta: JSON

{
  "type": "usd",
  "amount": "100",
  "acreditar": "101",
  "tax": "1.01"
}

POST - Retiro Automático a Cripto

Descripción: Realiza un retiro automático desde tu balance depositado automáticamente a una Wallet externa.

🔗 https://qvastores.com/api/version01/create_withdraw

🔐 AUTENTICACIÓN:
La API requiere autenticación mediante un token JWT. El token debe ser incluido en el encabezado de autorización de la solicitud HTTP.

Encabezado de autenticación:

Authorization: Bearer <token_jwt>
Content-Type: application/json

📥 PARÁMETROS:
• wallet: Dirección de la wallet a la que se enviará el retiro
• to_currency: Criptomoneda a la que se desea retirar (ver lista de monedas disponibles)
• from_amount: Monto en dólares a retirar (mínimo 10 USD)
• url_callback: ( Opcional => Se le envía como POST los datos de transaction, status, fee y hash, toca para consultar ejemplo )

⚠️ REQUISITOS Y VALIDACIONES:
• Solo se permiten retiros de fondos depositados de forma automática
• Se valida que la wallet sea compatible con la moneda seleccionada

📤 RESPUESTA: JSON

{
  "payment_id": "pay_66a432f3ad3ff",
  "transaction": "wt-e9c6-83c1f4-fc9",
  "from_amount": "50",
  "to_currency": "ltc",
  "address": "LR3Zgvf4tjcCR4C9txMEdyLGUAKXhtnPP3",
  "status": "processing",
  "created_at": "2025-07-13 22:11:01"
}

❌ ERRORES POSIBLES:

status: error / message:
• Token no proporcionado / inválido
• Faltan datos requeridos
• La cantidad mínima para extraer es 10 USD
• Fondos automáticos insuficientes
• Solo puedes extraer fondos depositados automáticamente
• La wallet X no es una dirección válida Y

POST - Transferencia

Descripción: Realiza una transferencia de saldo de usuario a usuario

🔗 https://qvastores.com/api/version01/transfer

🔐 AUTENTICACIÓN:
La API requiere autenticación mediante un token JWT. El token debe ser incluido en el encabezado de autorización de la solicitud HTTP.

Encabezado de autenticación:

Authorization: Bearer <token_jwt>
Content-Type: application/json

📥 PARÁMETROS:
• email: Correo electrónico destinatario
• amount: Monto a transferir ( Mínimo 1 USD )

⚠️ REQUISITOS Y VALIDACIONES:
• Solo se permiten transferir los fondos depositados de forma automática

📤 RESPUESTA: JSON

{
  "transaction": "ti-e9c6-83c1f4-fc9",
  "amount": 50,
  "type": "TRANSFER",
  "from_user": "tucorreo@gmail.com",
  "to_user": "correodestino@gmail.com",
  "created_at": "2025-07-13 22:11:01",
  "updated_at": "2025-07-13 22:11:01"
}

❌ ERRORES POSIBLES:

status: error / message:
• Usuario receptor no encontrado
• Fondos automáticos insuficientes
• Error al procesar la transferencia

POST - SWAP de Criptomonedas

Descripción: Realiza un cambio automático de una Cripto a otra Cripto, recibe en una wallet externa.

🔗 https://qvastores.com/api/version01/swap_deposit

🔐 AUTENTICACIÓN:
La API requiere autenticación mediante un token JWT. El token debe ser incluido en el encabezado de autorización de la solicitud HTTP.

Encabezado de autenticación:

Authorization: Bearer <token_jwt>
Content-Type: application/json

📥 PARÁMETROS:
• amount: Cantidad en dólares a intercambiar
• pay_currency: Moneda que se enviará
• to_currency: Moneda que se recibirá
• wallet: Wallet donde se recibirá
• url_callback: ( Opcional => Se le envía como POST los datos de transaction, status, fee y hash, toca para consultar ejemplo )

📤 RESPUESTA: JSON

{
  "status": "Confirmando",
  "transaction": "swap-e9c6-83c1f4-fc9",
  "amount": "50",
  "pay_currency": "BTC",
  "crypto_amount": "0.00455",
  "address": "LKfypNJnNsHcHfr6keA84R1fnz4WuH9cOU",
  "created_at": "2025-07-13 22:11:01",
  "payment_url": "https://qvastores.com/invoice"
}

❌ ERRORES POSIBLES:

status: error / message:
• La moneda pago y moneda destino no pueden ser iguales
• La wallet X no es una dirección válida Y
• El mínimo de SWAP con BTC es de $17
• Error al procesar el SWAP

POST - Verificación 2FA ( Validar sesión )

🔗 https://qvastores.com/api/version01/verify2fa

Descripción: Valida tu sesión con el código 2FA, necesario para las funciones más sensibles. ( Solo en caso de tener habilitado el 2FA )

Parámetros:
• code: Tu código 2FA de 6 dígitos

Encabezado de autorización:
Authorization: Bearer <token_jwt>
Content-Type: application/json

Ejemplo de respuesta: JSON

{
  "status": "success",
  "message": "Código 2FA verificado correctamente"
}