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

Captured (contabiliza definitivamente) uma encomenda previamente criada e autorizada pelo comprador no PayPal Checkout. O servidor é autoritativo — o cliente não pode influenciar o montante.

Autenticação e segurança

Não é necessária autenticação

strictLimiter (10 Req/15min, associado ao IP).

Idempotente: Não

Parâmetros

order_id(body, string, obrigatório)— PayPal Order ID devolvido por paypal/create-order

Pedido de exemplo

{"order_id":"<PAYPAL_ORDER_ID>"}

Resposta de exemplo

{"ok":false,"error":"UNKNOWN_ORDER","message":"Unbekannte Bestellung."}

Códigos de erro

400 ORDER_ID_REQUIRED — order_id em falta.
404 UNKNOWN_ORDER — order_id não corresponde a uma encomenda conhecida criada anteriormente.
409 CAPTURE_NOT_COMPLETED — O pagamento ainda não foi autorizado pelo comprador.
502 PAYPAL_CAPTURE_FAILED — Erro na comunicação PayPal.

Evidência de teste live

Ambos os casos negativos sem configuração PayPal foram verificados live (400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER). Um caso real de sucesso exigiria um pagamento PayPal Sandbox com autorização do comprador, excluído pelas regras de teste (sem chamadas reais a providers de pagamento).

← Formulários públicos