Back to Payments
HIGHError Handling

Payment Failure Handling

Verify that the system gracefully handles failed payments, provides clear error messages, keeps order in PENDING status, and allows retry.

7 steps
~4 min
payment-6

Preconditions

  • Payment gateway is configured (Paystack or Flutterwave)
  • Products are available in the store

Test Data

For Paystack - use declined card or cancel payment. For Flutterwave - use 5258 5858 5858 5858 (insufficient funds)

Test Steps

Follow each step carefully

0/7

Add items to cart and proceed to checkout

Verify

Checkout page loads

Fill in shipping information

Verify

Information is saved

Select a payment gateway

Verify

Payment method is selected

Initiate payment and simulate failure

Location

Either cancel the payment modal or use a declined test card

Verify

Payment fails or is cancelled

Note

Can also close the payment window to simulate abandonment

Observe the error handling

Verify

Error message is displayed to customer

Note

Message should be user-friendly, not technical

Verify order status

Location

Check order in admin if created, or verify still on checkout

Verify

Order remains in PENDING payment status

Attempt to retry payment

Location

Click "Retry" or attempt payment again

Verify

Payment can be retried without re-entering order details

Expected Result

Error handling: (1) Clear error message shown to customer, (2) Order stays in PENDING status, (3) Customer can retry payment, (4) Cart/order details are preserved, (5) Failed attempt is logged for tracking, (6) No duplicate orders created.

Ready to Complete?

Click when you have verified all steps and the expected result.

Test Info

Module
Payments
Steps
7
Duration
4 min
XP Value
+30