完成请求

这份指南旨在解释如何应用相应的源代码来形成强制性的支付请求参数，将其包含在重定向链接中，并发送给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.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/","CCPayment.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","C13");
paymentRequestEntity.setter("MerchRefNo","merchant-refNo-0001");
paymentRequestEntity.setter("CurrCode","458");
paymentRequestEntity.setter("TxnAmt","1.00");
paymentRequestEntity.setter("ExpTxnAmt","2");
paymentRequestEntity.setter("CardNo","8853010000095323");

//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 recurring
String initialUrl = "https://xxx.finexusgroup.com/upp/faces/preauthcomplete.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(参数名称, 参数值)。

信息

请参考 Pre-Auth Completion Parameters 查看 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/","CCPayment.properties");

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

//Get all the parameter values from the user side and set into Payment Master Entity
ccPaymentRequestEntity.setter("PaymentID","C13");
ccPaymentRequestEntity.setter("MerchRefNo","merchant-refNo-0001");
ccPaymentRequestEntity.setter("CurrCode","458");
ccPaymentRequestEntity.setter("TxnAmt","1.00");
ccPaymentRequestEntity.setter("ExpTxnAmt","2");
ccPaymentRequestEntity.setter("CardNo","8853010000095XXX");

//Call Payment Master Payment Request Message Builder to generate the message
PaymentRequestMessageBuilder ccMessageBuilder = new PaymentRequestMessageBuilder();
string ccPaymentMessage = ccMessageBuilder.buildPaymentRequestMessage(ccPaymentRequestEntity, propertiesReader);

//POST request to Payment Master Gateway for recurring
string initialUrl  = "https://xxx.finexusgroup.com/upp/faces/preauthcomplete.xhtml?" + ccPaymentMessage;
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(参数名称, 参数值)。

信息

请参考 Pre-Auth Completion Parameters 查看 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>,"CCPayment.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", "C13");
$paymentRequestEntity->setter("MerchRefNo", "merchant-refNo-0001");
$paymentRequestEntity->setter("CurrCode", "458");
$paymentRequestEntity->setter("TxnAmt", "1.00");
$paymentRequestEntity->setter("ExpTxnAmt", "2");
$paymentRequestEntity->setter("CardNo","8853010000095XXX");

//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 recurring
$initialUrl = "https://xxx.finexusgroup.com/upp/faces/preauthcomplete.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 的绝对路径

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

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

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

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

步骤 6：将值分配给支付请求实体

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

setter 函数用于分配值，该函数接受两个参数 – setter(参数名称, 参数值)。

信息

请参考 Pre-Auth Completion Parameters 查看 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.PropertiesReader import PropertiesReader
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("CCPayment.properties","PayMasterProperties/")

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

##Get all the parameter values from the user side and set into Payment Master Entity
ccPaymentRequestEntity.setter("PaymentID", "C13")
ccPaymentRequestEntity.setter("MerchRefNo", "merchant-refNo-0001")
ccPaymentRequestEntity.setter("CurrCode", "458")
ccPaymentRequestEntity.setter("TxnAmt", "1.00")
ccPaymentRequestEntity.setter("ExpTxnAmt", "2")
ccPaymentRequestEntity.setter("CardNo", "8853010000095XXX");

##Call Payment Master Payment Request Message Builder to generate the message
ccMessageBuilder = PaymentRequestMessageBuilder()
ccPaymentMessage = ccMessageBuilder.buildPaymentRequestMessage(ccPaymentRequestEntity, propertiesReader)

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

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

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

步骤 5：将值分配给支付请求实体

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

setter 函数用于分配值，该函数接受两个参数 – setter(参数名称, 参数值)。

信息

请参考 Pre-Auth Completion Parameters 查看 PayMaster 商户插件（MPI）支持的字段。

步骤 6：生成 UPP 支付

一旦分配了所有必填值，商家将调用支付请求消息生成器生成 UPP 支付 – uppPaymentMessage。

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

uppPaymentMessage 将用于发送至 PayMaster 网关进行 UPP 支付。

信息

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

步骤 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(参数名称, 参数值)。

信息

请参考 Pre-Auth Completion Parameters 查看 PayMaster 商户插件（MPI）支持的字段。

步骤 5：生成请求消息

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

步骤 6：将支付消息发送至 PayMaster

JavaScript 返回的支付消息将用于发送至 PayMaster 进行 UPP 支付。

信息

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

完成请求

与我们联系