POST/api/public/access-request/paypal/create-order
Crea un ordine PayPal per il pacchetto selezionato.
Inviate il codice del pacchetto nel campo `package` e, facoltativamente, l'`email` del richiedente. L'importo viene determinato esclusivamente lato server a partire dal pacchetto. In caso di successo, la risposta contiene, nell'oggetto `data`, l'ID ordine PayPal `order_id` oltre a `amount_cents` e `currency`; con l'`order_id` l'acquirente approva il pagamento nel checkout PayPal. Completate poi il pagamento con `POST /api/public/access-request/paypal/capture-order`. Un pacchetto non valido comporta 400 `INVALID_PACKAGE`, un indirizzo e-mail non valido 400 `INVALID_EMAIL`. Se PayPal non è attualmente disponibile, l'endpoint risponde 503 `PAYPAL_NOT_READY`. L'endpoint è limitato a 10 richieste ogni 15 minuti per indirizzo IP. Ogni chiamata riuscita crea un nuovo ordine; non ripetetela automaticamente.
Panoramica
Chiamata: POST /api/public/access-request/paypal/create-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: package (body). Casi di errore documentati: 503 PAYPAL_NOT_READY. La risposta di esempio riportata di seguito mostra la struttura di una risposta riuscita in formato JSON.
Autenticazione e sicurezza
Nessuna autenticazione richiesta
Idempotente: No
Parametri
package(body, string, obbligatorio)— Codice del pacchetto selezionatoRichiesta di esempio
{"package":"starter"}Risposta di esempio
{"ok":false,"error":"PAYPAL_NOT_READY","message":"PayPal ist derzeit nicht verfügbar."}Codici di errore
503 PAYPAL_NOT_READY — PayPal non è attualmente disponibile.Comportamento verificato
Senza una connessione PayPal disponibile, la chiamata restituisce 503 `PAYPAL_NOT_READY`. Il caso di successo richiede un pagamento reale tramite PayPal.
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/capture-orderCompleta (capture) un ordine precedentemente creato e approvato dall'acquirente nel checkout PayPal. L'importo è determinato esclusivamente dal server.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.