FURTHER MARKET PAY BUTTON INTEGRATION                       

 

Further Market offers an accessible way for any developer wishing to integrate a payment button through its website.

 

How does it work?

 

The developer creates its Mobile Money account if not exist, then he creates a Further Market account (free) and receives a unique FMAccountID. He proceeds to the binding of its Mobile Money account with that of Further Market. If during the course of his services, he requests a payment by Mobile Money account on his website, the only thing to do is to follow the below instructions:

1-    Here is the template for pay button integration in a website

 

<form action="https://www.furthermarket.com/cashPayment/fmPayButon.php" method="GET" target="_blank">

         <input type="hidden" name="fmAccountID" value="5"/>

         <input type="hidden" id="amount1" name="amount" value="20000"/>

         <input type="hidden" id="curr1" name="curr" value="EUR"/>

         <input type="hidden" id="design1" name="design" value="Product 1"/>

         <input type="hidden" id="success1" name="returnSuccessLink" value="success.php?a=b&c=d"/>

         <input type="hidden" id="error1" name="returnErrorLink" value="error.php?e=f&g=h&i=j"/>

         <input type="hidden" id="desc1" name="desc" value="Lorem ipsum Lorem ipsum Lorem ipsum Lorem ipsum Lorem ipsum"/>

         <input type="submit" id="Buy1" value="Buy1" class="fm-btn"/>

</form>

 

2-    Here the descriptions for the highlighted parameter of the above template.

a-     https://www.furthermarket.com/cashPayment/fmPayButon.php

This is the link to Further Market page where the customer or buyer will proceed with the payment in your Mobile Money Account via Further Market platform.

b-    GET

Here is the request method for your data to be sent. (Other methods like “post”… should be avoided)

c-     fmAccountID

The Further Market Account Identifier is required. It is automatically generated at the creation of your Further Market Account. It is used during the payment process to identify the account which receive the payment.

d-     Amount

The cost of the product or service which correspond to the amount retrieved from the customer Mobile Money Account.

e-    Curr

The currency applied during the payment process.

f-      Design

The Designation of the product or service sold.

g-     returnSuccessLink

The link to your web page where the customer will be redirected upon successful payment.

When the customer is redirected to the above stated page, Further Market adds your Further Market Account ID and the payment ID of the transaction to the link as shown in the following: success.php?fmAccountID=5&paymentID=1025&a=b&c=d

h-      returnErrorLink

The link to your web page where the customer will be redirected upon an error on payment process.

When the customer is redirected to the above stated page, Further Market adds your Further Market Account ID and payment ID=0 to the link as shown in the following: error.php?fmAccountID=5&paymentID=0&a=b&c=d

i-       Desc

Description of your product or service. This parameter can be left empty if no description needed.

 

Requirements:

 

As said above, the developer must have:

-         Mobile Money account associated with a number

-         Further Market BusinessAccount

-         Couple your Mobile money number with your Further Market Business Account

-         Mobile Money cash collect service activated

 

Example of use

 

Here is an example of sales page with “Buy button”.

 

image

 

Here is the Further Market page which pops-up upon a click on “Buy button”.

image

1-      Seller Account information ,  2- Buyer’s phone number,   3-  Product or Service information

 

 

 

Here is the Further Market page when the transaction is in a pending state.

image

 

 

Here is the Further Market page when the transaction is successful. Customer can check the information of the transaction with his phone by dialing the given code (*141*6*paymentID#) through a mobile phone with MTN CAM subscription.

image

 

Here is the Further Market page when the transaction has failed.

image

While displaying those various messages (success or error), the customer is automatically redirected to your returnSuccessLink in case of success or to your returnErrorLink in case of error in the process.