付款请求

以下指南将解释如何在商户网站和应用程序中应用相应的源代码，以形成商户可以在重定向链接中拥有的支付请求参数，并将其发送到 PayMaster 进行二维码支付处理。

Java

第 1 步：图书馆

商户必须在商户应用程序中包含 PayMaster 商户插件 (MPI) Java 库 PayMaster.jar。

第 2 步：导入

对于二维码支付，商户应将以下内容导入到其代码中：

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

第 3 步：源代码

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

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

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

// Set parameter values into Payment Master Entity
paymentRequestEntity.set("PaymentID", "Q03");
paymentRequestEntity.set("MerchRefNo", "merchant-refNo-0001");
paymentRequestEntity.set("CurrCode", "458");
paymentRequestEntity.set("TxnAmt", "1.00");
paymentRequestEntity.set("ExpTxnAmt", "2");
paymentRequestEntity.set("TerminalID", "200039XX");
paymentRequestEntity.set("PayloadInd", "12");
paymentRequestEntity.set("PANInd", "26");
paymentRequestEntity.set("CountryCode", "MY");
paymentRequestEntity.set("TxnFlag", "CP");
paymentRequestEntity.set("SndrIDType", "2");
paymentRequestEntity.set("QRPayload", "00020201021226470014A00...");

// Generate the payment request message
PaymentRequestMessageBuilder messageBuilder = new PaymentRequestMessageBuilder();
String paymentMessage = messageBuilder.buildPaymentRequestMessage(paymentRequestEntity, propertiesReader);

// POST request to Payment Master Gateway for QR Payload
String initialUrl = "https://xxx.finexusgroup.com/upp/faces/qrPushPayment.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()));
in.close();
String finalUrl = connection.getURL().toString(); 

第 4 步：指示 PayMaster 属性文件位置

商家必须使用PropertiesReader指定 PayMaster 属性文件的位置。

第 5 步: 为付款请求实体分配值

为 PayMaster 请求实体分配值。确保包含示例代码中所示的所有字段，因为它们是强制性的。使用setter函数来赋值，该函数接受两个参数：setter(参数名，参数值)。

PayMaster商户插件（MPI）支持的字段请参考 二维码支付参数。

第 6 步： 生成付款消息

分配所有必需值后，调用PaymentRequestMessageBuilder以生成付款消息（paymentMessage）。

第 7 步：将付款消息发送至 PayMaster 网关

将 paymentMessage 发送到 PayMaster 网关以获取 QR 负载。

请参阅 二维码支付响应了解PayMaster商户插件(MPI)支持的安全控制。

.Net

第 1 步：图书馆

商户必须在商户应用程序中包含 PayMaster 商户插件 (MPI) .NET 库 PayMaster.dll。

第 2 步：命名空间

对于二维码支付，商户应在商户代码中包含以下命名空间：

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

第 3 步：源代码

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/", "QRPayment.properties");

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

// Set parameter values into Payment Master Entity
qrPaymentRequestEntity.setter("PaymentID", "Q03");
qrPaymentRequestEntity.setter("MerchRefNo", "merchant-refNo-0001");
qrPaymentRequestEntity.setter("CurrCode", "458");
qrPaymentRequestEntity.setter("TxnAmt", "1.00");
qrPaymentRequestEntity.setter("ExpTxnAmt", "2");
qrPaymentRequestEntity.setter("TerminalID", "200039XX");
qrPaymentRequestEntity.setter("PayloadInd", "12");
qrPaymentRequestEntity.setter("PANInd", "26");
qrPaymentRequestEntity.setter("CountryCode", "MY");
qrPaymentRequestEntity.setter("TxnFlag", "CP");
qrPaymentRequestEntity.setter("SndrIDType", "2");
qrPaymentRequestEntity.setter("QRPayload", "00020201021226470014A00...");

// Generate the payment request message
PaymentRequestMessageBuilder qrMessageBuilder = new PaymentRequestMessageBuilder();
string qrPaymentMessage = qrMessageBuilder.buildPaymentRequestMessage(qrPaymentRequestEntity, propertiesReader);

// POST request to Payment Master Gateway for QR Payload
string initialUrl = "https://xxx.finexusgroup.com/upp/faces/qrPushPayment.xhtml?" + qrPaymentMessage;
HttpClient httpClient = new HttpClient();
HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Post, initialUrl);
HttpResponseMessage response = await httpClient.SendAsync(request);
Uri finalUrl = response.RequestMessage.RequestUri; 

第 4 步：指示 PayMaster 属性文件位置

使用PropertiesReader指定 PayMaster 属性文件的位置。

第 5 步为付款请求实体分配值

为 PayMaster 请求实体分配值。确保包含示例代码所需的所有字段，因为它们是强制性的。使用setter函数来赋值，它接受两个参数：setter(参数名，参数值)。

PayMaster商户插件（MPI）支持的字段请参考 二维码支付参数。

第 6 步： 生成付款消息

分配所有必需值后，调用PaymentRequestMessageBuilder以生成付款消息（paymentMessage）。

第 7 步：将付款消息发送至 PayMaster 网关

将qrPaymentMessage发送到 PayMaster 网关以获取 QR 负载。

请参阅 二维码支付响应了解PayMaster商户插件(MPI)支持的安全控制。

PHP

第 1 步：图书馆

商户必须在商户应用程序中包含 PayMaster 商户插件 (MPI) PHP 库 PayMaster.phar。

第 2 步：导入

对于二维码支付，商户应将以下内容导入到其代码中：

• PropertiesReader – 读取属性文件。
• PayMasterEntity – 为 PayMaster QR 支付分配所有可接受的值。
• PaymentRequestMessageBuilder – 生成PayMaster二维码支付请求消息。

第 3 步：源代码

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

// Locate the absolute path of PayMaster.phar
$basePath = 'phar://<PayMaster.phar path>/';
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();
$propertiesReader->PropertiesReader("./PayMasterProperties/", "QRPayment.ini");

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

// Set parameter values into Payment Master Entity
$paymentRequestEntity->setter("PaymentID", "Q03");
$paymentRequestEntity->setter("MerchRefNo", "merchant-refNo-0001");
$paymentRequestEntity->setter("CurrCode", "458");
$paymentRequestEntity->setter("TxnAmt", "1.00");
$paymentRequestEntity->setter("ExpTxnAmt", "2");
$paymentRequestEntity->setter("TerminalID", "200039XX");
$paymentRequestEntity->setter("PayloadInd", "12");
$paymentRequestEntity->setter("PANInd", "26");
$paymentRequestEntity->setter("CountryCode", "MY");
$paymentRequestEntity->setter("TxnFlag", "CP");
$paymentRequestEntity->setter("SndrIDType", "2");
$paymentRequestEntity->setter("QRPayload", "00020201021226470014A00...");

// Generate the payment request message
$paymentRequestMessageBuilder = new PaymentRequestMessageBuilder();
$paymentMessage = $paymentRequestMessageBuilder->buildPaymentRequestMessage($paymentRequestEntity, $propertiesReader);

// POST request to Payment Master Gateway for QR Payload
$initialUrl = "https://xxx.finexusgroup.com/upp/faces/qrPushPayment.xhtml?" . $paymentMessage;
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $initialUrl);
curl_setopt($ch, CURLOPT_POST, 1);
$response = curl_exec($ch);
curl_close($ch);
$finalUrl = curl_getinfo($ch, CURLINFO_REDIRECT_URL);
exit();
?> 

第 4 步：找到PayMaster.phar的绝对路径

在 PHP 代码的basePath变量中指定 PayMaster.phar 的绝对路径。

例子：$basePath='phar://<absolute path of PayMaster.phar>/'

第 5 步：指示 PayMaster 属性文件位置

使用PropertiesReader指定 PayMaster 属性文件的位置。

第 6 步：为付款请求实体分配值

为 PayMaster 请求实体分配值。确保包含示例代码中所述的所有字段，因为它们是强制性的。使用setter函数来赋值，该函数接受两个参数：setter(参数名，参数值)。

PayMaster商户插件（MPI）支持的字段请参考 二维码支付参数。

第 7 步： 生成付款消息

分配所有必需值后，调用PaymentRequestMessageBuilder以生成付款消息（paymentMessage）。

第 8 步：将付款消息发送至 PayMaster 网关

将 paymentMessage 发送到 PayMaster 网关以获取 QR 负载。

请参阅 二维码支付响应了解PayMaster商户插件(MPI)支持的安全控制。

Python

第 1 步：打包

商户必须在商户应用程序中设置并包含 PayMaster 商户插件 (MPI) Python 包。

第 2 步：导入

对于二维码支付，商户应在其代码中包含以下内容：

• PropertiesReader – 读取属性文件。
• PayMasterEntity – 为 PayMaster QR 支付分配所有可接受的值。
• PaymentRequestMessageBuilder – 生成 PayMaster QR 支付请求消息。

第 3 步：源代码

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

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

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

# Set parameter values into Payment Master Entity
qrPaymentRequestEntity.setter("PaymentID", "Q03")
qrPaymentRequestEntity.setter("MerchRefNo", "merchant-refNo-0001")
qrPaymentRequestEntity.setter("CurrCode", "458")
qrPaymentRequestEntity.setter("TxnAmt", "1.00")
qrPaymentRequestEntity.setter("ExpTxnAmt", "2")
qrPaymentRequestEntity.setter("TerminalID", "200039XX")
qrPaymentRequestEntity.setter("PayloadInd", "12")
qrPaymentRequestEntity.setter("PANInd", "26")
qrPaymentRequestEntity.setter("CountryCode", "MY")
qrPaymentRequestEntity.setter("TxnFlag", "CP")
qrPaymentRequestEntity.setter("SndrIDType", "2")
qrPaymentRequestEntity.setter("QRPayload", "00020201021226470014A00...")

# Generate the payment request message
qrMessageBuilder = PaymentRequestMessageBuilder()
qrPaymentMessage = qrMessageBuilder.buildPaymentRequestMessage(qrPaymentRequestEntity, propertiesReader)

# POST request to Payment Master Gateway for QR Payload
initial_url = "https://xxx.finexusgroup.com/upp/faces/qrPushPayment.xhtml?" + qrPaymentMessage
response = requests.post(initial_url)
final_url = response.url

第 4 步：指示 PayMaster 属性文件位置

使用PropertiesReader指定 PayMaster 属性文件的位置。

第 5 步为付款请求实体分配值

为 PayMaster 请求实体分配值。确保包含示例代码中所述的所有字段，因为它们是强制性的。使用setter函数来赋值，它接受两个参数：setter(参数名，参数值)。

PayMaster商户插件（MPI）支持的字段请参考 二维码支付参数。

第 6 步： 生成付款消息

分配所有必需值后，调用PaymentRequestMessageBuilder以生成付款消息（paymentMessage）。

第 7 步：将付款消息发送至 PayMaster 网关

将qrPaymentMessage发送到 PayMaster 网关以获取 QR 负载。

请参阅 二维码支付响应了解PayMaster商户插件(MPI)支持的安全控制。

Node.js

第 1 步：图书馆

商户应设置 PayMaster 商户插件 (MPI) Node.js 库并将其包含到商户应用程序中。

第 2 步源代码

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

module.exports = function (app) {
    app.post('/QRPayment', (req, res) => {
        // Initialize PropertiesReader and set parameters
        paymaster.PropertiesReader('./properties/', 'QRPayment.properties');
        paymaster.setter('PaymentID', 'Q03');
        paymaster.setter('MerchRefNo', 'merchant-refNo-0001');
        paymaster.setter('CurrCode', '458');
        paymaster.setter('TxnAmt', '1.00');
        paymaster.setter('ExpTxnAmt', '2');
        paymaster.setter('TerminalID', '200039XX');
        paymaster.setter('PayloadInd', '12');
        paymaster.setter('PANInd', '26');
        paymaster.setter('CountryCode', 'MY');
        paymaster.setter('TxnFlag', 'CP');
        paymaster.setter('SndrIDType', '2');
        paymaster.setter('QRPayload', '00020201021226470014A00...');

        // Generate payment request message
        paymaster.MERCH_QRPaymentRequest(paymaster.PaymentRequestEntity, paymaster.propDetails, (err, response, result) => {
            if (err) {
                throw err;
            }
            if (response) {
                const initialUrl = "https://xxx.finexusgroup.com/upp/faces/qrPushPayment.xhtml?" + result;
                async function sendPostRequest() {
                    try {
                        const response = await axios.post(initialUrl);
                        const finalUrl = response.request.res.responseUrl;
                        res.json({ finalUrl });
                    } catch (error) {
                        res.status(500).send('Error sending request to PayMaster');
                    }
                }
                sendPostRequest();
            }
        });
    });
} 

第 3 步：指示 PayMaster 属性文件位置

使用PropertiesReader指定 PayMaster 属性文件的位置。

第 4 步为付款请求实体分配值

为 PayMaster 请求实体分配值。确保包含示例代码中所述的所有字段，因为它们是强制性的。使用setter函数来赋值，它接受两个参数：setter(参数名，参数值)。

PayMaster商户插件（MPI）支持的字段请参考 二维码支付参数。

第 5 步生成请求消息

使用MERCH_QRPaymentRequest()函数生成支付请求消息。

第 6 步：将付款消息发送至 PayMaster

将JavaScript返回的支付消息发送给PayMaster进行处理。

请参阅 二维码支付响应了解PayMaster商户插件(MPI)支持的安全控制。