Error Type	Cause	Suggested Error Message	Handling & Solution
Payment Canceled by User	User cancel the payment window before completing and force to access the same page	Title : Payment was canceled. Description : Please try again or select another payment method CTA : Go to Homepage → Homepage Go to Checkout Page → Go to store page and restore the previous session on checkout page	Provide an option to retry or return to checkout.
Session Timeout	User takes too long to complete payment	Title : Payment window expired Description : Please try again or select another payment method CTA : Go to Homepage → Homepage Go to Checkout Page → Go to store page and restore the previous session on checkout page	Reset session and return to store page.

Error Type	Cause	Suggested Error Message	Handling & Solution
Slow Network	Poor internet connection	Title : Slow network detected Description : Please check your connection or try again CTA : Refresh this page → Refresh and reload the existing page Go to Homepage → Homepage	Show a loading indicator and allow retries.
Request Timeout	Payment provider takes too long to respond	Title : Payment request timed out Description : Please try again or select another payment method CTA : Go to Homepage → Homepage Go to Checkout Page → Go to store page and restore the previous session on checkout page	Retry payment request or offer alternative methods.
Payment Gateway Unavailable	Alipay+/WeChat Pay servers are down	Title : Payment service is currently unavailable Description : Please try again or select another payment method CTA : Go to Homepage → Homepage Go to Checkout Page → Go to store page and restore the previous session on checkout page	Display maintenance notice and suggest alternatives.

Error Type	Cause	Suggested Error Message	Handling & Solution
Incorrect API Credentials	Integration issue with Alipay+/WeChat Pay API	Title : Payment system error Description : Please contact our support (Line : @hungryhub). CTA : Go to Checkout Page → Go to store page (if possible, can restore the previous session on checkout page) Contact Us → redirect to line?	Log error and notify support team for a fix.
Transaction Not Found	Failed handoff between HungryHub and payment gateway	Title : We couldn’t find your payment transaction Description : Please try again or select another payment method CTA : Go to Homepage → Homepage Go to Checkout Page → Go to store page and restore the previous session on checkout page	Retry or allow user to restart payment.
Webhook Failure	Payment provider fails to notify HungryHub	Title : Payment verification failed. Description : Please contact support (Line : @hungryhub) if you were charged. CTA : Go to Checkout Page → Go to store page (if possible, can restore the previous session on checkout page) Contact Us → redirect to line?	Implement a manual verification option.
Unexpected Error (500)	Unhandled server error	Title : Something went wrong Description : Please try again later or contact support (Line : @hungryhub) CTA : Refresh this page → Refresh and reload the existing page Contact Us → Contact Us → redirect to line?	Log error and provide a support contact.