Flusso di richiesta API di produzione

Ordine di richiesta consigliato per operazioni live con ambito di proprietà esplicito e verificabilità delle transazioni.

  1. Autentica e ottieni la chiave JWT dell'utente o API dell'app.
  2. Crea o aggiorna i prodotti tramite /v1/products (POST, PUT, PATCH); Vedere Prodotti API CRUD E esempi multilingue.
  3. Avvia il checkout da Paga con l'ID prodotto.
  4. Ricevere e convalidare le firme di callback/webhook (payment.confirmed + convalida specchio).
  5. Interrogare i risultati della transazione da /v1/transaction/status O /v1/transactions - Vedere Dettagli della transazione.

Intestazioni obbligatorie

Authorization: Bearer <token>
Content-Type: application/json

Linea di base per la gestione degli errori

  • Riprovare gli errori temporanei (5xx) con backoff esponenziale.
  • Trattare 401/403 come problemi di autorizzazione/autorizzazione.
  • Trattare 409 come conflitti aziendali (ad esempio blocchi di eliminazione dei prodotti).
  • Registra gli ID delle transazioni, gli ID degli eventi del webhook e gli ID delle richieste per la tracciabilità.