Payment status meanings

Overview

• UNPAID means MiniTill has no successful money covering the payable amount.
• PENDING means a payment is still unresolved and must not be assumed to have failed.
• PARTIALLY_PAID means one or more approved payments exist but their net total is still below the payable amount.
• PAID means approved payment value covers the payable amount. A zero-value order can also be explicitly settled as PAID without a normal Payment row.
• PARTIALLY_REFUNDED means some approved payment value has been refunded but net paid money remains.
• REFUNDED means the approved payment value has been fully refunded.
• FAILED means settlement failed where no successful payment supersedes that state.

When to use this

• Use this guide before taking another payment or refund when the status is anything other than a straightforward UNPAID or PAID.

Step-by-step

1. For PENDING, use payment/provider recovery or status checking first.
2. For PARTIALLY_PAID, inspect which Payment rows are already approved, then collect only the remaining balance.
3. For PARTIALLY_REFUNDED, inspect refundedAmount on each Payment to see what remains refundable.
4. For REFUNDED, do not attempt another refund against a Payment with zero remaining refundable value.

Common mistakes

• Do not read PENDING as declined.
• Do not collect the full order amount again when the status is PARTIALLY_PAID.
• Do not use the original order total as the refundable amount after one or more refunds; use remaining refundable per Payment.

Troubleshooting

• If the summary status looks stale, reopen/refresh the order so MiniTill reconciles it from current Payment rows.
• If a provider status is uncertain, resolve that provider transaction before accepting another payment.