Bank Listing Request

This is a guideline on how to apply the source codes in Merchant's site to retrieve the Bank Listing to form the payment request parameters which will be sent to PayMaster for Bank Listing processing.

Java

Step 1 : Library

Merchant shall include PayMaster Merchant Plug-In (MPI) Java library – PayMaster.jar into merchant application.

Step 2 : Import

Merchant shall import below into merchant code:

• com.PayMaster.Entities.PayMasterEntity
• com.PayMaster.PropertiesReader.PropertiesReader
• com.PayMaster.MessageRequestBuilder.PaymentRequestMessageBuilder

Step 3 : Source Code

info

Merchant is required to put the Bank Listing in the AcqBank field in Payment Request.

import com.PayMaster.Entities.PayMasterEntity;
import com.PayMaster.PropertiesReader.PropertiseReader;
import com.PayMaster.MessageRequestBuilder.PaymentRequestMessageBuilder;

.....

//Declare variable for Payment Master Properties - 1st Parameter = File Path , 2nd Parameter = File name
PropertiesReader propertiesReader = new PropertiesReader("./PayMasterProperties/","BankListing.properties");

//Declare variable for Payment Master Entity
PayMasterEntity paymentRequestEntity = new PayMasterEntity();

//Get all the parameter values from the user side and set into Payment Master Entity
paymentRequestEntity("PaymentID", "B01");
paymentRequestEntity("CurrCode", "458");
paymentRequestEntity("CountryCode", "MY");
paymentRequestEntity("FICode", "RPP");

//Call Payment Master Payment Request Message Builder to generate the message
PaymentRequestMessageBuilder messageBuilder = new PaymentRequestMessageBuilder();
string paymentMessage = messageBuilder.buildPaymentRequestMessage(paymentRequestEntity, propertiesReader);

//POST request to Payment Master Gateway for bank listing
String initialUrl = "https://xxx.finexusgroup.com/upp/faces/banklisting.xhtml?" + paymentMessage;
HttpURLConnection connection = null;
URL url = new URL(initialUrl);
connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("POST");
BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
String inputLine;
StringBuilder response = new StringBuilder();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
.....

Step 4 : Indicate PayMaster Properties File location

Merchant must indicate where the PayMaster Properties File is located using PropertiesReader.

Step 5 : Assign value into Payment Request Entity

Merchant to assign value into PayMaster Request Entity. Merchant code must include all the fields as stated in sample code as it’s mandatory.

• The setter function is used to assign value and the function accepts two parameters: setter(parameter name, parameter value).

info

Refer to Bank Listing Parameters for fields supported by PayMaster Merchant Plug-In (MPI).

Step 6 : Generate Bank Listing

Once all the mandatory values are assigned, merchant to call Payment Request Message Builder to generat the Bank Listing – paymentMessage.

Step 7 : Send payment message to PayMaster Gateway

The paymentMessage will be sent to PayMaster Gateway for the Bank Listing.

.Net

Step 1 : Library

Merchant shall include PayMaster Merchant Plug-In (MPI) .Net library – PayMaster.dll into merchant application.

Step 2 : Namespace

Merchant shall use the namespace below in the merchant code:

• using com.PayMaster.Entities
• using com.PayMaster.Properties
• using com.PayMaster.MessageRequestBuilder

Step 3 : Source Code

info

Merchant is required to put the Bank Listing in the AcqBank field in Payment Request.

using com.PayMaster.Entities;
using com.PayMaster.Properties;
using com.PayMaster.MessageRequestBuilder;

.....

//Declare variable for Payment Master Properties - 1st Parameter = File Path , 2nd Parameter = File name
PropertiesReader propertiesReader = new PropertiesReader("./PayMasterProperties/","BankListing.properties");

//Declare variable for Payment Master Entity
PayMasterEntity paymentRequestEntity = new PayMasterEntity();

//Get all the parameter values from the user side and set into Payment Master Entity
paymentRequestEntity.setter("PaymentID", "B01");
paymentRequestEntity.setter("CountryCode", "MY");
paymentRequestEntity.setter("CurrCode", "458");
paymentRequestEntity.setter("FICode", "RPP");

//Call Payment Master Payment Request Message Builder to generate the message
PaymentRequestMessageBuilder messageBuilder = new PaymentRequestMessageBuilder();
string paymentMessage = messageBuilder.buildPaymentRequestMessage(paymentRequestEntity, propertiesReader);

//POST request to Payment Master Gateway for bank listing
string initialUrl  = "https://xxx.finexusgroup.com/upp/faces/banklisting.xhtml?" + paymentMessage;
HttpClient httpClient = new HttpClient();
HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Post, initialUrl );
HttpResponseMessage response = await httpClient.SendAsync(request);
.....

Step 4 : Indicate PayMaster Properties File location

The merchant must indicate where the PayMaster Properties File is located using the PropertiesReader.

Step 5 : Assign value into Payment Request Entity

The merchant has to assign value into the PayMaster Request Entity. Merchant code must include all the fields as stated in sample code as it’s mandatory.

• The setter function is used to assign value and the function accepts two parameters – setter(parameter name, parameter value).

info

Refer to Bank Listing Parameters for fields supported by PayMaster Merchant Plug-In (MPI).

Step 6 : Generate Bank Listing

Once all the mandatory values are assigned, merchant to call Payment Request Message Builder to generate the Bank Listing – paymentMessage.

Step 7 : Send payment message to PayMaster Gateway

The paymentMessage will be sent to PayMaster Gateway for the Bank Listing.

PHP

Step 1 : Library

Merchant shall include PayMaster Merchant Plug-In (MPI) PHP library – PayMaster.phar into merchant application.

Step 2 : Import

Merchant shall import below into merchant code:

• PropertiesReader - to read the properties files.
• PayMasterEntity – to assign all the acceptable values for PayMaster UPP payment.
• PaymentRequestMessageBuilder – to generate PayMaster UPP payment request message.

Step 3 : Source Code

info

Merchant is required to put the Bank Listing in the AcqBank field in Payment Request.

<?php
use com\PayMaster\Entities\PayMasterEntity;
use com\PayMaster\PropertiesReader\PropertiesReader;
use com\PayMaster\MessageRequestBuilder\PaymentRequestMessageBuilder;
use com\PayMaster\Import\ImportFile;

//Merchant to locate the absolute path of PayMaster.phar
$basePath = 'phar://<absolute path of PayMaster.phar>/';
include_once = $basePath.'com/PayMaster/Import/ImportFile.php';
$import = new ImportFile();
$import->includeFile($basePath);
.....

//Declare variable for Payment Master Properties - 1st Parameter = File Path , 2nd Parameter = File name
$propertiesReader = new PropertiesReader();

//Path to the root project folder
$propertiesReader->PropertiesReader(<absolute path>,"BankListing.ini");

//Declare variable for Payment Master Entity
$paymentRequestEntity = new PayMasterEntity();

//Get all the parameter values from the user side and set into Payment Master Entity
$paymentRequestEntity->setter("PaymentID", "B01");
$paymentRequestEntity->setter("CurrCode", "458");
$paymentRequestEntity->setter("CountryCode", "MY");
$paymentRequestEntity->setter("FICode", "RPP");

//Call Payment Master Payment Request Message Builder to generate the message
$paymentRequestMessageBuilder = new PaymentRequestMessageBuilder();
$paymentMessage = $paymentRequestMessageBuilder->buildPaymentRequestMessage($paymentRequestEntity, $propertiesReader);

//POST request to Payment Master Gateway for bank listing
$initialUrl = "https://xxx.finexusgroup.com/upp/faces/banklisting.xhtml?" . $paymentMessage;
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $initialUrl);
curl_setopt($ch, CURLOPT_POST, 1);
$response = curl_exec($ch);
curl_close($ch);
exit();
.....

Step 4 : Locate absolute path of PayMaster.phar

Merchant to locate the absolute path of PayMaster.phar as the basePath in Merchant source code (line 7 in the example above).

Example:$basePath='phar://<absolute path of PayMaster.phar>/'

Step 5 : Indicate PayMaster Properties File location

The merchant must indicate where the PayMaster Properties File is located using the PropertiesReader.

Step 6 : Assign value into Payment Request Entity

The merchant has to assign value into the PayMaster Request Entity. Merchant's code must include all the fields as stated in sample code as it’s mandatory.

• The setter function is used to assign value and the function accepts two parameters – setter(parameter name, parameter value).

info

Refer to Bank Listing Parameters for fields supported by PayMaster Merchant Plug-In (MPI).

Step 7 : Generate Payment

Once all the mandatory values are assigned, merchant to call Payment Request Message Builder to generate the Payment – paymentMessage.

Step 8 : Send payment message to PayMaster Gateway

The paymentMessage will be sent to PayMaster Gateway for the Bank Listing.

Python

Step 1 : Packages

Merchant shall setup and include PayMaster Merchant Plug-In (MPI) Python packages into merchant application.

Step 2 : Import

For UPP payment, merchant shall include below into merchant code:

• PropertiesReader – to read the properties files.
• PayMasterEntity – to assign all the acceptable values for PayMaster UPP payment.
• PaymentRequestMessageBuilder - to generate PayMaster UPP payment request message.

Step 3 : Source Code

info

Merchant is required to put the Bank Listing in the AcqBank field in Payment Request.

from com.PayMaster.Entities.PayMasterEntity import PayMasterEntity
from com.PayMaster.PropertiesReader.PropertiseReader import PropertiseReader
from com.PayMaster.MessageRequestBuilder.PaymentRequestMessageBuilder import PaymentRequestMessageBuilder

##Declare variable for Payment Master Properties - 1st Parameter = File Path , 2nd Parameter = File name
PropertiesReader propertiesReader = new PropertiesReader("BankListing.properties","PayMasterProperties/")

##Declare variable for Payment Master Entity
paymentRequestEntity = PayMasterEntity()

##Get all the parameter values from the user side and set into Payment Master Entity
paymentRequestEntity.setter("PaymentID", "B01")
paymentRequestEntity.setter("CountryCode", "MY")
paymentRequestEntity.setter("CurrCode", "458")
paymentRequestEntity.setter("FICode", "RPP")

##Call Payment Master Payment Request Message Builder to generate the message
messageBuilder = PaymentRequestMessageBuilder()
paymentMessage = messageBuilder.buildPaymentRequestMessage(paymentRequestEntity, propertiesReader)

##POST request to Payment Master Gateway for bank listing
initial_url = "https://xxx.finexusgroup.com/upp/faces/banklisting.xhtml?" + paymentMessage
response = requests.post(initial_url)
.....

Step 4 : Indicate PayMaster Properties File location

The merchant must indicate where the PayMaster Properties File is located using the PropertiesReader.

Step 5 : Assign value into Payment Request Entity

The merchant has to assign value into the PayMaster Request Entity. Merchant code must include all the fields as stated in sample code as it’s mandatory.

• The setter function is used to assign value and the function accepts two parameters – setter(parameter name, parameter value).

info

Refer to Bank Listing Parameters for fields supported by PayMaster Merchant Plug-In (MPI).

Step 6 : Generate Bank Listing

Once all the mandatory values are assigned, merchant call to Payment Request Message Builder to generate the Bank Listing – paymentMessage.

Step 7 : Send payment message to PayMaster Gateway

The paymentMessage will be sent to PayMaster Gateway for the Payment.

Node.js

Step 1 : Library

Merchant shall setup and include PayMaster Merchant Plug-In (MPI) Node.js library into merchant application.

Step 2 : Source Code

info

Merchant is required to put the Bank Listing in the AcqBank field in Payment Request.

var paymaster = require('./js/PayMaster.min.js');

module.exports = function (app) {
    app.post('/UPPPayment', (req, res)=>{

        .....

        paymaster.PropertiesReader('./properties/','BankListing.properties');
        paymaster.setter('PaymentID', 'B01');
        paymaster.setter('CountryCode', 'MY');
        paymaster.setter('FICode', 'RPP');

        payment.MERCH_BankListingRequest(paymaster.PaymentRequestEntity, paymaster.propDetails, function(err, response, result){
            if(err){
                throw err;
            }
            if(response){
                const initialUrl = "https://xxx.finexusgroup.com/upp/faces/banklisting.xhtml?" + result;
                async function sendPostRequest() {
                    const response = await axios.post(initialUrl);
                    .....
                }
                sendPostRequest();
            }
        });
    });
}

Step 3 : Indicate PayMaster Properties File location

The merchant must indicate where the PayMaster Properties File is located using the PropertiesReader.

Step 4 : Assign value into Payment Request Entity

The merchant has to assign value into the PayMaster Request Entity. Merchant code must include all the fields as stated in sample code as it’s mandatory.

• The setter function is used to assign value and the function accepts two parameters – setter(parameter name, parameter value).

info

Refer to Bank Listing Parameters for fields supported by PayMaster Merchant Plug-In (MPI).

Step 5 : Generate request message

MERCH_BankListingRequest() function to generate the payment request message.

Step 6 : Send payment message to PayMaster

The payment message returned by the JavaScript will be sent to PayMaster for the Bank Listing.