---
title: WooCommerce Integration
slug: woocommerce-integration
icon: {"faIcon":"fa-brands fa-wordpress"}
docTags: 
createdAt: 2022-10-12T10:31:25.000Z
---

# Introduction

WooCommerce is an open-source, completely customizable e-commerce platform. It offers a flexible way to build an e-commerce store with WordPress.&#x20;

The LatitudePay Woocommerce plugin offers seamless integration and ensures compatibility with the latest version of WooCommerce.

:::BlockQuote
**Note:&#x20;**&#x43;urrency Supported - MYR (Malaysian Ringgit) & SGD (Singapore Dollar)
:::

## Compatibilities and Dependencies

- WordPress v 5.3 or higher
- Woocommerce v 3.6.0 or higher
- PHP v7.0 or higher
- php-cURL

**Note:**

- To use this plugin, you will need to make network calls. Ensure that you have the php-cURL extension installed to make the required network calls.
- The plugin has been tested using WooCommerce v3.6.0

## Prerequisites

- Signup as a LatitudePay Merchant
- Get Merchant API-Keys (public key and private key) from [Merchant console](https://merchant.sg.latitudepay.com/)
- **Follow this link for details**: [Prerequisites](https://docs.sg.latitudepay.com/integration-prerequisite)

# Integration Steps Summary:

1. Install Plugin.
2. Configure WooCommerce.
3. Accept Live Payments

### Download Plugin

****

::::Tabs
:::Tab{title="Download production"}
- Download the v2.1.8 code zip file from the [LatitudePay Github.](https://github.com/octifi/woocommerce-plugin/blob/main/woocommerce-master-latest.zip)
:::
::::

### Step 1: Install Plugin

- Unzip and upload contents of the extension to your /wp-content/plugins/ directory.
- Log into your WordPress account and activate the LatitudePay plugin in the WordPress Plugin Manager. plugins (Click the Plugins tab on the left -> Add New (At the top of the page)-> Upload Plugin (At the top of the page)



::Image[]{src="https://api.archbee.com/api/presign/uMLzTav_HIzdTyGRmLuEG/5EeVn6q_eAFbpvvcTykK6_Screenshot%202020-12-17%20at%206.20.29%20PM.png" size="90" caption="How to add the Octifi Plugin" position="center" showCaption="true"}



::Image[]{src="https://api.archbee.com/api/presign/uMLzTav_HIzdTyGRmLuEG/oLR4ejy4Jdz82bUYRJf6d_Screenshot%202020-12-17%20at%205.58.27%20PM.png" size="90" caption="Activate the OctiFi Plugin" position="center" showCaption="true"}





### Step 2: Configure WooCommerce

- Log into your WooCommerce account, navigate to Settings and click the Payments tab. Besides LatitudePay Payment gateway click on the Manage button.

::Image[]{src="https://api.archbee.com/api/presign/uMLzTav_HIzdTyGRmLuEG/beavBjxNyKHaEbdSEIync_Screenshot%202020-12-17%20at%206.01.36%20PM.png" size="90" caption="Access WooCommerce Settings" position="center" showCaption="true"}



::Image[]{src="https://api.archbee.com/api/presign/uMLzTav_HIzdTyGRmLuEG/d6ytKGK-8rQNzZV6vy7QF_Screenshot%202020-12-17%20at%206.44.40%20PM.png" size="90" caption="Access Payments tab in Settings" position="center" showCaption="true"}







::Image[]{src="https://api.archbee.com/api/optimize/uMLzTav_HIzdTyGRmLuEG/TNZOVxDsHIWJE5oVU4pAp_screenshot-2021-11-16-at-34353-pm.png" size="90" width="3558" height="1890" position="center" showCaption="false"}



- Enable the Payment Method, You can also name it “LatitudePay Payments”&#x20;
- If you want to use the sandbox mode you can simply toggle the "Test mode" to "enable".
- If the testmode is `disabled` you can select the servicing **country**. If testmode is `enabled`  the country dropdown could be disabled by default.&#x20;
- You can hide/show the LatitudePay Text and logo by enabling/disabling the checkbox "Home page text"
- Add in your \<public\_api\_key> and \<Private\_api\_key>  generated from the LatitudePay Merchant console dashboard (see prerequisites).
- By default, the LatitudePay payment text is disabled. If you want to show the text under the products please unselect the checkbox.
- If you want to show the LatitudePay payment text for certain products. Please enter the amount accordingly.&#x20;
  **For Example:&#x20;***if you want to disable the text for products that are less than or equal to 50 dollars. Then you need to enter 50 in **"minimum sum".&#x20;***
- Payment Action is Authorize and Capture to auto-capture payments.
- if you want to enable the Auth & Capture as a payment action please Select "**Authorise & Capture**". or Enable "**Authorization**" for Auth only



![](https://api.archbee.com/api/optimize/uMLzTav_HIzdTyGRmLuEG/8DFXMqSq91AsoCEif3Xqt_untitled.png)





- If Authorization is enabled we need to capture the payment manually. In order to capture the payment. Please goto --> orders --> click the order --> click capture button. Please check the below screenshot for reference.




![](https://api.archbee.com/api/optimize/uMLzTav_HIzdTyGRmLuEG/pqMw20NsaPoTAe3ZmYPhn_screenshot-2022-01-27-at-21815-pm.png)







### Step 3: Accept Live Payments

- You are ready to accept live payments once the plugin is activated

# Currency Support

We currently support SGD and MYR.


**SGD:**
You can accept payments in SGD when using the plugin version 1.0 or higher.

To accept payments in SGD (Singapore dollar) currency:

-
- Ensure all your products are priced correctly in the above currency

**MYR:**
You can accept payments in MYR when using the plugin version 2.1.3 or higher.

To accept payments in MYR (Malaysian Ringgit) currency:

- Set your shop's base currency to MYR.
- Ensure all your products are priced correctly in the above currency



:::hint{type="warning"}
## Accepting payments in other currencies?

Currently LatitudePay supports accepting payments for Singaporean currency and Malaysian Ringgit only.
:::

# Cancellations/ Refund

- Use the LatitudePay [merchant console](https://merchant.octifi.com) dashboard for canceling/partial refunding the orders


# Testing

****

| **Country** |                                                                                                                                                             |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Singapore   | [[https://docs.sg.latitudepay.com/](https://docs.sg.latitudepay.com/)testing-woocomerce-plugin](https://docs.sg.latitudepay.com/testing-woocommerce-plugin) |
| Malaysia    |                                                                                                                                                             |
|             |                                                                                                                                                             |



















