How to Review Order Payments

What This Task Does

This task helps you verify how an order was paid, whether money is still due, and whether any payment is ready for refund or follow-up.

Before You Start

Make sure:

• the order already exists
• the relevant payment gateway is configured
• you know whether the payment came from Stripe, a saved card, a manual method, or another project-specific flow
• your project exposes the payment controls or payment panel built on top of the shared order-payment API

The shared package defines the payment workflows strongly, but it does not ship a dedicated shared admin page just for payment review.

Steps

1. Open the order you want to review.
2. Confirm the billing context first:
   • total price
   • paid amount
   • refunded amount
   • amount due
3. Open your project’s payment section or payment workflow for that order.
4. Review the existing payment records:
   • gateway type
   • status
   • captured amount
   • refunded amount
   • receipt or reference number
   • refundable status
5. If you need to create a payment, choose the correct path:
   • saved Stripe card
   • manual payment
   • checkout-link flow
6. If the payment came from Stripe and looks stale locally, run the sync flow if your project exposes it.
7. Re-check the order amount due after any change.

What Happens Next

After payment review:

• the order’s amount due should be easier to trust
• your team can decide whether the order is ready for next steps
• refundable payments are easier to identify
• later invoice or refund workflows have better context

Common Mistakes

• Looking only at order totals without checking actual payment records.
• Confusing a saved payment method with a completed order payment.
• Creating a manual payment for more than the amount due.
• Ignoring payment status when deciding whether a refund is possible.

Related Guides

• Payments & Billing
• Payments
• How to retrieve an invoice

Sources

• packages/framework/src/Http/Controllers/Api/Admin/OrderPaymentsController.php
• packages/framework/src/Models/OrderPayment.php
• packages/framework/src/Models/Order.php
• packages/framework/src/Actions/Stripe/ChargeStripeCustomerCard.php
• packages/framework/src/Actions/Stripe/SyncStripeCheckoutToOrderPayment.php