Magento 2

The integration of Interest Free shopping for Magento 2 is done via a composer module.

Setup Pre-requisite Requirements

Merchants using Magento 2 will need credentials which are required for configuration:

Magento Merchant ID	Authorised Magento 2 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 Magento 2 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 Magento 2 module

1. On terminal, Navigate to Magento Directory and use composer to install latitude-financial/checkout module

composer require latitude-financial/checkout

2. Complete installation by enabling module and a series of commands to compile code and flush cache.

php bin/magento setup:upgrade

php bin/magento setup:di:compile

php bin/magento setup:static-content:deploy

3. To Activate, navigate to Stores > Configuration > Sales > Payment methods and select Latitude to view or edit all settings

• Payment settings (mandatory)

Settings	Description.
Is Active	Activates the gateway on the store (Yes/No).
MerchantID	If activated, need to enter the credentials sent by LFS.
Secret Key	If activated, need to enter the credentials sent by LFS.
Is Test Mode	For Development/Sandbox/Test, use the TEST credentials and set Test Mode YES. For Production, use the PRODUCTION credentials and set Test Mode NO.

Magento 2 Widget Configuration

• Advanced settings to edit the widget settings (Optional): Use the Widget Playground to sample the layout options

{

"productWidget": {

"layout": "standard",

"promotionMonths": 12

}

}

4. Click Save Config.

5. Open Magento Admin portal. Navigate to System > Cache Management

6. Click on ‘Flush Magento Cache” to clear cache. Latitude Checkout is now available to be used on the merchant’s store.

7. Please check that the Latitude widgets are showing on your product pages.

---

The Customer’s Experience

1. Customer views listing on merchant’s website, adds item(s) to cart and proceeds to checkout page. On checkout page, the customer selects Latitude Interest Free or Gem Interest Free and clicks on “Complete Order”

2. Magento Plug-in would then initiate offsite checkout and redirect Customer to Latitude Checkout. Our plugin initiates request by sending a POST request to [Checkout Service] /purchase endpoint

3. Latitude Checkout shows promotions and loads payment page. Customer then selects from a list of valid promotions (6 months or 12 months etc.) and enters their card details.

4. Latitude Checkout processes payment and notifies Magento Plug-in as an async callback. This step converts a quote to order in Magento.

5. Latitude Checkout redirects the Customer back to Magento. Magento Plug-in handles the redirect and shows order confirmation.

Maintain Magento 2 Order

Capture

COMING SOON

Void

COMING SOON

Refund

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

This feature is only applicable for Instant Settlement Merchants.

It is highly recommended to choose one platform to process refunds. If the Magento2 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.

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. Select Sales > Orders > look for the order to refund > select View
3. In the menu ORDER VIEW, select Invoices > select View (using the ‘Invoices’ menu will create an online refund)
4. Select Credit Memo from the menu at the top of the page

5. To perform a full refund, no need to adjust the Qty or Totals
6. Add a reason to the Credit Memo Comments box (optional)
7. Select Refund from the bottom right hand corner
8. You will receive confirmation “You created the credit memo”
9. Verify that the refund was successful by checking the Item Status, notes under the Comments, and Total Refunded amount

10. In the menu ORDER VIEW > select Transactions > select the Transaction ID to view the details of the response from the payment gateway. Note that the gatewayReference and transactionReference have been joined to create the Refund’s Transaction ID

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 to the Credit Memo Comments box (optional)
4. Select Refund from the bottom right hand corner
5. You will receive confirmation “You created the credit memo”
6. Verify that the refund was successful by checking the Item Status, notes under the Comments, and Total Refunded amount

7. In the menu ORDER VIEW > select Transactions > select the Transaction ID to view the details of the response from the payment gateway. Note that the gatewayReference and transactionReference have been joined to create the Refund’s Transaction ID

---