Testing instructions for critical flows

Please follow the below instructions to execute/run cases mentioned in the critical flow.

Plugin Activation Without Errors

Verify that the Payfast Payment Gateway plugin installs and activates successfully without any errors.

Test Steps:

1. Navigate to the Woo account or GitHub and download the plugin zip file.
2. Log in to the WordPress Admin Dashboard.
3. Install the plugin.
4. After successful installation, click the "Activate" button to activate the plugin.
5. Observe the activation process for any error messages or issues.
6. Check the "Plugins" page to ensure that the newly installed plugin appears in the list of active plugins.

Expected Result:

The plugin should install and activate without any errors. A success message should be displayed after activation, indicating that the Payfast Payment Gateway plugin is now active.

---

Verify dependent plugin 'Require' functionality when the core plugin 'WooCommerce' is not active

This plugin is an extension of WooCommerce, plugin should check the active status of WooCommerce when activating. If WooCommerce is not active, the 'Activate' button should be disabled.

Test Steps:

1. Go to the Plugins section of the WordPress dashboard.
2. Deactivate WooCommerce if active.
3. Try to activate this extension.

Expected Result-

1. The Plugin 'Activate' button should be disabled, and the admin should not be able to activate the plugin.
2. A notice 'This plugin cannot be activated because required plugins are missing or inactive.' below the plugin should appear.

---

Payfast Gateway Disabled with Non-ZAR Currency

To verify that the Payfast Gateway integration is disabled and displays an appropriate message when the store currency is set to a currency other than South African Rands (ZAR) in the General Settings.

Test Steps:

1. Navigate to the General Settings or Currency Settings section.
2. Verify that the store currency is set to a currency other than ZAR (e.g., USD, EUR, GBP, etc.).
3. Attempt to enable the Payfast Gateway integration while the store currency is set to a non-ZAR currency.
4. Observe any error messages or notifications displayed during the enabling process.

Expected Result:

An appropriate error message is displayed, indicating that the Payfast Gateway integration cannot be enabled with the current store currency, and it suggests changing the store currency to South African Rands (ZAR) to enable the Payfast Gateway.

---

Payfast Plugin Compatibility with ZAR Store Currency

To verify that the Payfast plugin works correctly when the store currency is set to South African Rands (ZAR).

Test Steps:

1. Navigate to the Payment Gateway settings or Plugins section.
2. Locate the Payfast plugin and ensure that it is enabled.

Expected Result:

The Payfast plugin is enabled without any errors. Verify that all the required Payfast configuration settings are available, including Merchant ID, Merchant Key, etc.

---

Enable Payfast Option

Verify that enabling the Payfast option in the plugin settings makes it available on the checkout page for customers.

Test Steps:

1. Log in to the admin dashboard.
2. Navigate to the Payment Gateway settings
3. Find the Payfast plugin settings.
4. Check the box to enable the Payfast option.
5. Save the settings.

Expected Result:

Payfast should be enabled and visible as a payment option on the checkout page for customers.

---

Title and Description Display

Verify that the provided title and description are shown correctly to customers on the checkout page.

Test Steps:

1. Navigate to the Payment Gateway settings or Plugins section.
2. Find the Payfast plugin settings.
3. Enter a specific title and description in their respective fields.
4. Save the settings.
5. Proceed to the checkout page as a customer (using a test order).

Expected Result:

The specified title and description should be displayed as intended on the Payfast payment option at the checkout page.

---

Verify Merchant ID, Merchant Key, and Passphrase

Check that the Merchant ID, Merchant Key, and Passphrase are correctly set in the Payfast gateway plugin settings.

Test Steps:

1. Log in to the eCommerce platform's admin dashboard.
2. Navigate to the Payfast gateway plugin settings.
3. Verify that the Merchant ID, Merchant Key, and Passphrase fields are present and labeled correctly.
4. Enter valid values for the Merchant ID, Merchant Key, and Passphrase fields.
5. Save the settings.

Expected Result:

The Merchant ID, Merchant Key, and Passphrase should be set correctly without any errors, and the plugin settings should be successfully saved.

---

Verify Debug Email Configuration

Ensure that the "Send Debug Emails" option is functional and that emails are received by the specified address (if provided).

Test Steps:

1. Navigate to the Payfast gateway plugin settings.
2. Check the box for "Send Debug Emails."
3. Enter a valid email address in the "Who Receives Debug E-mails?" field
4. Save the settings.
5. Initiate a test transaction through the Payfast gateway.

Expected Result:

Debug emails should be sent to the specified email address, providing transaction-related information.

---

Verify Enable Logging Functionality

if enabling the logging option records transaction event information in the logs for troubleshooting purposes.

Test Steps:

1. Log in to the admin dashboard.
2. Navigate to the Payfast gateway plugin settings.
3. Check the box to enable logging.
4. Save the settings.
5. Perform a test transaction through the Payfast gateway.
6. Navigate to WooCommerce > Status > Logs in the admin dashboard.

Expected Result:

A new log should be created, recording transaction event information related to the test transaction made using the Payfast gateway.

---

Verify Logging when "Enable Logging" is Not Checked

Ensure that no logs are created when the "Enable Logging" option is not checked.

Test Steps:

1. Log in to the eCommerce platform's admin dashboard.
2. Navigate to the Payfast gateway plugin settings.
3. Ensure that the "Enable Logging" option is not checked (disabled).
4. Save the settings.
5. Perform a test transaction through the Payfast gateway.
6. Navigate to WooCommerce > Status > Logs in the admin dashboard.

Expected Result:

No new logs should be created as the "Enable Logging" option is not checked, indicating that logging functionality is disabled.

---

Verify Payfast Payment Option Availability

Check if the Payfast Payment Gateway option is available on the checkout page for customers.

Test Steps:

1. Add products to the cart.
2. Proceed to the checkout page.
3. Inspect the available payment options.

Expected Result:

Payfast Payment Gateway option should be available as one of the payment methods on the checkout page.

---

Verify Payfast Option Visibility

Ensure that the Payfast Payment Gateway option is only displayed when it is enabled in the plugin settings.

Test Steps:

1. Navigate to the Payment Gateway settings or Plugins section.
2. Find the Payfast plugin settings.
3. Disable the Payfast Payment Gateway option.
4. Save the settings.
5. Proceed to the checkout page.

Expected Result:

Payfast Payment Gateway option should not be visible on the checkout page since it was disabled in the plugin settings.

---

Verify Payfast Payment Process

Test the payment process using the Payfast Payment Gateway option.

Test Steps:

1. Add products to the cart.
2. Proceed to the checkout page.
3. Select the Payfast Payment Gateway option.
4. Complete the payment process.

Expected Result:

1. The payment process should be successful without any errors, and the customer should receive a confirmation of the successful payment.
2. Open the Order from the WooCommerce Order section.
3. Order should have 'Processing' status.

---

Verify Payfast Payment Confirmation

Ensure that customers receive an order confirmation and payment receipt after successfully using the Payfast Payment Gateway.

Test Steps:

1. Complete a test transaction using the Payfast Payment Gateway.
2. Check the customer's email inbox for order confirmation.

Expected Result:

The customer should receive an order confirmation email containing details of the purchase, and payment details should be included, confirming the successful payment made through Payfast.

---

Verify Payfast Payment Failure Handling

Test how the Payfast Payment Gateway handles payment failures.

Test Steps:

1. Add products to the cart.
2. Proceed to the checkout page.
3. Select the Payfast Payment Gateway option.
4. Cancel the payment process on the PayFast payment screen.
5. Open the Order screen from the admin.

Expected Result:

The Payfast Payment Gateway should detect the payment failure and order status should be Cancelled.

---

Verify ITN for Successful Payment

Test if the PayFast sandbox account sends the Instant Transaction Notification (ITN) after successful payment on the checkout page.

Test Steps:

1. Add products to the cart.
2. Proceed to the checkout page.
3. Select the PayFast Payment Gateway option.
4. Complete the payment process using test payment details
5. Wait for a few seconds to allow the ITN to be sent from the sandbox account to the specified ITN endpoint.
6. Login on PayFast Sandbox account dashboard

Expected Result:

The ITN should be sent to the specified endpoint, and the endpoint should receive and process the ITN data. The ITN should contain details about the successful payment, including the order ID, payment status, etc.

---

Test Payfast Payment Method on Block-Based Checkout

To verify the functionality of the Payfast Payment method on the block-based checkout in the eCommerce platform.

Test Steps:

1. Add products to the cart.
2. Proceed to the checkout page using the block-based checkout option.
3. Check for the presence of the Payfast Payment method block on the checkout page.
4. Complete the payment

Expected Result: The Payfast Payment method block should be displayed as one of the available payment options during the block-based checkout process and the order should be placed without any error.

---

Test Subscription Product with PayFast Payment Gateway

To verify the functionality of the PayFast Payment Gateway with a subscription product in WooCommerce.

Test Steps-

1. Install and activate WooCommerce, WooCommerce Subscriptions, and WooCommerce PayFast Gateway plugins.
2. Create a simple subscription product
3. Add the subscription product to the cart.
4. Proceed to the checkout page.
5. Select PayFast Payment Gateway as the payment method.
6. Complete the payment process using valid test payment details (provided by PayFast sandbox environment).
7. After successful payment, go to "My Account" > "Orders."
8. Find the order related to the subscription purchase and click on it to view the order details.
9. Locate the related subscription information.

Expected Result: The subscription should be in "Active" status, indicating that the payment was successful, and the subscription is active.

---

Renew Subscription via PayFast

To verify the renewal process for a subscription using the PayFast Payment Gateway.

Test Steps:

1. 1. Follow Steps from the above "Test Subscription Product with PayFast Payment Gateway" test case.
2. Go to "My Account" > "Orders."
3. Find the order related to the subscription purchase and click on it to view the order details.
4. Locate the related subscription information.
5. Click on the "Renew" button for the subscription.

Expected Result:

The subscription renewal process should be triggered, and the customer should be charged automatically using the PayFast Payment Gateway for the next billing cycle.