QvaPay API
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ámetroTipoRequeridoDescripción
namestringSiNombre de la app (3-50 caracteres)
urlstringSiURL principal de la app (URL válida)
logofileSiLogo de la app (JPG o PNG, máximo 5MB)
descstringSiDescripción de la app
callbackstringSiURL de callback para notificaciones (URL válida)
success_urlstringSiURL de redirección en pago exitoso (URL válida)
cancel_urlstringSiURL 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

CampoTipoDescripción
uuidstringIdentificador único de la app
secretstringClave secreta de la app (solo se muestra una vez)
namestringNombre de la app
urlstringURL principal de la app
descstringDescripción de la app
logostringURL del logo subido

Errores

CódigoDescripción
400Campos requeridos faltantes o inválidos
500Error interno del servidor