pending | No payment seen yet | no |
seen | Payment detected in mempool (0 conf) | no |
paid | Payment confirmed (≥ conf_threshold) | no (could be reverted via reorg) |
expired | Past expires_at, still inside grace window — address still watched | no |
late_paid | Payment arrived after expires_at but inside grace window | no (could be reverted) |
underpaid | Buyer sent less than amount_sats | no — you decide whether to ship |
overpaid | Buyer sent more | no — you may want to refund the difference |
requires_review | Internal cross-check mismatch — manual review needed | no |
reverted | Previously paid, then a chain reorg removed the tx | yes |
cancelled | Vendor cancelled before payment | yes |