支付请求

以下指南旨在解释如何在商户网站和应用程序中应用相应的源代码，以形成支付请求参数。商户可以将这些参数包含在重定向链接中，并发送给PayMaster进行UPP支付处理。

Java

步骤 1：库文件

商户应将PayMaster商户插件（MPI）Java库 - PayMaster.jar 包含到商户应用程序中。

步骤 2：导入

对于UPP支付，商户应在商户代码中导入以下内容：

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

步骤 3：源代码

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/","UPPPayment.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", "U01");
paymentRequestEntity("MerchRefNo", "merchant-refNo-0001");
paymentRequestEntity("CurrCode", "458");
paymentRequestEntity("TxnAmt", "1.00");
paymentRequestEntity("ExpTxnAmt", "2");
paymentRequestEntity("CountryCode", "MY");
paymentRequestEntity("TokenFlag", "N");
paymentRequestEntity("MerchUserID", "User ID");
paymentRequestEntity("PreAuthFlag", "N");

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

//Redirect the message generated to Payment Master Gateway for settlement
res.sendRedirect("https://xxx.finexusgroup.com/upp/faces/upp/payment.xhtml?" + paymentMessage);

.....

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

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

步骤 5：为支付请求实体赋值

商户需要为PayMaster请求实体分配值。商户代码必须包含示例代码中列出的所有字段，因为这些字段是强制性的。

• setter函数用于赋值，该函数接受两个参数 - setter(参数名, 参数值)。

信息

参考UPP支付参数获取PayMaster商户插件（MPI）支持的字段。

步骤 6：生成UPP支付

一旦分配了所有必填值，商户调用Payment Request Message Builder生成UPP支付 - paymentMessage。

步骤 7：发送支付消息到PayMaster网关

paymentMessage 将被发送到PayMaster网关进行UPP支付。

步骤 8 (可选)：管理您的专属支付链接

商家需要维护一个表格，该表格包括用于UPP支付的支付链接和安全支付链接，以及它们各自的状态。

Merchant's Reference No	Finexus' Payment Link	Merchant's Payment Link	Status
MRN202405260000001	https://xxx/upp/faces/upp/payment.xhtml?...	https://xxx/MRN202405260000001	Clicked
MRN202405260000002	https://xxx/upp/faces/upp/payment.xhtml?...	https://xxx/MRN202405260000002	Not Clicked

安全支付链接通过消息和社交平台（如WhatsApp、Telegram）以及电子邮件等方式分享。

信息

请参考 支付响应，了解PayMaster商户插件（MPI）支持的安全控制。

.Net

步骤 1：库文件

商户应将PayMaster商户插件（MPI）.Net库 - PayMaster.dll 包含到商户应用程序中。

步骤 2：命名空间

对于UPP支付，商户应在商户代码中使用以下命名空间：

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

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

//Get all the parameter values from the user side and set into Payment Master Entity
uppPaymentRequestEntity.setter("PaymentID", "U01");
uppPaymentRequestEntity.setter("EcommMerchInd", "2");
uppPaymentRequestEntity.setter("MerchRefNo", "merchant-refNo-0001");
uppPaymentRequestEntity.setter("CountryCode", "MY");
uppPaymentRequestEntity.setter("CurrCode", "458");
uppPaymentRequestEntity.setter("TxnAmt", "1.00");
uppPaymentRequestEntity.setter("ExpTxnAmt", "2");
uppPaymentRequestEntity.setter("TokenFlag", "N");
uppPaymentRequestEntity.setter("MerchUserID", "User ID");
uppPaymentRequestEntity.setter("PreAuthFlag", "N");

//Call Payment Master Payment Request Message Builder to generate the message
PaymentRequestMessageBuilder uppMessageBuilder = new PaymentRequestMessageBuilder();
string uppPaymentMessage = uppMessageBuilder.buildPaymentRequestMessage(uppPaymentRequestEntity, propertiesReader);

//Redirect the message generated to Payment Master Gateway for settlement
Response.Redirect("https://xxx.finexusgroup.com/upp/faces/upp/payment.xhtml?" + uppPaymentMessage);

.....

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

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

步骤 5：为支付请求实体赋值

商户必须为PayMaster请求实体分配值。商户代码必须包含示例代码中列出的所有字段，因为这些字段是强制性的。

• setter函数用于赋值，该函数接受两个参数 - setter(参数名, 参数值)。

信息

参考UPP支付参数获取PayMaster商户插件（MPI）支持的字段。

步骤 6：生成UPP支付

一旦分配了所有必填值，商户调用Payment Request Message Builder生成UPP支付 - uppPaymentMessage。

步骤 7：发送支付消息到PayMaster网关

uppPaymentMessage 将被发送到PayMaster网关进行UPP支付。

步骤 8 (可选)：管理您的专属支付链接

商家需要维护一个表格，该表格包括用于UPP支付的支付链接和安全支付链接，以及它们各自的状态。

Merchant's Reference No	Finexus' Payment Link	Merchant's Payment Link	Status
MRN202405260000001	https://xxx/upp/faces/upp/payment.xhtml?...	https://xxx/MRN202405260000001	Clicked
MRN202405260000002	https://xxx/upp/faces/upp/payment.xhtml?...	https://xxx/MRN202405260000002	Not Clicked

安全支付链接通过消息和社交平台（如WhatsApp、Telegram）以及电子邮件等方式分享。

信息

请参考 支付响应，了解PayMaster商户插件（MPI）支持的安全控制。

PHP

步骤 1：库文件

商户应将PayMaster商户插件（MPI）PHP库 - PayMaster.phar 包含到商户应用程序中。

步骤 2：导入

对于UPP支付，商户应在商户代码中导入以下内容：

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

步骤 3：源代码

<?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>,"UPPPayment.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", "U01");
$paymentRequestEntity->setter("MerchRefNo", "merchant-refNo-0001");
$paymentRequestEntity->setter("CurrCode", "458");
$paymentRequestEntity->setter("TxnAmt", "1.00");
$paymentRequestEntity->setter("ExpTxnAmt", "2");
$paymentRequestEntity->setter("EcommMerchInd", "1");
$paymentRequestEntity->setter("CountryCode", "MY");
$paymentRequestEntity->setter("TokenFlag", "N");
$paymentRequestEntity->setter("PreAuthFlag", "N");

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

//Redirect the message generated to Payment Master Gateway for settlement
header("Location:https://xxx.finexusgroup.com/upp/faces/upp/payment.xhtml?" . $paymentMessage);
exit();

.....

步骤 4：定位 PayMaster.phar 的绝对路径

商户需在商户源代码中将 PayMaster.phar 的绝对路径作为 basePath（示例中的第7行）。

示例：$basePath='phar://<PayMaster.phar 的绝对路径>/'

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

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

步骤 6：为支付请求实体赋值

商户必须为PayMaster请求实体分配值。商户代码必须包含示例代码中列出的所有字段，因为这些字段是强制性的。

• setter函数用于赋值，该函数接受两个参数 - setter(参数名, 参数值)。

信息

参考UPP支付参数获取PayMaster商户插件（MPI）支持的字段。

步骤 7：生成UPP支付

一旦分配了所有必填值，商户调用Payment Request Message Builder生成UPP支付 - paymentMessage。

步骤 8：发送支付消息到PayMaster网关

paymentMessage 将被发送到PayMaster网关进行UPP支付。

步骤 9 (可选)：管理您的专属支付链接

商家需要维护一个表格，该表格包括用于UPP支付的支付链接和安全支付链接，以及它们各自的状态。

Merchant's Reference No	Finexus' Payment Link	Merchant's Payment Link	Status
MRN202405260000001	https://xxx/upp/faces/upp/payment.xhtml?...	https://xxx/MRN202405260000001	Clicked
MRN202405260000002	https://xxx/upp/faces/upp/payment.xhtml?...	https://xxx/MRN202405260000002	Not Clicked

安全支付链接通过消息和社交平台（如WhatsApp、Telegram）以及电子邮件等方式分享。

信息

请参考 支付响应，了解PayMaster商户插件（MPI）支持的安全控制。

Python

步骤 1：包

商户应设置并包含PayMaster商户插件（MPI）Python包到商户应用程序中。

步骤 2：导入

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

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

步骤 3：源代码

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("UPPPayment.properties","PayMasterProperties/")

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

##Get all the parameter values from the user side and set into Payment Master Entity
uppPaymentRequestEntity.setter("PaymentID", "U01")
uppPaymentRequestEntity.setter("EcommMerchInd", "2")
uppPaymentRequestEntity.setter("MerchRefNo", "merchant-refNo-0001")
uppPaymentRequestEntity.setter("CountryCode", "MY")
uppPaymentRequestEntity.setter("CurrCode", "458")
uppPaymentRequestEntity.setter("TxnAmt", "1.00")
uppPaymentRequestEntity.setter("ExpTxnAmt", "2")
uppPaymentRequestEntity.setter("TokenFlag", "N")
uppPaymentRequestEntity.setter("MerchUserID", "User ID")
uppPaymentRequestEntity.setter("PreAuthFlag", "N")

##Call Payment Master Payment Request Message Builder to generate the message
uppMessageBuilder = PaymentRequestMessageBuilder()
uppPaymentMessage = uppMessageBuilder.buildPaymentRequestMessage(uppPaymentRequestEntity, propertiesReader)

redirect("https://xxx.finexusgroup.com/upp/faces/upp/payment.xhtml?" + uppPaymentMessage) 

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

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

步骤 5：为支付请求实体赋值

商户必须为PayMaster请求实体分配值。商户代码必须包含示例代码中列出的所有字段，因为这些字段是强制性的。

• setter函数用于赋值，该函数接受两个参数 - setter(参数名, 参数值)。

信息

参考UPP支付参数获取PayMaster商户插件（MPI）支持的字段。

步骤 6：生成UPP支付

一旦分配了所有必填值，商户调用Payment Request Message Builder生成UPP支付 - uppPaymentMessage。

步骤 7：发送支付消息到PayMaster网关

uppPaymentMessage 将被发送到PayMaster网关进行UPP支付。

步骤 8 (可选)：管理您的专属支付链接

商家需要维护一个表格，该表格包括用于UPP支付的支付链接和安全支付链接，以及它们各自的状态。

Merchant's Reference No	Finexus' Payment Link	Merchant's Payment Link	Status
MRN202405260000001	https://xxx/upp/faces/upp/payment.xhtml?...	https://xxx/MRN202405260000001	Clicked
MRN202405260000002	https://xxx/upp/faces/upp/payment.xhtml?...	https://xxx/MRN202405260000002	Not Clicked

安全支付链接通过消息和社交平台（如WhatsApp、Telegram）以及电子邮件等方式分享。

信息

请参考 支付响应，了解PayMaster商户插件（MPI）支持的安全控制。

Node.js

步骤 1：库文件

商户应设置并包含PayMaster商户插件（MPI）NodeJS库到商户应用程序中。

步骤 2：源代码

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

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

        .....

        paymaster.PropertiesReader('./properties/','UPPPayment.properties');
        paymaster.setter('PaymentID', 'U01');
        paymaster.setter('EcommMerchInd', '2');
        paymaster.setter('MerchRefNo', 'merchant-refNo-0001');
        paymaster.setter('CountryCode', 'MY');
        paymaster.setter('CurrCode', '458');
        paymaster.setter('ExpTxnAmt', '2');
        paymaster.setter('TxnAmt', '1.00');
        paymaster.setter('TokenFlag', 'N');
        paymaster.setter('MerchUserID', 'UserName');
        paymaster.setter('PreAuthFlag', 'N');

        payment.MERCH_UPPPaymentRequest(paymaster.PaymentRequestEntity, paymaster.propDetails, function(err, response, result){
            if(err){
                throw err;
            }
            if(response){
               res.redirect("https://xxx.finexusgroup.com/upp/faces/upp/payment.xhtml?" + result);
            }
        });
    });
}

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

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

步骤 4：为支付请求实体赋值

商户必须为PayMaster请求实体分配值。商户代码必须包含示例代码中列出的所有字段，因为这些字段是强制性的。

• setter函数用于赋值，该函数接受两个参数 - setter(参数名, 参数值)。

信息

参考UPP支付参数获取PayMaster商户插件（MPI）支持的字段。

步骤 5：生成请求消息

MERCH_UPPPaymentRequest() 函数用于生成支付请求消息。

步骤 6：发送支付消息到PayMaster

JavaScript返回的支付消息将被发送到PayMaster进行UPP支付。

步骤 7 (可选)：管理您的专属支付链接

商家需要维护一个表格，该表格包括用于UPP支付的支付链接和安全支付链接，以及它们各自的状态。

Merchant's Reference No	Finexus' Payment Link	Merchant's Payment Link	Status
MRN202405260000001	https://xxx/upp/faces/upp/payment.xhtml?...	https://xxx/MRN202405260000001	Clicked
MRN202405260000002	https://xxx/upp/faces/upp/payment.xhtml?...	https://xxx/MRN202405260000002	Not Clicked

安全支付链接通过消息和社交平台（如WhatsApp、Telegram）以及电子邮件等方式分享。

信息

请参考 支付响应，了解PayMaster商户插件（MPI）支持的安全控制。