Getting Started
...
Malaysia
Magento Integration

Magento Direct Install from Marketplace

25min

Introduction

We are delighted to announce the LatitudePay Asia Magento Extension availability on the Adobe Commerce Marketplace. This integration empowers your online store with the capability to offer LatitudePay Asia as a secure and convenient payment option. Elevate your customer's shopping experience by offering a streamlined transaction process.

Note: Currency Supported - SGD (Singapore Dollar) and MYR (Malaysian Ringgit).



Prerequisites

To get started with integrating the LatitudePay Asia extension into your Magento store, you need to sign up for a LatitudePay Merchant Account and obtain the API keys (public key and private key) from the Merchant console. Here's a step-by-step guide:

Follow this link for details: Prerequisites
  1. Sign up for a LatitudePay Merchant Account. Click here for more detail.
  2. Obtain the Prod API keys (public key and private key) from the Merchant console.



Integration Steps

Here are two simple ways to find the LatitudePay Asia Magento Extension: 1. Free Magento Add to Cart Extension: Click on the provided link to install the LatitudePay Asia Magento extension. 2. Adobe Commerce Marketplace Search: Alternatively, search for the LatitudePay Asia extension directly within the Adobe Commerce Marketplace.

Steps to do Add to Cart and complete the order from Adobe Commerce Marketplace

  1. Login/Signup to the Adobe Commerce Marketplace.
Login/Signup screen
Login/Signup screen


2. Navigate to the extension Latitudepay Asia detail page.

Search Result
Search Result

Extension Detail page
Extension Detail page




3. Select the store Magento version before clicking the "Add to Cart" option.



Select store version
Select store version




4. Click the 'Add to Cart' option, as it is a FREE extension and will not incur any charges for the merchant.

Add to cart
Add to cart


5. Proceed to the Checkout page and fill in the required details.

Checkout page
Checkout page


6. Once the merchant submits the details on the checkout page, they will be redirected to the confirmation page, and the extension will be added to my order list.



Confirmation page
Confirmation page


Get the extension Access keys, Composer name and version from Adobe Commerce Marketplace

  1. Navigate to 'My profile' ➔ 'Access keys', click on 'Create a new access key,' and a pop-up will appear where the merchant needs to add the name; after that, public and private keys will be generated.

Note: These access keys will be used in the installation process of the extension in further steps.



Navigate to access keys menu item
Navigate to access keys menu item

Click on Create a new access key
Click on Create a new access key




pop-up appeared
pop-up appeared

Access keys created
Access keys created




2. Next, navigate to 'My profile' -> 'My purchases'. Here, you can find the Latitudepay Asia extension in the Commerce Marketplace and retrieve its Component name and version.



My purchases
My purchases

Component name and version
Component name and version




Add the extension’s name and version to your composer.json file via terminal

  • Navigate to your project directory (public_html) and update your composer.json file by running the following command,

composer require latitudepayasia/magento-payment-gateway-extension:2.1.7

  • Enter your authentication access keys which were created under 'My profile' -> 'Access keys'. Your public key is your username; your private key is your password.
Run the command and use access keys
Run the command and use access keys

  • Wait for Composer to finish updating your project dependencies and make sure that there aren’t any errors.
  • To verify that the extension installed properly, run the following command:

php bin/magento module:status Octifi_Octifi

Output:

public_html$ php bin/magento module:status Octifi_Octifi Octifi_Octifi : Module is enabled

If you find it disabled, then run the following command to enable it,

php bin/magento module:enable Octifi_Octifi

  • Run the following command to register the extension

php bin/magento setup:upgrade

php bin/magento setup:di:compile

  • Check your Magento Mode, by running the following command,

php bin/magento deploy:mode:show"

  • If your Magento mode is "production" Please run the below commands

Run the following command to clean the cache

php bin/magento cache:clean

php bin/magento cache:flush

php bin/magento indexer:reindex

php bin/magento setup:static-content:deploy

  • If your Magento mode is "default" (or) "developer" Please run the below commands

Run the following command to clean the cache

php bin/magento cache:clean

php bin/magento cache:flush

php bin/magento indexer:reindex

php bin/magento setup:static-content:deploy -f



Complete the extension configuration in the Magento store backend

  • Log in to your Magento Store Backend. 
  • Navigate to Stores > Settings > Configuration. 
Store -> Configuration
Store -> Configuration

  • Click on Sales and choose Payment Methods.
Sales -> Payment Methods
Sales -> Payment Methods


 

Latitude Pay Extension Settings
Latitude Pay Extension Settings

  • In the LatitudePay Payment section, configure the following: 

1. Enable LatitudePay Payment Method. 

2. Select the applicable country (Singapore or Malaysia)

3. Specify the payment title displayed on the checkout page. 

4. Enter the Public API Key and Private API Key received from LatitudePay Portal. 

5. Provide the Merchant Name to be shown on the LatitudePay Payment Form. 

6. Choose the desired Payment Action (Authorisation or Authorise & Capture). We recommend choosing the Authorize & Capture action.

If you choose Authorisation, then the payment is placed on hold as when the order is placed by the customer. The payment is captured via manual button to capture the payment at any point in the backend order detail page. Once the button is clicked, the amount will be captured.

If you choose Authorize & Capture, then the payment is capture automatically when the order is placed.

7. Select the Payment Type (Redirect to Gateway). 

8. Set the New Order Status as Processing



  • Save the configuration and refresh the Magento cache.

 

Make the payment by LatitudePay Asia extension in the Magento front shop

  • On the checkout page, the LatitudePay payment option will be displayed under the Payment Methods section. 



Checkout Page
Checkout Page

  • Customers can select "Pay By LatitudePay" Gateway. 



  • Clicking the "Place Order" button will redirect to the LatitudePay payment page and customer can select the plan and proceed to pay via card.

 

Select plan and proceed
Select plan and proceed




Select card and complete the payment
Select card and complete the payment




  • After a successful payment, the customer will be redirected to the success page. 
Success Page
Success Page


Installation and Activation of LatitudePay Extension from Marketplace for Existing Merchants, those who already did the manual installation from GitHub

Enabling the LatitudePay extension from marketplace for existing merchants (those who did the manual installation from GitHub) within their established Magento setup involves a systematic process.

Here are the steps mentioned below,

  • Navigate to the path 'app/code/' under the 'public_html' directory on the server.
  • Manually delete the 'Octifi' folder related to the LatitudePay extension.
  • Connect to the terminal and initiate the installation process as per the instructions provided in this documentation, starting from the initial steps.
  • Once these steps are completed, the LatitudePay extension will be successfully installed and ready for use within the existing Magento setup.

Refund and Cancellation Process  

SINGAPORE
MALAYSIA

The cancellations and refunds for Latitude Pay transactions are handled manually through the merchant console. To access the merchant console, please visit merchant.sg.latitudepay.com for SG production and merchant.latitudepay.me for staging.

For any inquiries or assistance, we encourage you to reach out to our dedicated support team. You can contact us through our website or by sending an email to [email protected]