Skip to content

Transaction Status Values

Available Status Values

NEW

  • Transaction has been created but not yet sent to the payment scheme
  • Next states: AUTHORIZED, PREPARED, REJECTED, DECLINED

AUTHORIZED

  • Transaction has been authorized, funds reserved but not captured
  • Next states: CHARGED, REVERSED

CHARGED

  • Transaction successfully charged and funds captured
  • Next states: REFUNDED, CHARGEDBACK

REVERSED

  • Authorization was reversed before capture (final state)

PREPARED

  • Sent to 3DS but not yet completed by the customer
  • Next states: CHARGED, REJECTED, DECLINED

REJECTED

  • Rejected by the payment scheme (final state)

DECLINED

  • Declined by the payment scheme (final state)

CREDITED

  • Funds credited back to the customer (final state)

REFUNDED

  • Transaction has been refunded (final state)

CHARGEDBACK

  • Charged back by the customer's bank (final state)

FRAUD

  • Flagged as fraudulent (final state)

ERROR

  • Technical error during processing
  • Next states: NEW (retry), REJECTED

Status Flow

graph TD
    A[NEW] --> B[AUTHORIZED]
    A --> C[PREPARED]
    A --> D[REJECTED]
    A --> E[DECLINED]
    A --> F[ERROR]

    B --> G[CHARGED]
    B --> H[REVERSED]

    C --> G
    C --> D
    C --> E

    G --> I[REFUNDED]
    G --> J[CHARGEDBACK]
    G --> K[CREDITED]

    F --> A
    F --> D

Common Flows

FlowPath
Successful purchaseNEW → AUTHORIZED → CHARGED
3DS purchaseNEW → PREPARED → CHARGED
Reversed authorizationNEW → AUTHORIZED → REVERSED
RejectedNEW → REJECTED
DeclinedNEW → DECLINED
RefundCHARGED → REFUNDED

Notes

  • All status values are uppercase strings
  • Status transitions follow logical business rules
  • Some statuses are final states (no further transitions)
  • 3DS transactions may remain in PREPARED if authentication is not completed

Recivr — The intelligence layer of the payments stack.