QvaPay

https://www.qvapay.com/docs
Admin
QvaPay is a payment processing API that enables merchants to accept payments, manage balances, and...
Tokens:19,116
Snippets:148
Trust Score:8.1
Update:2 months ago
Show doc for...
Tokens:
Raw
### App Info Response Structure

Source: https://www.qvapay.com/docs/merchants/info

Example JSON response containing application metadata and configuration settings.

```json
{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Mi Tienda",
  "url": "https://mitienda.com",
  "desc": "Tienda de productos digitales",
  "callback": "https://mitienda.com/webhook",
  "success_url": "https://mitienda.com/success",
  "cancel_url": "https://mitienda.com/cancel",
  "logo": "apps/logo.png",
  "active": true,
  "enabled": true,
  "card": false,
  "created_at": "2024-01-15T10:30:00.000Z",
  "updated_at": "2024-06-20T14:00:00.000Z",
  "app_photo_url": "https://media.qvapay.com/apps/logo.png"
}
```

--------------------------------

### Registration Success Response

Source: https://www.qvapay.com/docs/auth/register

Example of the JSON response returned upon successful user creation.

```json
{
  "message": "Registro exitoso",
  "user": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "email": "usuario@ejemplo.com",
    "name": "Juan",
    "username": "juan123"
  }
}
```

--------------------------------

### GET /app

Source: https://www.qvapay.com/docs/app/list

Obtiene la lista de todas las aplicaciones registradas por el usuario autenticado.

```APIDOC
## GET /app

### Description
Retorna la lista de todas las aplicaciones registradas por el usuario autenticado.

### Method
GET

### Endpoint
https://api.qvapay.com/app

### Autenticación
Bearer Token en header Authorization.

### Request Example
curl -X GET https://api.qvapay.com/app \
  -H "Authorization: Bearer {tu-token}"

### Response
#### Success Response (200)
- **uuid** (string) - Identificador único de la app
- **name** (string) - Nombre de la app
- **url** (string) - URL principal de la app
- **logo** (string) - URL del logo de la app
- **description** (string) - Descripción de la app
- **callback** (string) - URL de callback para notificaciones
- **success_url** (string) - URL de redirección en pago exitoso
- **cancel_url** (string) - URL de redirección en pago cancelado
- **active** (boolean) - Si la app está activa
- **enabled** (boolean) - Si la app está habilitada
- **allowed_payment_auth** (boolean) - Si permite autenticación de pagos
- **card** (object/null) - Tarjeta asociada a la app
- **created_at** (string) - Fecha de creación
- **updated_at** (string) - Fecha de última actualización

#### Response Example
[
  {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Mi Tienda",
    "url": "https://mitienda.com",
    "logo": "https://cdn.qvapay.com/apps/logo.png",
    "description": "Tienda de productos digitales",
    "callback": "https://mitienda.com/callback",
    "success_url": "https://mitienda.com/success",
    "cancel_url": "https://mitienda.com/cancel",
    "active": true,
    "enabled": true,
    "allowed_payment_auth": false,
    "card": null,
    "created_at": "2024-01-15T10:30:00.000Z",
    "updated_at": "2024-06-20T14:00:00.000Z"
  }
]
```

--------------------------------

### Logout response example

Source: https://www.qvapay.com/docs/auth/logout

Standard JSON response returned upon successful session termination.

```json
{
  "message": "Logged out"
}
```

--------------------------------

### Listar aplicaciones mediante cURL

Source: https://www.qvapay.com/docs/app/list

Realiza una solicitud GET al endpoint de aplicaciones incluyendo el token de autenticación en el encabezado Authorization.

```bash
curl -X GET https://api.qvapay.com/app \
  -H "Authorization: Bearer {tu-token}"
```

--------------------------------

### Retrieve all coins via GET request

Source: https://www.qvapay.com/docs/coins/list

Public endpoint to fetch all currency categories and coin configurations without authentication.

```bash
curl -X GET https://api.qvapay.com/coins
```

--------------------------------

### Global logout response example

Source: https://www.qvapay.com/docs/auth/logout

Standard JSON response returned upon successful termination of all user sessions.

```json
{
  "message": "Logged out from all devices"
}
```

--------------------------------

### App Logs Response Structure

Source: https://www.qvapay.com/docs/app/logs

Example of the JSON response returned when successfully querying application logs.

```json
{
  "logs": [
    {
      "id": 1,
      "type": "request",
      "method": "POST",
      "path": "/v2/create_invoice",
      "status": 200,
      "created_at": "2024-06-20T14:30:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 150,
    "pages": 3
  }
}
```

--------------------------------

### Consultar historial de precios con cURL

Source: https://www.qvapay.com/docs/coins/price-history

Ejemplo de solicitud GET para obtener el historial de precios de BTC en las últimas 24 horas.

```bash
curl -X GET "https://api.qvapay.com/coins/price-history/BTC?timeframe=24H"
```

--------------------------------

### GET /app/:uuid

Source: https://www.qvapay.com/docs/app/detail

Retrieves the details of a specific application associated with the authenticated user.

```APIDOC
## GET /app/:uuid

### Description
Retorna los detalles de una aplicación específica del usuario autenticado.

### Method
GET

### Endpoint
https://api.qvapay.com/app/:uuid

### Parameters
#### Path Parameters
- **uuid** (string) - Required - UUID de la app

### Response
#### Success Response (200)
- **uuid** (string) - Identificador único de la app
- **name** (string) - Nombre de la app
- **url** (string) - URL principal de la app
- **logo** (string) - URL del logo de la app
- **description** (string) - Descripción de la app
- **callback** (string) - URL de callback para notificaciones
- **success_url** (string) - URL de redirección en pago exitoso
- **cancel_url** (string) - URL de redirección en pago cancelado
- **active** (boolean) - Si la app está activa
- **enabled** (boolean) - Si la app está habilitada
- **allowed_payment_auth** (boolean) - Si permite autenticación de pagos
- **card** (object) - Tarjeta asociada a la app
- **created_at** (string) - Fecha de creación
- **updated_at** (string) - Fecha de última actualización

#### Response Example
{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Mi Tienda",
  "url": "https://mitienda.com",
  "logo": "https://cdn.qvapay.com/apps/logo.png",
  "description": "Tienda de productos digitales",
  "callback": "https://mitienda.com/callback",
  "success_url": "https://mitienda.com/success",
  "cancel_url": "https://mitienda.com/cancel",
  "active": true,
  "enabled": true,
  "allowed_payment_auth": false,
  "card": null,
  "created_at": "2024-01-15T10:30:00.000Z",
  "updated_at": "2024-06-20T14:00:00.000Z"
}
```

--------------------------------

### Consultar detalle de un coin mediante cURL

Source: https://www.qvapay.com/docs/coins/detail

Ejemplo de solicitud GET para obtener la información de un coin específico utilizando su ID.

```bash
curl -X GET https://api.qvapay.com/coins/6 \
  -H "Authorization: Bearer {tu-token}"
```

--------------------------------

### Example JSON response for coins list

Source: https://www.qvapay.com/docs/coins/list

The structure of the response containing categories and their associated coin objects.

```json
[
  {
    "id": 1,
    "name": "Criptomonedas",
    "logo": "crypto",
    "Coins": [
      {
        "id": "6",
        "coins_categories_id": 1,
        "network": "TRON",
        "name": "USDT (TRC20)",
        "logo": "usdt",
        "tick": "USDT",
        "fee_in": "0.2",
        "fee_in_gold": "0",
        "fee_out": "1",
        "fee_out_gold": "0.8",
        "fee_out_fixed": [100, 1],
        "min_in": "1",
        "min_out": "2",
        "max_in": 1000000,
        "max_out": 5000,
        "working_data": [
          {
            "name": "Wallet",
            "type": "text"
          }
        ],
        "enabled_in": true,
        "enabled_out": true,
        "enabled_p2p": true,
        "auto_withdraw": true,
        "p2p_rate_discount": "0",
        "trade": false,
        "price": "1",
        "decimals": 2,
        "stable": true,
        "created_at": null,
        "updated_at": "2025-06-12T03:40:01.000Z",
        "description": "### ¿Qué es USDT (TRC20)? ...",
        "seo_title": "USDT TRC20 ✓ Compra y envía en QvaPay",
        "seo_description": "USDT TRC20 en QvaPay: stablecoin rápido y seguro..."
      }
    ]
  }
]
```

--------------------------------

### GET /coins

Source: https://www.qvapay.com/docs/coins/list

Retrieves a list of coins categorized by their respective types.

```APIDOC
## GET /coins

### Description
Retrieves a list of all available coins, organized by categories. The response is an array of categories, each containing a list of coins.

### Method
GET

### Endpoint
/coins

### Response
#### Success Response (200)
- **categories** (array) - List of coin categories containing a 'Coins' property.
```

--------------------------------

### Obtener detalles de aplicación mediante cURL

Source: https://www.qvapay.com/docs/app/detail

Realiza una solicitud GET al endpoint de detalle de aplicación utilizando un token de autorización Bearer.

```bash
curl -X GET https://api.qvapay.com/app/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer {tu-token}"
```

--------------------------------

### GET /auth/sessions

Source: https://www.qvapay.com/docs/auth/sessions

Retrieves a list of active sessions for the authenticated user, including device and session details.

```APIDOC
## GET /auth/sessions

### Description
Obtains the list of active sessions for the authenticated user, including device information and the current session.

### Method
GET

### Endpoint
https://api.qvapay.com/auth/sessions

### Authentication
Bearer Token in the Authorization header.

### Response
#### Success Response (200)
- **sessions** (array) - List of active sessions
- **currentSessionId** (string|null) - ID of the current session

#### Response Example
{
  "sessions": [
    {
      "id": "12345",
      "name": "macOS Chrome - 192.168.1.1",
      "ip_address": "192.168.1.1",
      "user_agent": "Mozilla/5.0...",
      "created_at": "2024-01-15T10:30:00.000Z",
      "expires_at": "2024-07-15T10:30:00.000Z"
    }
  ],
  "currentSessionId": "12345"
}

### Errors
- **401**: Invalid token or expired session
```

--------------------------------

### GET /app/:uuid/logs

Source: https://www.qvapay.com/docs/app/logs

Retrieves activity logs for a specific application identified by its UUID, supporting pagination and log type filtering.

```APIDOC
## GET /app/:uuid/logs

### Description
Retorna los logs de actividad de una aplicación con paginación. Permite filtrar por tipo de log.

### Method
GET

### Endpoint
/app/:uuid/logs

### Parameters
#### Path Parameters
- **uuid** (string) - Required - UUID de la app

#### Query Parameters
- **page** (number) - Optional - Número de página (por defecto 1)
- **limit** (number) - Optional - Cantidad de resultados por página (por defecto 50)
- **type** (string) - Optional - Filtrar por tipo de log: request o webhook

### Request Example
curl -X GET "https://api.qvapay.com/app/550e8400-e29b-41d4-a716-446655440000/logs?page=1&limit=50&type=request" -H "Authorization: Bearer {tu-token}"

### Response
#### Success Response (200)
- **logs** (array) - Lista de registros de actividad
- **pagination.page** (number) - Página actual
- **pagination.limit** (number) - Resultados por página
- **pagination.total** (number) - Total de registros
- **pagination.pages** (number) - Total de páginas

#### Response Example
{
  "logs": [
    {
      "id": 1,
      "type": "request",
      "method": "POST",
      "path": "/v2/create_invoice",
      "status": 200,
      "created_at": "2024-06-20T14:30:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 150,
    "pages": 3
  }
}
```

--------------------------------

### GET /coins/:id

Source: https://www.qvapay.com/docs/coins/detail

Retorna la información completa de un coin específico identificado por su ID numérico, incluyendo comisiones, límites de depósito y retiro, campos requeridos para retirar, estado de disponibilidad, precio y descripción.

```APIDOC
## GET /coins/:id

### Description
Retorna la información completa de un coin específico identificado por su ID numérico: comisiones, límites de depósito y retiro, campos requeridos para retirar, estado de disponibilidad, precio y descripción.

### Method
GET

### Endpoint
/coins/:id

### Parameters
#### Path Parameters
- **id** (number) - Required - ID numérico del coin

### Request Example
curl -X GET https://api.qvapay.com/coins/6 -H "Authorization: Bearer {tu-token}"

### Response
#### Success Response (200)
- **id** (string) - ID del coin
- **tick** (string) - Ticker único del coin
- **network** (string) - Red blockchain del activo
- **fee_in** (string) - Comisión de depósito en %
- **fee_out** (string) - Comisión de retiro en %
- **fee_out_fixed** (array) - Fee fijo para retiros pequeños [umbral, fee_fijo]
- **min_in** (string) - Límite mínimo de depósito en USD
- **max_in** (number) - Límite máximo de depósito en USD
- **min_out** (string) - Límite mínimo de retiro en USD
- **max_out** (number) - Límite máximo de retiro en USD
- **working_data** (array) - Campos que el usuario debe completar al retirar
- **enabled_in** (boolean) - Disponibilidad para depósito
- **enabled_out** (boolean) - Disponibilidad para retiro
- **enabled_p2p** (boolean) - Disponibilidad para P2P
- **auto_withdraw** (boolean) - Indica si los retiros se procesan automáticamente
- **price** (string) - Precio actual en USD
- **stable** (boolean) - Indica si mantiene paridad 1:1 con USD
- **description** (string) - Descripción del activo en Markdown

#### Response Example
{
  "id": "6",
  "network": "TRON",
  "name": "USDT (TRC20)",
  "tick": "USDT",
  "fee_in": "0.2",
  "fee_out": "1",
  "fee_out_fixed": [100, 1],
  "min_in": "1",
  "max_in": 1000000,
  "min_out": "2",
  "max_out": 5000,
  "enabled_in": true,
  "enabled_out": true,
  "price": "1",
  "stable": true
}
```

--------------------------------

### GET /coins

Source: https://www.qvapay.com/docs/coins/list

Retrieves all coin categories and their associated coins, including commission structures, transaction limits, and availability status.

```APIDOC
## GET /coins

### Description
Returns all coin categories and the coins belonging to each. Each coin includes configuration such as entry/exit fees, limits, required withdrawal fields, and availability status.

### Method
GET

### Endpoint
https://api.qvapay.com/coins

### Response
#### Success Response (200)
- **id** (number) - ID of the category
- **name** (string) - Name of the category
- **logo** (string) - Logo identifier
- **Coins** (array) - List of coins belonging to the category

#### Response Example
[
  {
    "id": 1,
    "name": "Criptomonedas",
    "logo": "crypto",
    "Coins": [
      {
        "id": "6",
        "coins_categories_id": 1,
        "network": "TRON",
        "name": "USDT (TRC20)",
        "logo": "usdt",
        "tick": "USDT",
        "fee_in": "0.2",
        "fee_in_gold": "0",
        "fee_out": "1",
        "fee_out_gold": "0.8",
        "fee_out_fixed": [100, 1],
        "min_in": "1",
        "min_out": "2",
        "max_in": 1000000,
        "max_out": 5000,
        "working_data": [{"name": "Wallet", "type": "text"}],
        "enabled_in": true,
        "enabled_out": true,
        "enabled_p2p": true,
        "auto_withdraw": true,
        "p2p_rate_discount": "0",
        "trade": false,
        "price": "1",
        "decimals": 2,
        "stable": true,
        "created_at": null,
        "updated_at": "2025-06-12T03:40:01.000Z",
        "description": "### ¿Qué es USDT (TRC20)? ...",
        "seo_title": "USDT TRC20 ✓ Compra y envía en QvaPay",
        "seo_description": "USDT TRC20 en QvaPay: stablecoin rápido y seguro..."
      }
    ]
  }
]
```

--------------------------------

### GET /coins/price-history/:tick

Source: https://www.qvapay.com/docs/coins/price-history

Retorna el historial de precios de un coin específico, identificado por su ticker. Este endpoint es público y utiliza rate limiting.

```APIDOC
## GET /coins/price-history/:tick

### Description
Obtiene el historial de precios de un coin específico por su ticker. Los datos provienen de CoinMarketCap y se cachean en memoria por 1 hora.

### Method
GET

### Endpoint
https://api.qvapay.com/coins/price-history/:tick

### Parameters
#### Path Parameters
- **tick** (string) - Required - Ticker del coin (ej: BTC, ETH, SOL)

#### Query Parameters
- **timeframe** (string) - Optional - Período de tiempo. Valores: 1H, 24H, 1W, 1M, 1Y, ALL. Por defecto: 24H

### Request Example
curl -X GET "https://api.qvapay.com/coins/price-history/BTC?timeframe=24H"

### Response
#### Success Response (200)
- **time** (number) - Timestamp Unix del punto de datos
- **value** (number) - Precio en USD en ese momento

#### Response Example
[
  {
    "time": 1718900400,
    "value": 67450.25
  },
  {
    "time": 1718904000,
    "value": 67520.10
  }
]

### Errors
- **404**: Coin con el ticker especificado no encontrado
- **429**: Demasiadas solicitudes (rate limit excedido)
- **500**: Error interno del servidor
```

--------------------------------

### GET /user/balance

Source: https://www.qvapay.com/docs

Retrieves the current balance for an authenticated user using a Bearer Token.

```APIDOC
## GET /user/balance

### Description
Retrieves the balance of the authenticated user.

### Method
GET

### Endpoint
https://api.qvapay.com/user/balance

### Parameters
#### Headers
- **Authorization** (string) - Required - Bearer {token}

### Response
#### Success Response (200)
- **data** (object) - Contains balance information
```

--------------------------------

### Listar sesiones activas

Source: https://www.qvapay.com/docs/auth/sessions

Obtiene la lista de sesiones activas del usuario autenticado. Requiere un Bearer Token en el header Authorization.

```bash
curl -X GET https://api.qvapay.com/auth/sessions \
  -H "Authorization: Bearer {tu-token}"
```

```json
{
  "sessions": [
    {
      "id": "12345",
      "name": "macOS Chrome - 192.168.1.1",
      "ip_address": "192.168.1.1",
      "user_agent": "Mozilla/5.0...",
      "created_at": "2024-01-15T10:30:00.000Z",
      "expires_at": "2024-07-15T10:30:00.000Z"
    }
  ],
  "currentSessionId": "12345"
}
```

--------------------------------

### POST /app/create

Source: https://www.qvapay.com/docs/app/create

Crea una nueva aplicación en QvaPay. Al crearla, se genera un secret que solo se muestra una vez en la respuesta.

```APIDOC
## POST /app/create

### Description
Crea una nueva aplicación. Al crearla se genera un secret que solo se muestra una vez en la respuesta.

### Method
POST

### Endpoint
https://api.qvapay.com/app/create

### Parameters
#### Request Body (multipart/form-data)
- **name** (string) - Required - Nombre de la app (3-50 caracteres)
- **url** (string) - Required - URL principal de la app (URL válida)
- **logo** (file) - Required - Logo de la app (JPG o PNG, máximo 5MB)
- **desc** (string) - Required - Descripción de la app
- **callback** (string) - Required - URL de callback para notificaciones (URL válida)
- **success_url** (string) - Required - URL de redirección en pago exitoso (URL válida)
- **cancel_url** (string) - Required - URL de redirección en pago cancelado (URL válida)

### Request Example
curl -X POST https://api.qvapay.com/app/create \
  -H "Authorization: Bearer {tu-token}" \
  -F "name=Mi Tienda" \
  -F "url=https://mitienda.com" \
  -F "logo=@logo.png" \
  -F "desc=Tienda de productos digitales" \
  -F "callback=https://mitienda.com/callback" \
  -F "success_url=https://mitienda.com/success" \
  -F "cancel_url=https://mitienda.com/cancel"

### Response
#### Success Response (200)
- **uuid** (string) - Identificador único de la app
- **secret** (string) - Clave secreta de la app (solo se muestra una vez)
- **name** (string) - Nombre de la app
- **url** (string) - URL principal de la app
- **desc** (string) - Descripción de la app
- **logo** (string) - URL del logo subido

#### Response Example
{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "secret": "sk_live_abc123def456ghi789",
  "name": "Mi Tienda",
  "url": "https://mitienda.com",
  "desc": "Tienda de productos digitales",
  "logo": "https://cdn.qvapay.com/apps/logo.png"
}
```

--------------------------------

### Respuesta de Actualización de App

Source: https://www.qvapay.com/docs/app/update

Estructura JSON devuelta tras una actualización exitosa de la aplicación.

```json
{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Mi Tienda Actualizada",
  "url": "https://nuevatienda.com",
  "logo": "https://cdn.qvapay.com/apps/logo.png",
  "description": "Tienda de productos digitales",
  "callback": "https://mitienda.com/callback",
  "success_url": "https://mitienda.com/success",
  "cancel_url": "https://mitienda.com/cancel",
  "active": true,
  "enabled": true,
  "allowed_payment_auth": false,
  "card": null,
  "created_at": "2024-01-15T10:30:00.000Z",
  "updated_at": "2024-06-20T18:45:00.000Z"
}
```

--------------------------------

### POST /v2/create_invoice

Source: https://www.qvapay.com/docs/merchants/create-invoice

Crea una nueva factura de pago con estado 'pending' y genera una URL de pago única para el cliente.

```APIDOC
## POST /v2/create_invoice

### Description
Crea una nueva factura de pago. La factura se crea con estado `pending` y genera una URL de pago que puedes compartir con tu cliente.

### Method
POST

### Endpoint
/v2/create_invoice

### Parameters
#### Request Body
- **amount** (number) - Requerido - Monto a cobrar (mayor a 0, máximo 100,000)
- **description** (string) - Requerido - Descripción del pago (1-255 caracteres)
- **remote_id** (string) - Requerido - Identificador externo de tu sistema (1-255 caracteres)
- **webhook** (string) - Opcional - URL para notificaciones de pago (debe ser URL válida)
- **products** (array) - Opcional - Lista de productos incluidos
- **products[].name** (string) - Requerido - Nombre del producto
- **products[].price** (number) - Requerido - Precio del producto
- **products[].quantity** (number) - Opcional - Cantidad (por defecto 1)
- **expire_at** (string) - Opcional - Fecha de expiración ISO 8601 (debe ser futura)

### Request Example
{
  "amount": 25.00,
  "description": "Compra de producto digital",
  "remote_id": "order-12345",
  "webhook": "https://mitienda.com/webhook/qvapay",
  "products": [
    {
      "name": "Producto 1",
      "price": 15.00,
      "quantity": 1
    },
    {
      "name": "Producto 2",
      "price": 10.00,
      "quantity": 1
    }
  ],
  "expire_at": "2024-12-31T23:59:59.000Z"
}

### Response
#### Success Response (200)
- **app_id** (string) - UUID de tu app
- **amount** (number) - Monto de la factura
- **description** (string) - Descripción del pago
- **remote_id** (string) - Tu identificador externo
- **transaction_uuid** (string) - UUID de la transacción en QvaPay
- **expire_at** (string) - Fecha de expiración
- **url** (string) - URL de pago para compartir con el cliente

#### Response Example
{
  "app_id": "550e8400-e29b-41d4-a716-446655440000",
  "amount": 25.00,
  "description": "Compra de producto digital",
  "remote_id": "order-12345",
  "transaction_uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "expire_at": "2024-12-31T23:59:59.000Z",
  "url": "https://www.qvapay.com/pay/7c9e6679-7425-40de-944b-e07fc1f90ae7"
}
```

--------------------------------

### Actualizar App con cURL

Source: https://www.qvapay.com/docs/app/update

Ejemplo de solicitud PATCH para actualizar los datos de una aplicación utilizando cURL.

```bash
curl -X PATCH https://api.qvapay.com/app/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer {tu-token}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mi Tienda Actualizada",
    "url": "https://nuevatienda.com",
    "active": true
  }'
```

--------------------------------

### Authenticate with App Credentials

Source: https://www.qvapay.com/docs

Use this method for server-to-server integrations where the application operates autonomously.

```bash
curl -X POST https://api.qvapay.com/v2/balance \
  -H "Content-Type: application/json" \
  -H "app-id: {tu-app-uuid}" \
  -H "app-secret: {tu-app-secret}"
```

--------------------------------

### POST /v2/info

Source: https://www.qvapay.com/docs/merchants/info

Retrieves the information of your application registered in QvaPay. This is useful for verifying that your credentials are working correctly and checking the current configuration of your app.

```APIDOC
## POST /v2/info

### Description
Retorna la información de tu aplicación registrada en QvaPay. Es útil para verificar que tus credenciales funcionan correctamente y consultar la configuración actual de tu app.

### Method
POST

### Endpoint
https://api.qvapay.com/v2/info

### Authentication
Requires app-id and app-secret in headers.

### Response
#### Success Response (200)
- **uuid** (string) - Identificador único de la app
- **name** (string) - Nombre de la app
- **url** (string) - URL del sitio web
- **desc** (string) - Descripción de la app
- **callback** (string) - URL de webhook para notificaciones
- **success_url** (string) - URL de redirección tras pago exitoso
- **cancel_url** (string) - URL de redirección tras cancelación
- **logo** (string) - Ruta del logo
- **active** (boolean) - Si la app está activa
- **enabled** (boolean) - Si la app está habilitada
- **card** (boolean) - Si tiene feature de tarjeta habilitado
- **app_photo_url** (string) - URL completa del logo

#### Response Example
{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Mi Tienda",
  "url": "https://mitienda.com",
  "desc": "Tienda de productos digitales",
  "callback": "https://mitienda.com/webhook",
  "success_url": "https://mitienda.com/success",
  "cancel_url": "https://mitienda.com/cancel",
  "logo": "apps/logo.png",
  "active": true,
  "enabled": true,
  "card": false,
  "created_at": "2024-01-15T10:30:00.000Z",
  "updated_at": "2024-06-20T14:00:00.000Z",
  "app_photo_url": "https://media.qvapay.com/apps/logo.png"
}
```

--------------------------------

### Crear aplicación mediante cURL

Source: https://www.qvapay.com/docs/app/create

Ejemplo de solicitud POST para registrar una nueva aplicación utilizando multipart/form-data.

```bash
curl -X POST https://api.qvapay.com/app/create \
  -H "Authorization: Bearer {tu-token}" \
  -F "name=Mi Tienda" \
  -F "url=https://mitienda.com" \
  -F "logo=@logo.png" \
  -F "desc=Tienda de productos digitales" \
  -F "callback=https://mitienda.com/callback" \
  -F "success_url=https://mitienda.com/success" \
  -F "cancel_url=https://mitienda.com/cancel"
```

--------------------------------

### PATCH /app/:uuid

Source: https://www.qvapay.com/docs/app/update

Actualiza los campos de una aplicación existente. Solo se actualizan los campos enviados en el body.

```APIDOC
## PATCH /app/:uuid

### Description
Actualiza los campos de una aplicación existente. Solo se actualizan los campos enviados en el body.

### Method
PATCH

### Endpoint
https://api.qvapay.com/app/:uuid

### Parameters
#### Path Parameters
- **uuid** (string) - Required - UUID de la app

#### Request Body
- **name** (string) - Optional - Nuevo nombre de la app
- **url** (string) - Optional - Nueva URL principal
- **desc** (string) - Optional - Nueva descripción
- **callback** (string) - Optional - Nueva URL de callback
- **success_url** (string) - Optional - Nueva URL de redirección exitosa
- **cancel_url** (string) - Optional - Nueva URL de redirección cancelada
- **active** (boolean) - Optional - Activar o desactivar la app
- **enabled** (boolean) - Optional - Habilitar o deshabilitar la app

### Request Example
{
  "name": "Mi Tienda Actualizada",
  "url": "https://nuevatienda.com",
  "active": true
}

### Response
#### Success Response (200)
- **uuid** (string) - UUID de la app
- **name** (string) - Nombre de la app
- **url** (string) - URL principal
- **logo** (string) - URL del logo
- **description** (string) - Descripción de la app
- **callback** (string) - URL de callback
- **success_url** (string) - URL de redirección exitosa
- **cancel_url** (string) - URL de redirección cancelada
- **active** (boolean) - Estado activo
- **enabled** (boolean) - Estado habilitado
- **allowed_payment_auth** (boolean) - Permiso de autenticación de pago
- **card** (null) - Información de tarjeta
- **created_at** (string) - Fecha de creación
- **updated_at** (string) - Fecha de actualización

#### Response Example
{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Mi Tienda Actualizada",
  "url": "https://nuevatienda.com",
  "logo": "https://cdn.qvapay.com/apps/logo.png",
  "description": "Tienda de productos digitales",
  "callback": "https://mitienda.com/callback",
  "success_url": "https://mitienda.com/success",
  "cancel_url": "https://mitienda.com/cancel",
  "active": true,
  "enabled": true,
  "allowed_payment_auth": false,
  "card": null,
  "created_at": "2024-01-15T10:30:00.000Z",
  "updated_at": "2024-06-20T18:45:00.000Z"
}
```

--------------------------------

### Response de verificación 2FA exitosa

Source: https://www.qvapay.com/docs/auth/check-2fa

Respuesta JSON devuelta cuando el código 2FA es validado correctamente.

```json
{
  "message": "2FA correcto"
}
```

--------------------------------

### POST /auth/register

Source: https://www.qvapay.com/docs/auth/register

Registers a new user in the QvaPay system. Upon successful registration, a verification email containing a PIN is sent to the provided email address.

```APIDOC
## POST /auth/register

### Description
Registra un nuevo usuario. Se envía un email de verificación con un PIN al correo proporcionado.

### Method
POST

### Endpoint
/auth/register

### Parameters
#### Request Body
- **name** (string) - Required - Nombre del usuario (2-50 caracteres)
- **lastname** (string) - Required - Apellido del usuario (2-50 caracteres)
- **email** (string) - Required - Email válido (no desechable, con registros MX)
- **password** (string) - Required - Contraseña (8-20 caracteres)
- **invite** (string) - Optional - Username del usuario que invita
- **terms** (boolean) - Required - Aceptación de los términos y condiciones

### Request Example
{
  "name": "Juan",
  "lastname": "Pérez",
  "email": "usuario@ejemplo.com",
  "password": "contraseña123",
  "invite": "username_invitador",
  "terms": true
}

### Response
#### Success Response (200)
- **message** (string) - Registro exitoso
- **user** (object) - Objeto con detalles del usuario creado

#### Response Example
{
  "message": "Registro exitoso",
  "user": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "email": "usuario@ejemplo.com",
    "name": "Juan",
    "username": "juan123"
  }
}

### Errors
- **400**: Datos inválidos, términos no aceptados, contraseña débil o email ya en uso
- **403**: Registro bloqueado (bot detectado o límite excedido)
```

--------------------------------

### Solicitud de creación de 2FA

Source: https://www.qvapay.com/docs/auth/create-2fa

Realiza una petición POST al endpoint de creación de 2FA utilizando un Bearer Token para la autenticación.

```bash
curl -X POST https://api.qvapay.com/auth/create-2fa \
  -H "Authorization: Bearer {tu-token}"
```

--------------------------------

### POST /auth/confirm-registration

Source: https://www.qvapay.com/docs/auth/confirm-registration

Verifica el email del usuario confirmando el PIN enviado durante el registro. No requiere autenticación previa.

```APIDOC
## POST /auth/confirm-registration

### Description
Verifica el email del usuario confirmando el PIN enviado durante el registro.

### Method
POST

### Endpoint
/auth/confirm-registration

### Parameters
#### Request Body
- **uuid** (string) - Requerido - UUID del usuario (formato UUID válido)
- **email** (string) - Requerido - Email del usuario
- **pin** (string) - Requerido - PIN de verificación enviado por email (4-6 caracteres)

### Request Example
{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "email": "usuario@ejemplo.com",
  "pin": "1234"
}

### Response
#### Success Response (200)
- **message** (string) - Registro confirmado

#### Response Example
{
  "message": "Registro confirmado"
}

### Error Handling
- **400**: Datos inválidos o correo ya verificado
- **403**: Código de verificación incorrecto
- **404**: Usuario no encontrado
- **429**: Demasiadas solicitudes de confirmación
```

--------------------------------

### Estructura de respuesta de detalle de aplicación

Source: https://www.qvapay.com/docs/app/detail

Representación JSON de los datos devueltos al consultar exitosamente una aplicación.

```json
{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Mi Tienda",
  "url": "https://mitienda.com",
  "logo": "https://cdn.qvapay.com/apps/logo.png",
  "description": "Tienda de productos digitales",
  "callback": "https://mitienda.com/callback",
  "success_url": "https://mitienda.com/success",
  "cancel_url": "https://mitienda.com/cancel",
  "active": true,
  "enabled": true,
  "allowed_payment_auth": false,
  "card": null,
  "created_at": "2024-01-15T10:30:00.000Z",
  "updated_at": "2024-06-20T14:00:00.000Z"
}
```

--------------------------------

### POST /v2/authorize_payments

Source: https://www.qvapay.com/docs/merchants/authorize-payments

Genera una URL de autorización que se envía al usuario para permitir cobros directos desde la aplicación.

```APIDOC
## POST /v2/authorize_payments

### Description
Genera una URL de autorización que puedes enviar a un usuario para que autorice cobros directos desde tu aplicación. Una vez autorizado, podrás usar el endpoint Cobrar para realizar cobros directos.

### Method
POST

### Endpoint
/v2/authorize_payments

### Parameters
#### Request Body
- **remote_id** (string) - Requerido - Identificador del usuario en tu sistema
- **callback** (string) - Requerido - URL de callback tras la autorización

### Request Example
{
  "remote_id": "user-001",
  "callback": "https://mitienda.com/auth/callback"
}

### Response
#### Success Response (200)
- **message** (string) - Mensaje de confirmación
- **url** (string) - URL de autorización para el usuario

#### Response Example
{
  "message": "Authorize payments",
  "url": "https://qvapay.com/authorize_payments?app_uuid=tu-app-uuid&remote_id=user-001&callback=https%3A%2F%2Fmitienda.com%2Fauth%2Fcallback"
}
```

--------------------------------

### POST /auth/create-2fa

Source: https://www.qvapay.com/docs/auth/create-2fa

Genera un nuevo secreto OTP para configurar la autenticación de dos factores.

```APIDOC
## POST /auth/create-2fa

### Description
Genera un nuevo secreto OTP para configurar la autenticación de dos factores con una app autenticadora (Google Authenticator, Authy, etc.).

### Method
POST

### Endpoint
https://api.qvapay.com/auth/create-2fa

### Authentication
Bearer Token en el header Authorization.

### Response
#### Success Response (200)
- **message** (string) - Mensaje de confirmación
- **secret** (string) - Secreto en formato Base32 para configurar manualmente
- **qrcode** (string) - URL otpauth:// para generar código QR

#### Response Example
{
  "message": "2FA created",
  "secret": "JBSWY3DPEHPK3PXP",
  "qrcode": "otpauth://totp/QvaPay:usuario@ejemplo.com?secret=JBSWY3DPEHPK3PXP"
}

### Errors
- **401** - Token inválido o sesión expirada
```

--------------------------------

### POST /auth/check-2fa

Source: https://www.qvapay.com/docs/auth/check-2fa

Verifica si un código 2FA (PIN o OTP) es válido para el usuario autenticado.

```APIDOC
## POST /auth/check-2fa

### Description
Verifica si un código 2FA es válido. Acepta tanto el PIN de 4 dígitos como un código OTP de 6 dígitos generado por una app autenticadora.

### Method
POST

### Endpoint
/auth/check-2fa

### Parameters
#### Request Body
- **two_factor_code** (string) - Required - Código PIN (4 dígitos) o código OTP (6 dígitos)

### Request Example
{
  "two_factor_code": "123456"
}

### Response
#### Success Response (200)
- **message** (string) - 2FA correcto

#### Response Example
{
  "message": "2FA correcto"
}

### Errors
- **400**: Código 2FA no proporcionado
- **401**: Código 2FA incorrecto o token inválido
```

--------------------------------

### Retrieve App Info via cURL

Source: https://www.qvapay.com/docs/merchants/info

Use this request to fetch application details. Requires app-id and app-secret in the request headers.

```bash
curl -X POST https://api.qvapay.com/v2/info \
  -H "Content-Type: application/json" \
  -H "app-id: {tu-app-uuid}" \
  -H "app-secret: {tu-app-secret}"
```
Tokens:
Raw