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

Completa (capture) un ordine precedentemente creato e approvato dall'acquirente nel checkout PayPal. L'importo è determinato esclusivamente dal server.

Dopo che l'acquirente ha approvato il pagamento su PayPal, inviate l'ID ordine restituito da `paypal/create-order` nel campo `order_id`. In caso di successo, il pagamento è completato e la richiesta di accesso continua a essere elaborata. Casi di errore: 400 `ORDER_ID_REQUIRED` (campo mancante), 404 `UNKNOWN_ORDER` (nessun ordine conosciuto), 409 `CAPTURE_NOT_COMPLETED` (pagamento non ancora approvato — l'acquirente deve completare il checkout PayPal) e 502 `PAYPAL_CAPTURE_FAILED` (errore di comunicazione con PayPal). Chiamate l'endpoint solo una volta per ordine.

Panoramica

Chiamata: POST /api/public/access-request/paypal/capture-order. Questo endpoint appartiene al gruppo «Moduli pubblici» dell'API di Zentor App. È accessibile pubblicamente e non richiede autenticazione. La chiamata non è idempotente: ogni chiamata riuscita attiva nuovamente l'azione. Parametri obbligatori: order_id (body). Casi di errore documentati: 400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER, 409 CAPTURE_NOT_COMPLETED, 502 PAYPAL_CAPTURE_FAILED. La risposta di esempio riportata di seguito mostra la struttura di una risposta riuscita in formato JSON.

Autenticazione e sicurezza

Nessuna autenticazione richiesta

Al massimo 10 richieste ogni 15 minuti per indirizzo IP.

Idempotente: No

Parametri

order_id(body, string, obbligatorio)— ID ordine PayPal restituito da `paypal/create-order`

Richiesta di esempio

{"order_id":"<PAYPAL_ORDER_ID>"}

Risposta di esempio

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

Codici di errore

400 ORDER_ID_REQUIRED — Il campo `order_id` è mancante.
404 UNKNOWN_ORDER — `order_id` non è un ordine conosciuto creato precedentemente.
409 CAPTURE_NOT_COMPLETED — L'acquirente non ha ancora approvato il pagamento.
502 PAYPAL_CAPTURE_FAILED — Si è verificato un errore nella comunicazione con PayPal.

Comportamento verificato

Senza `order_id`, la chiamata restituisce 400 `ORDER_ID_REQUIRED`, con un ordine sconosciuto 404 `UNKNOWN_ORDER`. Il caso di successo richiede un pagamento PayPal reale approvato dall'acquirente.

Moduli pubblici

POST /api/public/contactRiceve una richiesta dal modulo di contatto del sito web di Zentor App e la inoltra al team Zentor.POST /api/public/consultationRiceve una richiesta di consulenza dal modulo del sito web di Zentor App.POST /api/public/access-requestInoltra una richiesta di accesso per un pacchetto (Starter, Individuale o demo di 14 giorni). È necessario un indirizzo e-mail precedentemente confermato.POST /api/public/access-request/email/start-verificationInvia un codice di conferma a sei cifre, valido 10 minuti, all'indirizzo e-mail indicato — il primo passo di una richiesta di accesso.POST /api/public/access-request/email/verifyVerifica il codice inviato per e-mail e rilascia un token di conferma per la successiva richiesta di accesso.GET /api/public/access-request/payment-statusIndica quali metodi di pagamento (PayPal, Stripe) sono attualmente disponibili per la richiesta di accesso.GET /api/public/access-request/paypal/configRestituisce la configurazione pubblica di PayPal (attivo, modalità, valuta) per la fase di pagamento.POST /api/public/access-request/paypal/create-orderCrea un ordine PayPal per il pacchetto selezionato.POST /api/public/access-request/stripe/create-checkoutCrea una sessione di checkout Stripe per il pacchetto selezionato.POST /api/public/activate-accountAttiva un account utente appena creato e imposta la prima password, avviato tramite il link nell'e-mail di invito.

Articoli correlati

← Moduli pubblici