支付请求
以下是指南,说明如何使用相应的源代码创建重定向链接中的强制性支付请求参数,并将其发送到 PayMaster 进行支付请求处理。
- Java
- .Net
- PHP
- Python
- Node.js
步骤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.setter("CountryCode", "MY");
paymentRequestEntity.setter("MerchUserID", "guest-finexus");
paymentRequestEntity.setter("TokenFlag", "Y");
paymentRequestEntity.setter("PreAuthFlag", "Y");
//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(参数名, 参数值)
。
参考预授权支付参数,以了解PayMaster商家插件(MPI)支持的字段。
步骤6:生成UPP支付
一旦分配了所有必需的值,商家调用支付请求消息生成器来生成UPP支付 - paymentMessage
。
步骤7:发送支付消息至PayMaster网关
paymentMessage
将被用于发送至PayMaster网关进行UPP支付。
请参考 预授权支付响应,了解PayMaster商户插件(MPI)支持的安全控制。
步骤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", "Y");
uppPaymentRequestEntity.setter("MerchUserID", "User ID");
uppPaymentRequestEntity.setter("PreAuthFlag", "Y");
//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(参数名, 参数值)
。
请参考预授权支付参数,了解PayMaster商家插件(MPI)支持的字段。
步骤6:生成UPP支付
一旦分配了所有必需的值,商家调用支付请求消息生成器来生成UPP支付 - uppPaymentMessage
。
步骤7:发送支付消息至PayMaster网关
uppPaymentMessage
将被用于发送至PayMaster网关进行UPP支付。
请参考 预授权支付响应,了解PayMaster商户插件(MPI)支持的安全控制。
步骤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", "Y");
$paymentRequestEntity->setter("PreAuthFlag", "Y");
$paymentRequestEntity->setter("MerchUserID", "User ID");
//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(参数名, 参数值)
。
请参考预授权支付参数,了解PayMaster商家插件(MPI)支持的字段。
步骤7:生成UPP支付
一旦分配了所有必需的值,商家调用支付请求消息生成器来生成UPP支付 - paymentMessage
。
步骤8:发送支付消息至PayMaster网关
paymentMessage
将被用于发送至PayMaster网关进行UPP支付。
请参考 预授权支付响应,了解PayMaster商户插件(MPI)支持的安全控制。
步骤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", "Y")
uppPaymentRequestEntity.setter("MerchUserID", "User ID")
uppPaymentRequestEntity.setter("PreAuthFlag", "Y")
##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(参数名, 参数值)
。
请参考预授权支付参数,了解PayMaster商家插件(MPI)支持的字段。
步骤6:生成UPP支付
一旦分配了所有必需的值,商家调用支付请求消息生成器来生成UPP支付 - uppPaymentMessage
。
步骤7:发送支付消息至PayMaster网关
uppPaymentMessage
将被用于发送至PayMaster网关进行UPP支付。
请参考 预授权支付响应,了解PayMaster商户插件(MPI)支持的安全控制。
步骤1:库
商家应该设置并将PayMaster商家插件(MPI)Node.js库包含到商家的应用程序中。
步骤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', 'Y');
paymaster.setter('MerchUserID', 'UserName');
paymaster.setter('PreAuthFlag', 'Y');
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(参数名, 参数值)
。
请参考预授权支付参数,了解PayMaster商家插件(MPI)支持的字段。
步骤5:生成请求消息
使用 MERCH_UPPPaymentRequest()
函数生成支付请求消息。
步骤6:发送支付消息至PayMaster
JavaScript返回的支付消息将用于发送至PayMaster进行UPP支付。
请参考 预授权支付响应,了解PayMaster商户插件(MPI)支持的安全控制。