Skip to Content

Payment status polling

GET /Card/Handlers/{invoiceId}/status

Polled by the widget every poll_interval_seconds (5 seconds). The outcome outranks the deadline: expired is returned for pending only, so a payment made in the last second is never shown as expired.

The sandbox does not write polling to request_log — the journal would fill up with it; QR creation is written as sbpWidgetCreate.

Request parameters

FieldTypeRequiredDescription
invoiceIdstringyesInvoice identifier
Response example
{ "success": true, "data": { "reference": "0d0f3c58-9b1e-4a77-9a0c-000000000001", "status": "pending", "poll_interval_seconds": 5, "expires_at": "2026-09-21T12:00:00Z", "invoice_status": "WaitPaymentConfirmation", "payment_status": "NOT_PAID" } }

Response codes

CodeDescription
200Current status
401The token did not match