Každý platební požadavek v MailPay má pole status, které odráží jeho aktuální stav v životním cyklu platby. Stav se mění automaticky při přijetí platby, nebo ho můžete změnit ručně přes dashboard či API.
| Stav | Popis |
|---|---|
| PENDING | Výchozí stav po vytvoření požadavku. Platba dosud nebyla přijata. QR kód je aktivní a zákazník může zaplatit. |
| AWAITING | Zákazník na QR terminálu klikl „Už jsem zaplatil/a". MailPay čeká na potvrzení z banky. QR kód zůstává dostupný. |
| PAID | Příchozí platba byla přijata a spárována s požadavkem. Konečný stav — k dalším automatickým přechodům nedochází. |
| CANCELED | Požadavek byl zrušen. Konečný stav — lze ručně obnovit zpět na PENDING. |
Stav požadavku lze kdykoliv změnit přes PATCH endpoint. Každá změna spustí odpovídající webhook událost.
PATCH /api-pub/v1/payment-requests/:id/status| Pole | Typ | Hodnoty |
|---|---|---|
status | string | PENDING, AWAITING, PAID, CANCELED |
Webhook události odpovídající stavům: payment_request.paid, payment_request.awaiting, payment_request.canceled, payment_request.pending. Více o webhookách najdete v API dokumentaci.