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

Conclui (captura) uma encomenda previamente criada e aprovada pelo comprador no checkout do PayPal. O valor é definido exclusivamente pelo servidor.

Depois de o comprador aprovar o pagamento no PayPal, envie o identificador de encomenda devolvido por `paypal/create-order` no campo `order_id`. Em caso de sucesso, o pagamento fica concluído e o pedido de acesso continua a ser processado. Casos de erro: 400 `ORDER_ID_REQUIRED` (campo em falta), 404 `UNKNOWN_ORDER` (encomenda desconhecida), 409 `CAPTURE_NOT_COMPLETED` (pagamento ainda não aprovado — o comprador tem de concluir o checkout do PayPal) e 502 `PAYPAL_CAPTURE_FAILED` (erro de comunicação com o PayPal). Chame o endpoint apenas uma vez por encomenda.

Visão geral

Chamada: POST /api/public/access-request/paypal/capture-order. Este endpoint pertence ao grupo «Formulários públicos» da API da Zentor App. É de acesso público e não requer autenticação. A chamada não é idempotente: cada chamada bem-sucedida volta a desencadear a ação. Parâmetros obrigatórios: order_id (body). Casos de erro documentados: 400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER, 409 CAPTURE_NOT_COMPLETED, 502 PAYPAL_CAPTURE_FAILED. A resposta de exemplo abaixo mostra a estrutura de uma resposta bem-sucedida em formato JSON.

Autenticação e segurança

Não é necessária autenticação

No máximo 10 pedidos por 15 minutos por endereço IP.

Idempotente: Não

Parâmetros

order_id(body, string, obrigatório)— Identificador de encomenda PayPal 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 — O campo `order_id` está em falta.
404 UNKNOWN_ORDER — `order_id` não é uma encomenda conhecida criada anteriormente.
409 CAPTURE_NOT_COMPLETED — O comprador ainda não aprovou o pagamento.
502 PAYPAL_CAPTURE_FAILED — Ocorreu um erro na comunicação com o PayPal.

Comportamento verificado

Sem `order_id`, a chamada devolve 400 `ORDER_ID_REQUIRED`, com uma encomenda desconhecida 404 `UNKNOWN_ORDER`. O caso de sucesso exige um pagamento PayPal real aprovado pelo comprador.

Formulários públicos

POST /api/public/contactRecebe um pedido do formulário de contacto do website da Zentor App e reencaminha-o para a equipa Zentor.POST /api/public/consultationRecebe um pedido de consultoria do formulário do website da Zentor App.POST /api/public/access-requestSubmete um pedido de acesso para um pacote (Starter, Individual ou demo de 14 dias). É necessário um endereço de e-mail previamente confirmado.POST /api/public/access-request/email/start-verificationEnvia um código de confirmação de seis dígitos, válido por 10 minutos, para o endereço de e-mail indicado — o primeiro passo de um pedido de acesso.POST /api/public/access-request/email/verifyVerifica o código enviado por e-mail e emite um token de confirmação para o pedido de acesso subsequente.GET /api/public/access-request/payment-statusIndica que métodos de pagamento (PayPal, Stripe) estão atualmente disponíveis para o pedido de acesso.GET /api/public/access-request/paypal/configDevolve a configuração pública do PayPal (ativo, modo, moeda) para o passo de pagamento.POST /api/public/access-request/paypal/create-orderCria uma encomenda PayPal para o pacote selecionado.POST /api/public/access-request/stripe/create-checkoutCria uma sessão de checkout Stripe para o pacote selecionado.POST /api/public/activate-accountAtiva uma conta de utilizador recém-criada e define a primeira palavra-passe — ativado através do link no e-mail de convite.

Artigos relacionados

← Formulários públicos