Skip to main content

WooCommerce

The integration of Interest Free shopping for WooCommerce utilises Wordpress plugins. Plugins are distributed via Wordpress Plugin Directory.

Setup Pre-requisite Requirements#

Merchants using WooCommerce will need credentials which are required for configuration:

WooCommerce Merchant IDAuthorised WooCommerce Merchants are identified by Latitude using a unique Merchant Identifier.

If you have not received your Merchant ID or Secret Key please contact your Latitude Financial Services representative.
Secret KeyAuthorised WooCommerce Merchants are identified by Latitude using a unique password.

If you have not received your Merchant ID or Secret Key please contact your Latitude Financial Services representative.

Install and activate the WooCommerce plugin#

  1. Log in to Wordpress as Administrator
  2. Navigate to Plugins > Add New

Latitude portal image

  1. On the Add Plugins page, enter Latitude Interest Free to search for the plugin

Latitude portal image

  1. Search result will display the Latitude Interest Free for WooCommerce Plugin. Click the Install Now button

Latitude portal image

  1. After the plugin is installed, click the Activate button

Latitude portal image

  1. Scroll down the list of plugin and search for Latitude Interest Free Gateway for WooCommerce is correctly installed

Latitude portal image

  1. From the same page, click on Settings to browse to the configuration page. Enter Merchant credentials and save the configuration

Latitude portal image

  1. Other configuration include:
SettingsDescription
Enable/DisableActivates the gateway on the store
Test ModeFor Development/Sandbox/Test, use the TEST credentials and set Test Mode YES (check box is ticked).
For Production, use the PRODUCTION credentials and set Test Mode NO (check box is not ticked)

Widget Configuration#

  1. Change widget configuration to match your store theme. This setting expects a valid JSON which can be generated using the Widget Playground to sample the layout options.
    Example of widget configuration:
{
"productWidget": {
"layout": "standard",
"promotionMonths": 12
}
}
  1. The Latitude interest free setup for the Woo store is complete.

The Customer’s Experience#

Latitude portal image

  1. Customer views listing on merchant’s website, add item(s) to the cart and proceeds to checkout page. On checkout page, selects Latitude Interest Free and clicks on “Choose a Plan”

Latitude portal image

  1. The Customer is redirected to the Latitude Checkout (the plugin initiates a request by sending a POST request to Latitude)

  2. Latitude Checkout shows promotions and loads payment page. Customer then selects promotion (eg. 6 months or 12 months) and enters card details

Latitude portal image

  1. Latitude Checkout processes payment and redirects Customer back to Merchant

  2. Plugin verifies payment response and shows the order confirmation for approved payments (approved payments will have information which can be used for processing refunds via Merchant Portal if required).
    For failed payments, feedback is shown to customers which allows them to either retry the Interest Free payment or choose another payment method.

Latitude portal image

Maintain WooCommerce Order#

Capture#

Merchants can now capture orders using the WooCommerce Admin Dashboard, rather than settling the order in the Latitude Merchant Portal (SMP).

Only full captures are supported, that is, all line items within the order will be captured in the one request.

This feature is only applicable for Deferred Settlement Merchants. Instant Settlement Merchants do not use capture, as their orders have been instantly settled.

It is highly recommended to choose one platform to process Captures. If the WooCommerce dashboard is used, Merchants no longer need to use SMP.

PREREQUISITE: for Deferred Settlement Merchants only, Captures can only be issued if the order is in an on-hold state (not in a cancelled nor refunded state).

SMP can still be used to retrieve settlement statements.

  1. Login to Admin Dashboard
  2. Navigate to Admin > Wocommerce > Order > Edit Order > Other Actions
    a. For AU, click on Capture via Latitude Interest Free
    b. For NZ, click on Capture via Gem Interest Free

Latitude portal image

Latitude portal image

  1. Click on Update

Latitude portal image

  1. If approved, status would be changed from on-hold to processing and information from the gateway would appear under order notes.

Latitude portal image

Void#

Merchants can now cancel orders using the WooCommerce Admin Dashboard, rather than voiding the order in the Latitude Merchant Portal (SMP).

Only full voids are supported, that is, all line items within the order will be voided in the one request.

This feature is only applicable for Deferred Settlement Merchants. Instant Settlement Merchants do not use void, instead will use refund as their orders have been instantly settled.

It is highly recommended to choose one platform to process Voids. If the WooCommerce dashboard is used, Merchants no longer need to use SMP.

PREREQUISITE: for Deferred Settlement Merchants only, Voids can only be issued if the order is in an on-hold state (not in a captured nor refunded state).

SMP can still be used to retrieve settlement statements.

  1. Login to Admin Dashboard
  2. Navigate to Admin > Wocommerce > Order > Edit Order > Other Actions
    a. For AU, click on Void / Cancel via Latitude Interest Free
    b. For NZ, click on Void / Cancel via Gem Interest Free

Latitude portal image

  1. Cick on Update

Latitude portal image

  1. If approved, status would be changed from on-hold to cancelled and information from gateway would appear under order notes
  2. If failed, status would stay on-hold status, failure reason and information from gateway would appear under order notes

Latitude portal image

Refund#

Merchants can now perform Refunds using the WooCommerce Admin Dashboard, rather than using the Latitude Merchant Portal (SMP).

This feature is available for both Instant and Deferred Settlement Merchants.

It is highly recommended to choose one platform to process refunds. If the WooCommerce dashboard is used, Merchants no longer need to use SMP, It will take up to 5 working days for the Customer to receive the refund.

PREREQUISITE: for Deferred Settlement Merchants only, Refunds can only be issued if the order is in a processing (captured) state. The Capture must have been fulfilled via the WooCommerce Admin Dashboard/Latitude Checkout. If the Capture was completed via Merchant Portal, then the Refund cannot be processed via the WooCommerce Admin Dashboard.

SMP can still be used to retrieve settlement statements.

Full Refund#

  • Perform a full refund when the entire order/transaction needs to be refunded.
  1. Login to Admin Dashboard
  2. Click on Orders and look for the order to refund
  3. Select the order to view the order details
  4. Update the Qty to refund. Alternatively, if there is no Qty option, manually enter the Total.
  5. For Full refunds, update the Qty (or Total) for all items.
  6. Add a Reason for refund (optional)
  7. For AU, click on Refund via Latitude Interest Free. For NZ, click on Refund via Gem Interest Free.
  8. The Refund request will be sent to Latitude, verify the refund was successful by reviewing the Order Notes (refresh the page if required)
  9. If the Order was fully refunded, the Order will also show under ‘Refunded’ list

Latitude portal image

Partial Refund#

  • Perform a partial refund when only certain line item/s from an order/transaction needs to be refunded.
  1. Follow same steps 1-4 above as for "Full Refund" steps
  2. Select only the particular line items and/or full or partial shipping fee amount as per the merchant’s policy
  3. Add a Reason for refund (optional)
  4. For AU, click on Refund via Latitude Interest Free. For NZ, click on Refund via Gem Interest Free.
  5. The Refund request will be sent to Latitude, verify the refund was successful by reviewing the Order Notes (refresh the page if required)
  6. To perform further refunds on the same order, repeat the process