PaymentStatus.java

package com.checkout.paymentgw.payment.domain;

/**
 * Lifecycle of a payment as seen by the write side.
 *
 * <ul>
 *   <li>{@code AUTHORIZED} — bank approved.</li>
 *   <li>{@code DECLINED}   — bank rejected.</li>
 *   <li>{@code REJECTED}   — failed pre-bank checks (validation, fraud).</li>
 *   <li>{@code FAILED}     — error happened that we could not classify (e.g. bank timeout after retries).</li>
 * </ul>
 */
public enum PaymentStatus {
    AUTHORIZED,
    DECLINED,
    REJECTED,
    FAILED
}