Checkout Flow

How UniPay works from your customer's perspective — selection, payment authorisation, and order confirmation.

Amount display

At checkout, the cart total is shown in UNC (UniCash digital credits) as the primary amount, with your store's currency shown as a reference. For example:

Pay 100.00 UNC ≈ AUD 150.00

This display is required under the UniPay operating rules. The UNC amount is always primary; the fiat amount is reference only. 1 UNC = 1 AUD — no conversion complexity for Australian stores.

Block checkout flow (modern WooCommerce)

If your store uses the WooCommerce block checkout (the default in WooCommerce 8.3+), the flow is:

1. Customer selects UniPay from the payment methods list. The UNC amount updates automatically as they change quantities or apply coupons.
2. Customer clicks Place Order. The plugin calls the UniPay API to create a payment and the order is created in WooCommerce with a Pending payment status.
3. Customer is shown the payment card — a QR code and an "Open UniCash App" button.
4. Customer scans the QR code with another device, or taps the app button on mobile. The UniCash app opens with the payment pre-loaded.
5. Customer confirms the payment in the app with their PIN.
6. UniPay sends a payment.completed webhook to your store. The order moves from Pending to Processing automatically.
7. Customer sees the standard WooCommerce order confirmation page.

Classic checkout flow (legacy)

If your store uses the classic WooCommerce shortcode checkout ([woocommerce_checkout]), the flow is identical. The payment method appears in the classic payment method radio list, and the payment card is shown on the thank-you page after order placement.

Mobile vs desktop experience

Payment card details

The payment card shown after order placement includes:

• The UniPay logo
• The UNC amount to pay (primary, in gold)
• The store currency equivalent (reference, below)
• A QR code (desktop only)
• An "Open UniCash App" button (always shown)
• A "Pay on web" fallback link to the UniPay payment page
• A live status indicator that updates automatically when payment is confirmed
• "Powered by UniCash" footer

Payment confirmation timing

Once the customer authorises payment in the UniCash app, confirmation typically takes 2–5 seconds. The payment card page polls for confirmation automatically — the customer does not need to refresh.

On confirmation, the order status changes to Processing and the customer is redirected to the standard WooCommerce order confirmation page.

Payment expiry

UniPay payments expire after 30 minutes of inactivity. If a customer doesn't complete payment within this window, the payment is cancelled. The WooCommerce order remains in Pending payment status — WooCommerce's own order expiry settings will handle cleanup if configured.

What the order looks like in WooCommerce admin

The order notes will include the UniPay payment ID and confirmation timestamp for your records.