POST/api/public/access-request/paypal/capture-order
Completa (captura) un pedido creado previamente y aprobado por el comprador en el checkout de PayPal. El importe lo fija exclusivamente el servidor.
Tras que el comprador haya aprobado el pago en PayPal, envíe el identificador de pedido devuelto por `paypal/create-order` en el campo `order_id`. Si tiene éxito, el pago queda completado y la solicitud de acceso sigue procesándose. Casos de error: 400 `ORDER_ID_REQUIRED` (falta el campo), 404 `UNKNOWN_ORDER` (pedido no conocido), 409 `CAPTURE_NOT_COMPLETED` (pago aún no aprobado; el comprador debe completar el checkout de PayPal) y 502 `PAYPAL_CAPTURE_FAILED` (error de comunicación con PayPal). Llame al endpoint solo una vez por pedido.
Descripción general
Llamada: POST /api/public/access-request/paypal/capture-order. Este endpoint pertenece al grupo «Formularios públicos» de la API de Zentor App. Es de acceso público y no requiere autenticación. La llamada no es idempotente: cada llamada correcta vuelve a desencadenar la acción. Parámetros obligatorios: order_id (body). Casos de error documentados: 400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER, 409 CAPTURE_NOT_COMPLETED, 502 PAYPAL_CAPTURE_FAILED. La respuesta de ejemplo siguiente muestra la estructura de una respuesta correcta en formato JSON.
Autenticación y seguridad
No se requiere autenticación
Como máximo 10 solicitudes cada 15 minutos por dirección IP.
Idempotente: No
Parámetros
order_id(body, string, obligatorio)— Identificador de pedido de PayPal devuelto por `paypal/create-order`Solicitud de ejemplo
{"order_id":"<PAYPAL_ORDER_ID>"}Respuesta de ejemplo
{"ok":false,"error":"UNKNOWN_ORDER","message":"Unbekannte Bestellung."}Códigos de error
400 ORDER_ID_REQUIRED — Falta el campo `order_id`.404 UNKNOWN_ORDER — `order_id` no es un pedido conocido creado previamente.409 CAPTURE_NOT_COMPLETED — El comprador aún no ha aprobado el pago.502 PAYPAL_CAPTURE_FAILED — Se produjo un error en la comunicación con PayPal.Comportamiento verificado
Sin `order_id`, la llamada devuelve 400 `ORDER_ID_REQUIRED`, con un pedido desconocido, 404 `UNKNOWN_ORDER`. El caso de éxito requiere un pago real de PayPal aprobado por el comprador.
Formularios públicos
POST /api/public/contactRecibe una solicitud del formulario de contacto del sitio web de Zentor App y la reenvía al equipo de Zentor.POST /api/public/consultationRecibe una solicitud de asesoramiento del formulario del sitio web de Zentor App.POST /api/public/access-requestEnvía una solicitud de acceso para un paquete (Starter, Individual o demo de 14 días). Se requiere una dirección de correo previamente confirmada.POST /api/public/access-request/email/start-verificationEnvía un código de confirmación de seis cifras, válido 10 minutos, a la dirección de correo indicada: el primer paso de una solicitud de acceso.POST /api/public/access-request/email/verifyComprueba el código enviado por correo electrónico y emite un token de confirmación para la posterior solicitud de acceso.GET /api/public/access-request/payment-statusIndica qué métodos de pago (PayPal, Stripe) están actualmente disponibles para la solicitud de acceso.GET /api/public/access-request/paypal/configDevuelve la configuración pública de PayPal (activo, modo, moneda) para el paso de pago.POST /api/public/access-request/paypal/create-orderCrea un pedido de PayPal para el paquete seleccionado.POST /api/public/access-request/stripe/create-checkoutCrea una sesión de pago de Stripe para el paquete seleccionado.POST /api/public/activate-accountActiva una cuenta de usuario recién creada y establece la primera contraseña, activado mediante el enlace del correo de invitación.