Payments and payment transactions

Every order has a payment transaction: a record of what the customer owes, what has been paid and refunded, and through which payment method. The order's payment status follows the transaction. This article explains the transaction list, the transaction statuses and the actions you use to settle payments by hand.

The payment transaction list

Open Sales → Payment transaction. Each row shows the payment method, the transaction amount, the paid amount, the customer, the order number, the status and the date.

The Payment Transactions list with four Cash on delivery transactions, three pending and one paid
Sales → Payment transaction. Filters narrow it by status, method or date.

Transaction statuses

StatusMeaning
PendingNothing has been paid yet. Offline methods such as Cash on delivery stay here until you mark them paid.
AuthorizedThe payment provider reserved the money but has not taken it. Capture it before the authorization expires.
Partial paidPart of the amount has been paid.
PaidThe full amount has been paid.
Partially refunded, RefundedPart or all of the payment was returned.
VoidedAn authorization was cancelled before capture; no money moved.
CanceledThe transaction was cancelled.

Settle a payment

Open a transaction to see its details and the actions its payment method and status allow.

Payment Transaction Details of a pending Cash on delivery transaction of 340.10 USD with Mark as paid and Partial paid (offline) buttons
A pending offline payment: mark it paid, or record a partial payment.
  • Capture takes an authorized payment through the payment provider.
  • Mark as paid records that the full amount arrived outside GrandNode (cash, bank transfer). The order's payment status becomes Paid.
  • Partial paid (offline) records a part payment; the paid amount grows and the status becomes Partial paid.
  • Refund returns money through the provider, if it supports refunds; Refund (offline) only records a refund made outside GrandNode. Partial variants refund a given amount.
  • Void and Void (offline) cancel an authorization.

Every action asks for confirmation and adds a note to the order.

The same transaction after Mark as paid: status Paid, paid amount 340.1 USD, with Refund offline and Partial refund offline buttons
After Mark as paid: the refund actions become available.

How payment completes an order

When an order is paid and needs no shipping, or is paid and delivered, GrandNode moves it to Complete. An order that is delivered but not yet paid stays in Processing. See Order, payment and shipping statuses.

Tips and common mistakes

  • Mark as paid does not contact the payment provider. Use it only for money you have actually received.
  • An offline refund does not send money back; it only records that you did.
  • Payment methods and their settings are under Configuration → Payment (see Configuration).

Question not answered here? Ask the community on GitHub Discussions ↗