App
Actualizar App
Actualizar los datos de una aplicación existente.
PATCH /app/:uuid
Actualiza los campos de una aplicación existente. Solo se actualizan los campos enviados en el body. Los textos se guardan sin espacios al principio ni al final y siguen las mismas reglas que al crear la App.
Autenticación
Bearer Token en header Authorization.
Request
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
}'Parámetros
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
uuid | string | Si | UUID de la app (en la URL) |
name | string | No | Nuevo nombre de la app (3-50 caracteres) |
url | string | No | Nueva URL principal (http:// o https://) |
desc | string | No | Nueva descripción (máximo 191 caracteres) |
callback | string | No | Nueva URL del webhook de pago: https:// y pública. Una cadena vacía lo quita |
success_url | string | No | Nueva URL de redirección exitosa (http:// o https://) |
cancel_url | string | No | Nueva URL de redirección cancelada (http:// o https://) |
active | boolean | No | Activar o desactivar la app (true/false, nunca "true") |
enabled | boolean | No | Habilitar o deshabilitar la app |
Response
{
"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"
}Errores
| Código | Descripción |
|---|---|
400 | Campo inválido. La respuesta trae error (motivo), field (el campo) y code (INVALID_URL, DESC_TOO_LONG, INVALID_FIELD o INVALID_BODY si el body no es un objeto JSON) |
404 | App no encontrada |