POST/api/public/access-request/paypal/capture-order

Captura (contabiliza definitivamente) un pedido creado previamente y autorizado por el comprador en PayPal Checkout. El servidor es autoritativo: el cliente no puede influir en el importe.

Autenticación y seguridad

No se requiere autenticación

strictLimiter (10 Req/15min, vinculado a la IP).

Idempotente: No

Parámetros

order_id(body, string, obligatorio)PayPal Order ID 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_REQUIREDFalta order_id.
404 UNKNOWN_ORDERorder_id no corresponde a un pedido conocido creado previamente.
409 CAPTURE_NOT_COMPLETEDEl comprador todavía no ha autorizado el pago.
502 PAYPAL_CAPTURE_FAILEDError de comunicación con PayPal.

Evidencia de prueba en vivo

Ambos casos negativos sin configuración de PayPal se verificaron live (400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER). Un caso real de éxito requeriría un pago PayPal Sandbox con autorización del comprador, excluido por la especificación de prueba.

Formularios públicos