Merchants
Autorizar Pagos
Generar una URL para que un usuario autorice pagos recurrentes a tu app.
POST /v2/authorize_payments
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.
Autenticación
Credenciales de App (app-id + app-secret en headers).
Request
{
"remote_id": "user-001",
"callback": "https://mitienda.com/auth/callback"
}Parámetros
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
remote_id | string | Si | Identificador del usuario en tu sistema |
callback | string | Si | URL de callback tras la autorización |
Response
{
"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"
}Flujo de autorización
- Tu app solicita la URL de autorización
- Rediriges al usuario a la URL recibida
- El usuario inicia sesión en QvaPay y autoriza los pagos
- QvaPay redirige al usuario a tu
callback - Ya puedes realizar cobros directos con Cobrar
Requisitos
Tu app debe tener el permiso allowed_payment_auth habilitado. Contacta a soporte si necesitas activarlo.
Errores
| Código | Descripción |
|---|---|
400 | Faltan remote_id o callback |
400 | La app no tiene permiso de autorización de pagos |