App
Crear App
Crear una nueva aplicación para integrar pagos.
POST /app/create
Crea una nueva aplicación. Al crearla se genera un secret que solo se muestra una vez en la respuesta.
Autenticación
Bearer Token en header Authorization.
Request
curl -X POST https://api.qvapay.com/app/create \
-H "Authorization: Bearer {tu-token}" \
-F "name=Mi Tienda" \
-F "url=https://mitienda.com" \
-F "[email protected]" \
-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"Parámetros
El body debe enviarse como FormData (multipart/form-data).
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
name | string | Si | Nombre de la app (3-50 caracteres) |
url | string | Si | URL principal de la app (URL válida) |
logo | file | Si | Logo de la app (JPG o PNG, máximo 5MB) |
desc | string | Si | Descripción de la app |
callback | string | Si | URL de callback para notificaciones (URL válida) |
success_url | string | Si | URL de redirección en pago exitoso (URL válida) |
cancel_url | string | Si | URL de redirección en pago cancelado (URL válida) |
Response
{
"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"
}Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
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 |
Errores
| Código | Descripción |
|---|---|
400 | Campos requeridos faltantes o inválidos |
500 | Error interno del servidor |