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"
}

🚀 NUESTRA API YA ESTA EN POSTMAN

🫱🏻‍🫲🏻 Utiliza todos los servicios de QvaStores desde tu plataforma.

🌎 Conecta tu APP con nuestra API y comienza a aceptar Criptomonedas como pago

💻 Recibe depósitos, realiza cambios a FIAT, transferencias, extracciones, SWAP de Criptomonedas y mucho más.

🧾 CONSULTA LA DOC AQUI:
⛓https://documenter.getpostman.com/view/31995211/2sB3BGHVck

DOCUMENTACIÓN API

¿Qué puedo hacer con la documentación API de QvaStores?

• Crea sistemas automatizados desde tu web, acepta pagos automáticos con Criptomonedas, realiza transferencias, extracciones a Cripto o a FIAT, tu decides.

ENDPOINTS QUE ENCONTRARÁS:

USUARIO: Registro de usuario / Login / Verificación 2FA / Datos de usuario

MONEDAS: Lista de monedas

TRANSACCIONES: Depósitos / Transferencias / Extracción / SWAP de Criptomonedas / Obtener transacciones / Estado de transacción

CAMBIO A FIAT: Cambio a FIAT / Validar tarjeta / Monto a acreditar / Taxes

CONSULTA TODA LA DOCUMENTACIÓN AQUÍ👇🏻
https://documenter.getpostman.com/view/31995211/2sB3BGHVck#5b4356b3-cbd1-4fc7-888d-e8f21e128245

FACTURAS PARA NEGOCIOS

• Este endpoint te permiten crear Facturas únicas que solo pueden pagarse con Fondos Automáticos, lo que permite transferir o extraer los fondos al instante

OTRAS VENTAJAS
• Tu negocio puede cobrar Criptomonedas de manera fácil por un servicio/producto
• El usuario realiza el pago con solo un click
• Notificaciones instantáneas

DOCUMENTACIÓN:
https://documenter.getpostman.com/view/31995211/2sB3BGHVck#1f2c3396-0ac8-4309-a513-2d9a50e8ca62

🧩 REALIZA ENTREGAS USD DE EFECTIVO EN TODA CUBA 🇨🇺 DESDE TU PLATAFORMA

⚙️ Ya tenemos lista nuestra API para trabajar con las entregas de USD efectivo en toda Cuba.

↔️ Realiza solicitudes de entrega desde tu plataforma o APP de manera fácil

❓️QUÉ PUEDES ENCONTRAR EN LA DOC API:
• 🏙 Consulta las Provincias y Municipios disponibles en tiempo real.
• 💵 Solicita la entrega de USD efectivo utilizando los datos del destinatario.

📃 DOCUMENTACIÓN API:
🔗 https://documenter.getpostman.com/view/31995211/2sB3BGHVck#491da9c2-33c3-46a0-bb2f-c0b96e3370ac