Status

Every payment in our system transitions through a set of statuses that reflect its current state — from creation to settlement, refund, or chargeback.

Understanding these statuses is essential for interpreting transaction behavior, automating platform decisions, and providing transparency to the payer.

Here’s a breakdown of the main statuses and their meanings:

• issued: The payment was created and is awaiting authorization.
• pending: The transaction is under review, usually awaiting the completion of an additional authentication (such as the 3DS challenge) before it can be confirmed
• confirmed: The transaction was successfully authorized and is ready for settlement or post-processing.
• paid: The payment has been successfully settled and funds have been transferred.
• refunded: The payment was refunded to the cardholder.
• chargeback_requested: The cardholder disputed the transaction; it's under review by the issuer.
• chargeback_refunded: The chargeback was accepted and the funds returned to the cardholder.
• cancelled: The transaction was manually canceled before being confirmed.
• error: The transaction failed during authorization or due to provider issues.

All terminal states (such as refunded, chargeback_refunded, cancelled, error) indicate that the transaction journey is complete.

➡️ See the diagram below for a visual representation of how each status connects within the payment lifecycle.

stateDiagram-v2
    direction TB

    state fork <<choice>>
    [*] --> fork

    fork --> issued: Payment Issued
    fork --> cancelled: Cancel before issuing

    issued: "issued"
    confirmed: "Confirmed"
    paid: "Paid"
    refunded: "Refunded"
    chargeback_requested: "Chargeback Requested"
    chargeback_refunded: "Chargeback Completed"
    error: "Error"
    cancelled: "Cancelled"

    issued --> confirmed: Authorize Success
    issued --> error: Authorization Failed
    issued --> cancelled: Manual Cancellation

    confirmed --> paid: Settlement
    confirmed --> refunded: Refund
    confirmed --> chargeback_requested: Chargeback

    paid --> refunded: Post-payment Refund
    paid --> chargeback_requested: Chargeback

    chargeback_requested --> chargeback_refunded: Completed

    confirmed --> [*]
    paid --> [*]
    refunded --> [*]
    error --> [*]
    cancelled --> [*]
    chargeback_refunded --> [*]

    %% Notes for states
    note right of issued
        Payment was requested by client.
    end note
    note right of confirmed
        Payment was confirmed, awaiting settlement.
    end note
    note left of error
        Failure during processing or authorization.
    end note
    note left of cancelled
        Request cancelled before confirmation.
    end note
    note right of paid
        Amount settled to recipient.
    end note
    note right of refunded
        Amount returned to cardholder.
    end note
    note right of chargeback_requested
        Cardholder disputed — under review.
    end note
    note right of chargeback_refunded
        Dispute closed, amount returned to cardholder.
    end note

    %% Style Classes
    classDef success fill:#c6f7e2,stroke:#04996d,stroke-width:3px,font-size:16px
    classDef danger fill:#ffd6d6,stroke:#c00,stroke-width:3px,font-size:16px
    classDef warning fill:#fff5ce,stroke:#ad9200,stroke-width:3px,font-weight:bold
    classDef info fill:#dde9fb,stroke:#3e74af,stroke-width:2px

    class confirmed,paid,refunded success;
    class error,cancelled danger;
    class chargeback_requested,chargeback_refunded warning;
    class issued, fork info;