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

Cria uma encomenda PayPal para o pacote selecionado.

Envie o código do pacote no campo `package` e, opcionalmente, o `email` do requerente. O valor é determinado exclusivamente no servidor a partir do pacote. Em caso de sucesso, a resposta contém, no objeto `data`, o identificador de encomenda PayPal `order_id`, bem como `amount_cents` e `currency`; com o `order_id`, o comprador aprova o pagamento no checkout do PayPal. Em seguida, conclui o pagamento com `POST /api/public/access-request/paypal/capture-order`. Um pacote inválido resulta em 400 `INVALID_PACKAGE`, um endereço de e-mail inválido em 400 `INVALID_EMAIL`. Se o PayPal estiver atualmente indisponível, o endpoint responde 503 `PAYPAL_NOT_READY`. O endpoint está limitado a 10 pedidos por 15 minutos por endereço IP. Cada chamada bem-sucedida cria uma nova encomenda; não a repita automaticamente.

Visão geral

Chamada: POST /api/public/access-request/paypal/create-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: package (body). Casos de erro documentados: 503 PAYPAL_NOT_READY. 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

Idempotente: Não

Parâmetros

package(body, string, obrigatório)— Código do pacote selecionado

Pedido de exemplo

{"package":"starter"}

Resposta de exemplo

{"ok":false,"error":"PAYPAL_NOT_READY","message":"PayPal ist derzeit nicht verfügbar."}

Códigos de erro

503 PAYPAL_NOT_READY — O PayPal está atualmente indisponível.

Comportamento verificado

Sem uma ligação PayPal disponível, a chamada devolve 503 `PAYPAL_NOT_READY`. O caso de sucesso exige um pagamento real via PayPal.

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/capture-orderConclui (captura) uma encomenda previamente criada e aprovada pelo comprador no checkout do PayPal. O valor é definido exclusivamente pelo servidor.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