View source for X-Cart:Order status notifications used with online payment methods

Depending on the stage of processing, the status of an order paid with an online payment method may change between [[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods|''Queued'']], [[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods|''Not finished'']] and [[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods|''Processed'']]. This article overviews the cases when order status changes and order status notifications that are sent to user with different notification settings.

===Orders and statuses===

Any new order placed via an ''online'' payment method is created with the status [[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods|''Not finished'']].

Then X-Cart "talks" to the payment gateway and attempts to get information on the status of the payment transaction.

If for whatever reason that communication fails, the order remains with the [[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods|''Not finished'']] status. Here is a couple of examples how this could happen:

* A customer chooses to pay via PayPal, so he gets redirected to PayPal. Suddenly, he changes his mind, does not complete the payment process and closes the browser.

* A customer chooses to pay with a Credit Card, enters the credit card data and clicks "Submit" on the last checkout page, but the customer's browser or computer shuts down for some reason.

If the communication is successful, the order status changes to:

[[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods|''Processed'']] - the payment transaction is Approved by the payment gateway AND the order passes the antifraud check.

[[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods|''Queued'']] - in case the payment transaction is Approved by the payment gateway BUT the order DOES NOT pass the antifraud check.

[[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods|''Failed'']] - in case the payment transaction is Declined by the payment gateway OR X-Cart can not interpret the information received from the payment gateway for some reasons.

===Order statuses and notifications===

[[X-Cart:Email_Notifications_Options#Orders_department_notifications|'''Enable email notifications for orders department/providers about initially placed orders''']] turned '''ON''', you will receive notifications on every new [[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods|''Not finished'']] order, placed via an ''online'' payment method.

To receive notifications when the order status changes from [[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods|''Not finished'']] to [[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods|''Processed'']], you should still turn '''ON''' [[X-Cart:Email_Notifications_Options#Orders_department_notifications|'''Order is processed notification to orders department''']].

No notification is sent to the Order Department when the order status changes from [[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods|''Not finished'']] to [[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods|''Queued'']] or [[X-Cart:Orders#Statuses_of_orders_paid_for_by_online_payment_methods|''Failed'']].