Stati

Il ciclo di vita di un'operazione, dal clic al regolamento.

Stato	Terminale	Significato
initiated	no	Creata; il pagatore non ha ancora agito
pending	no	Il pagatore ha agito; manca la conferma del rail
success	sì	Incassata — i fondi sono accreditati sul suo saldo
failed	sì	Rifiutata o fallita presso il rail
cancelled	sì	Annullata (dal pagatore o da lei) prima dell'incasso
expired	sì	Il link o la sessione di pagamento è scaduta senza azione

Regole

• Uno stato terminale non cambia mai più. success non diventa failed; un incasso contestato produce una nuova risorsa (rimborso, contestazione), mai una riscrittura dello storico.
• pending può durare — alcuni pagatori confermano il loro codice USSD diversi minuti dopo. Non tratti mai pending come un fallimento.
• La transizione che le interessa arriva via webhook; la lettura (GET /v1/payments/{id}) è la rete di sicurezza, non il meccanismo principale.

Non derivi il suo stato dal nostro

Uno stato descrive la nostra operazione. Che cosa debba diventare il suo ordine è una sua decisione: un success non vuol dire «spedire», vuol dire «i fondi sono da lei». Tenga la sua macchina a stati e la faccia avanzare sugli eventi, non il contrario.