WooCommerce
The integration of Interest Free shopping for WooCommerce utilises Wordpress plugins. Plugins are distributed via Wordpress Plugin Directory.
#
Setup Pre-requisite RequirementsMerchants using WooCommerce will need credentials which are required for configuration:
WooCommerce Merchant ID | Authorised 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 Key | Authorised 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- Log in to Wordpress as Administrator
- Navigate to Plugins > Add New
- On the Add Plugins page, enter Latitude Interest Free to search for the plugin
- Search result will display the Latitude Interest Free for WooCommerce Plugin. Click the Install Now button
- After the plugin is installed, click the Activate button
- Scroll down the list of plugin and search for Latitude Interest Free Gateway for WooCommerce is correctly installed
- From the same page, click on Settings to browse to the configuration page. Enter Merchant credentials and save the configuration
- Other configuration include:
Settings | Description |
Enable/Disable | Activates the gateway on the store |
Test Mode | For 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- 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:
- The Latitude interest free setup for the Woo store is complete.
#
The Customer’s Experience- 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”
The Customer is redirected to the Latitude Checkout (the plugin initiates a request by sending a POST request to Latitude)
Latitude Checkout shows promotions and loads payment page. Customer then selects promotion (eg. 6 months or 12 months) and enters card details
Latitude Checkout processes payment and redirects Customer back to Merchant
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.
#
Maintain WooCommerce Order#
CaptureMerchants 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.
- Login to Admin Dashboard
- 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
- Click on Update
- If approved, status would be changed from on-hold to processing and information from the gateway would appear under order notes.
#
VoidMerchants 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.
- Login to Admin Dashboard
- 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
- Cick on Update
- If approved, status would be changed from on-hold to cancelled and information from gateway would appear under order notes
- If failed, status would stay on-hold status, failure reason and information from gateway would appear under order notes
#
RefundMerchants 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.
- Login to Admin Dashboard
- Click on Orders and look for the order to refund
- Select the order to view the order details
- Update the Qty to refund. Alternatively, if there is no Qty option, manually enter the Total.
- For Full refunds, update the Qty (or Total) for all items.
- Add a Reason for refund (optional)
- For AU, click on Refund via Latitude Interest Free. For NZ, click on Refund via Gem Interest Free.
- The Refund request will be sent to Latitude, verify the refund was successful by reviewing the Order Notes (refresh the page if required)
- If the Order was fully refunded, the Order will also show under ‘Refunded’ list
#
Partial Refund- Perform a partial refund when only certain line item/s from an order/transaction needs to be refunded.
- Follow same steps 1-4 above as for "Full Refund" steps
- Select only the particular line items and/or full or partial shipping fee amount as per the merchant’s policy
- Add a Reason for refund (optional)
- For AU, click on Refund via Latitude Interest Free. For NZ, click on Refund via Gem Interest Free.
- The Refund request will be sent to Latitude, verify the refund was successful by reviewing the Order Notes (refresh the page if required)
- To perform further refunds on the same order, repeat the process