(MoMo)Mobile Money Payment Integration

16. syyskuuta 2024


This plugin is a unidirectional Payment Integration for External Payment Provider MoMo (Mobile Money). 
POS triggers the redirection to the EPP (External Payment Provider), but does not await for the payment to be collected. Once EPP collects the Payment, it saves the Payment information to Erply Back Office (BO). 
After the Payment has been saved to BO, POS would show the Order status as Paid.

Note: POS expects that the user is already authenticated to EPP. POS does not handle user authentication.

Step1. Create payment type in Back Office

Navigate to the Back Office -> Settings -> Configuration.
From left sid panel search for “Payment types”
Click on the “new +” in the upper right corner.
Fill all the fields:

  • Name (name of custom payment type)(our example MOMO)
  • Name on the receipt
  • Tick the checkbox for the “Create as a custom payment type” and enter system code into the appeared field

Click Save.
New custom payment type for Mobile Money payment integration is created.

Step 2. Configure in the POS

Navigate to the Settings -> Plugins -> Search “Mobile money Payment Integration” -> Configure Plugin.

  1. Select the payment type or create new. If you have an existing Custom Payment type configured in the Back Office you should be able to see a dropdown with existing ones. You can select from the dropdown if any of them can be used. In order to create a new, typy a name into the ‘New Custom Payment Name’ field. Click ‘generate’ and system will create a new custom payment type. This payment type will appear in the dropdown list in option 1.). 
  2. Enter Custom Payment domain. For example, ‘google pay’ then it should be google.com
  3. Save configuration.

Now you should see the Status “Ready” and you should be able to Enable it.

 

How enabled plugin works?

Create an odrer

Start a new sale in the POS.
Add any products and click “Save as Order” POS grid button.
In the payment window you will see the new custom payment button(our example “MOMO”):

 

Add the Payments tenders for the sale, by selecting the Custom Payment Type (our example “MOMO”) and adding an amount to cover the balance of the sale.
Press the Green Checkmark (F8 on the keyboard) button in the bottom right.

POS will open the desired External Payment Processor page in a new tab. POS will add the OrderID and employeeID via query parameters (requested by EPP) in the URL.

Follow the steps provided by the Eternal Payment Processor.
The External Payment Processor would collect the required Payment and save it in Erply's Back Office System.

Pick up an order

When the customer comes to the store to collect their Order, the Order should have already been paid and this should be reflected in the Order's information.

Pick the Order.
Proceed to Payments by pressing Pay button.
The balance should be covered.
Press the Green Checkbox button (F8) in the bottom right corner.
The sale is finalised.