Payment records use a fixed set of string statuses stored on the Kollect payment model. Webhook payloads echo the post-update status field.
Status values
Status
Meaning
created
Payment row created.
initiated
Used when a flow marks initiation (product-dependent).
processing
Payout initiated with Smart Contract in progress.
submitted
Intermediate / submitted state on chain or gateway.
success
Payment confirmed (typically after payment.confirmed).
failed
Payment failed (typically after payment.failed).
Invoice correlation
When a payment succeeds, the related invoice may be updated to paid as part of webhook processing. Exact business rules follow the Kollect services that handle the Smart Contract callback.
Polling alternative (DPoP)
The API exposes GET /sdk/status/:paymentId for SDK-style polling, but it requires DPoP headers and is not part of the API-key + HMAC S2S flow. For server integrations, prefer webhooks plus your own order state.