Panoramica dell’interfaccia
/orders/{id} e /orders/{id}/ sono attualmente entrambi disponibili. L’ID dell’ordine fa parte del link di pagamento e deve essere considerato un identificatore opaco sensibile, non diffonderlo pubblicamente.
Query anonima
La pagina di pagamento può leggerlo direttamente quando lo stato di accesso viene perso:id, description, price, state, pay_way, pay_url, expired_at, created_at. Non restituisce account, Application, Package, identificatori interni di pagamento o metadata.
Query autenticata
application / applications, package / packages, bank_details, invoice_automation e i campi del modello. Se autenticato ma non proprietario dell’ordine, restituisce 403; eccetto per i super amministratori.
Campi chiave
La risposta completa può aggiungere campi in base al metodo di pagamento; il client deve leggerli secondo necessità ed evitare sempre di registrare metadata sensibili nella risposta completa.
Gestione degli errori
404: l’ID dell’ordine non esiste.403: l’utente ha effettuato l’accesso ma non è il proprietario dell’ordine.- Le richieste anonime non restituiscono
401; ottengono solo la proiezione pubblica minima.
Storno della fattura e nuova richiesta
TramiteGET /api/v1/orders/{order_id}/invoice/ è possibile leggere la fattura corrente dell’ordine. Dopo l’invio dello storno automatico, la fattura rimane Issued e red_state indica l’avanzamento dello storno; l’invio riuscito non equivale al completamento dello storno. Durante l’attesa della conferma, l’emissione della nota di credito o l’archiviazione, l’ordine non può richiedere nuovamente una fattura.
Quando un amministratore richiede uno storno a causa di errori nelle informazioni di fatturazione, come intestazione o codice fiscale, il motivo dello storno è “errore di fatturazione”; lo storno automatico attivato dal rimborso dell’ordine continua a utilizzare “interruzione del servizio”.
Dopo che la nota di credito è stata emessa e archiviata con successo, la fattura originale diventa Voided e l’ordine può richiedere nuovamente una fattura. La fattura originale può essere visualizzata nella cronologia delle fatture. Se lo storno fallisce o il risultato è in attesa di verifica, verrà gestito dalla verifica finanziaria e l’ordine non vedrà revocata anticipatamente la limitazione di fatturazione. Le fatture emesse manualmente devono prima essere annullate o stornate nel sistema fiscale o di fatturazione, quindi confermate dalla finanza nella piattaforma.

