Payment Request

After retrieving the bank list via Bank Listing, use the returned FICode and AcqBank values in the Payment request to process the payment.

Java

Step 1 : Library

The merchant must include the PayMaster Merchant Plug-In (MPI) Java library, PayMaster.jar, in the merchant application.

Step 2 : Import

For Payment, the merchant should import the following into their code:

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

Step 3 : Source Code

import com.PayMaster.Entities.PayMasterEntity;
import com.PayMaster.MessageRequestBuilder.PaymentRequestMessageBuilder;
import com.PayMaster.MessageResponseBuilder.PaymentResponseMessageBuilder;
import com.PayMaster.PropertiesReader.PropertiesReader;

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

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

// Get all the parameter values from the user side and set into PayMaster Entity
paymentRequestEntity.setter("MerchantID", "000010000099939");
paymentRequestEntity.setter("MerchRefNo", "MYB2023030315435025LL");
paymentRequestEntity.setter("PaymentID", "D01");
paymentRequestEntity.setter("TxnAmt", "1.00");
paymentRequestEntity.setter("ExpTxnAmt", "2");
paymentRequestEntity.setter("CurrCode", "458");
paymentRequestEntity.setter("CountryCode", "MY");
paymentRequestEntity.setter("EcommMerchInd", "2");
paymentRequestEntity.setter("TerminalID", "10002303");

// Get the FICode and AcqBank from the BankListing
paymentRequestEntity.setter("FICode", "RPP");
paymentRequestEntity.setter("AcqBank", "FNXSMYNB");

// Call PaymentRequestMessageBuilder to generate the message
PaymentRequestMessageBuilder messageBuilder = new PaymentRequestMessageBuilder();
String paymentMessage = messageBuilder.buildPaymentRequestMessage(paymentRequestEntity, propertiesReader);

// Redirect the message generated for settlement
response.sendRedirect(<Your_Payment_Screen_URL> + paymentMessage);

Step 4 : Indicate PayMaster Properties File Location

The merchant must specify the location of the PayMaster Properties File using PropertiesReader.

Step 5 : Assign Values to the Payment Request Entity

The merchant must assign values to the PayMaster Request Entity using the setter function: setter(parameter name, parameter value).

Obtain FICode and AcqBank from the Bank Listing response. Refer to Payment Parameters for the fields supported by the PayMaster Merchant Plug-In (MPI).

Step 6 : Generate the Payment Message

Once all mandatory values are assigned, call the PaymentRequestMessageBuilder to generate the Payment message (paymentMessage).

Step 7 : Send the Payment Message to the PayMaster Gateway

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

Refer to Payment Response for security controls supported by PayMaster Merchant Plug-In (MPI).

.Net

Step 3 : Source Code

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

PropertiesReader propertiesReader = new PropertiesReader("./PayMasterProperties/", "DDPayment.properties");
PayMasterEntity paymentRequestEntity = new PayMasterEntity();

paymentRequestEntity.Setter("MerchantID", "000010000099939");
paymentRequestEntity.Setter("MerchRefNo", "MYB2023030315435025LL");
paymentRequestEntity.Setter("PaymentID", "D01");
paymentRequestEntity.Setter("TxnAmt", "1.00");
paymentRequestEntity.Setter("ExpTxnAmt", "2");
paymentRequestEntity.Setter("CurrCode", "458");
paymentRequestEntity.Setter("CountryCode", "MY");
paymentRequestEntity.Setter("EcommMerchInd", "2");
paymentRequestEntity.Setter("TerminalID", "10002303");
paymentRequestEntity.Setter("FICode", "RPP");
paymentRequestEntity.Setter("AcqBank", "FNXSMYNB");

PaymentRequestMessageBuilder messageBuilder = new PaymentRequestMessageBuilder();
string paymentMessage = messageBuilder.BuildPaymentRequestMessage(paymentRequestEntity, propertiesReader);

Response.Redirect(<Your_Payment_Screen_URL> + paymentMessage);

Refer to Payment Parameters and Payment Response.

PHP

Step 3 : Source Code

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

$propertiesReader = new PropertiesReader();
$propertiesReader->PropertiesReader('<absolute path>', 'DDPayment.ini');

$paymentRequestEntity = new PayMasterEntity();
$paymentRequestEntity->setter('MerchantID', '000010000099939');
$paymentRequestEntity->setter('MerchRefNo', 'MYB2023030315435025LL');
$paymentRequestEntity->setter('PaymentID', 'D01');
$paymentRequestEntity->setter('TxnAmt', '1.00');
$paymentRequestEntity->setter('ExpTxnAmt', '2');
$paymentRequestEntity->setter('CurrCode', '458');
$paymentRequestEntity->setter('CountryCode', 'MY');
$paymentRequestEntity->setter('EcommMerchInd', '2');
$paymentRequestEntity->setter('TerminalID', '10002303');
$paymentRequestEntity->setter('FICode', 'RPP');
$paymentRequestEntity->setter('AcqBank', 'FNXSMYNB');

$paymentRequestMessageBuilder = new PaymentRequestMessageBuilder();
$paymentMessage = $paymentRequestMessageBuilder->buildPaymentRequestMessage($paymentRequestEntity, $propertiesReader);

header('Location: ' . <Your_Payment_Screen_URL> . $paymentMessage);
exit();
?>

Refer to Payment Parameters and Payment Response.

Python

Step 3 : Source Code

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

propertiesReader = PropertiesReader("PayMasterProperties/", "DDPayment.properties")
paymentRequestEntity = PayMasterEntity()

paymentRequestEntity.setter("MerchantID", "000010000099939")
paymentRequestEntity.setter("MerchRefNo", "MYB2023030315435025LL")
paymentRequestEntity.setter("PaymentID", "D01")
paymentRequestEntity.setter("TxnAmt", "1.00")
paymentRequestEntity.setter("ExpTxnAmt", "2")
paymentRequestEntity.setter("CurrCode", "458")
paymentRequestEntity.setter("CountryCode", "MY")
paymentRequestEntity.setter("EcommMerchInd", "2")
paymentRequestEntity.setter("TerminalID", "10002303")
paymentRequestEntity.setter("FICode", "RPP")
paymentRequestEntity.setter("AcqBank", "FNXSMYNB")

messageBuilder = PaymentRequestMessageBuilder()
paymentMessage = messageBuilder.buildPaymentRequestMessage(paymentRequestEntity, propertiesReader)

redirect(<Your_Payment_Screen_URL> + paymentMessage)

Refer to Payment Parameters and Payment Response.

Node.js

Step 3 : Source Code

module.exports = function (app) {
    app.post('/DDPayment', (req, res) => {
        const paymaster = require('./js/PayMaster.min.js');
        paymaster.PropertiesReader('./properties/', 'DDPayment.properties');

        paymaster.setter('MerchantID', '000010000099939');
        paymaster.setter('MerchRefNo', 'MYB2023030315435025LL');
        paymaster.setter('PaymentID', 'D01');
        paymaster.setter('TxnAmt', '1.00');
        paymaster.setter('ExpTxnAmt', '2');
        paymaster.setter('CurrCode', '458');
        paymaster.setter('CountryCode', 'MY');
        paymaster.setter('EcommMerchInd', '2');
        paymaster.setter('TerminalID', '10002303');
        paymaster.setter('FICode', 'RPP');
        paymaster.setter('AcqBank', 'FNXSMYNB');

        paymaster.MERCH_CardPaymentRequest(paymaster.PaymentRequestEntity, paymaster.propDetails, function(err, response, result) {
            if (response) {
                res.redirect(<Your_Payment_Screen_URL> + result);
            }
        });
    });
}

Refer to Payment Parameters and Payment Response.