完成请求

本指南介绍了如何应用相应的源代码形成重定向链接中的强制支付请求参数，并将其发送给PayMaster进行支付完成处理。

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.PropertiesReader;
import com.PayMaster.MessageRequestBuilder.PaymentRequestMessageBuilder;

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

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

// Get all the parameter values from the user side and set them into the 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 pre-authorization payment
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(参数名，参数值)。

PayMaster商户插件（MPI）支持的字段请参考 预授权完成参数。

第 6 步：生成 UPP 付款

一旦分配了所有强制值，商家就会调用支付请求消息生成器来生成 UPP 支付 – paymentMessage。

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

paymentMessage 将用于发送到 PayMaster 网关以进行 UPP 付款。

请参阅 预授权完成响应了解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 a variable for Payment Master Properties - 1st Parameter = File Path, 2nd Parameter = File name
PropertiesReader propertiesReader = new PropertiesReader("./PayMasterProperties/", "CCPayment.properties");

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

// Get all the parameter values from the user side and set them into the 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");  // Masked for security

// 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 pre-authorization payment
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(参数名，参数值)。

PayMaster商户插件（MPI）支持的字段请参考 预授权完成参数。

第 6 步：生成 UPP 付款

分配所有强制值后，商家将调用支付请求消息生成器来生成 UPP 支付 —ccPaymentMessage。

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

ccPaymentMessage 将用于发送到 PayMaster 网关以进行 UPP 付款。

请参阅 预授权完成响应了解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>', 'CCPayment.ini');

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

// Get all the parameter values from the user side and set them into the 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');  // Masked for security

// 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 pre-authorization
$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://<absolute path of PayMaster.phar>/'

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

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

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

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

• setter函数用于赋值，它接受两个参数：setter(参数名，参数值)。

PayMaster商户插件（MPI）支持的字段请参考 预授权完成参数。

第 7 步：生成 UPP 付款

一旦分配了所有强制值，商家就会调用 PaymentRequestMessageBuilder 来生成 UPP 付款 ($paymentMessage)。

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

$paymentMessage 将用于发送到 PayMaster 网关以进行 UPP 付款。

请参阅 预授权完成响应了解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.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
properties_reader = PropertiesReader("CCPayment.properties", "PayMasterProperties/")

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

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

# Call Payment Master Payment Request Message Builder to generate the message
cc_message_builder = PaymentRequestMessageBuilder()
cc_payment_message = cc_message_builder.buildPaymentRequestMessage(cc_payment_request_entity, properties_reader)

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

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

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

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

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

• setter函数用于赋值，它接受两个参数：setter(参数名，参数值)。

PayMaster商户插件（MPI）支持的字段请参考 预授权完成参数。

第 6 步：生成 UPP 付款

一旦分配了所有强制值，商家就会调用PaymentRequestMessageBuilder来生成 UPP 付款（cc_ payment_message）。

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

cc_ payment_message 将用于发送到 PayMaster 网关以进行 UPP 付款。

请参阅 预授权完成响应了解PayMaster商户插件(MPI)支持的安全控制。

Node.js

第 1 步：图书馆

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

第 2 步源代码

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

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

        // Indicate the PayMaster Properties File location
        paymaster.PropertiesReader('./properties/', 'UPPPayment.properties');

        // Assign values to the PayMaster Request Entity
        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');

        // Generate the UPP Payment request message
        payment.MERCH_UPPPaymentRequest(paymaster.PaymentRequestEntity, paymaster.propDetails, function (err, response, result) {
            if (err) {
                throw err;
            }
            if (response) {
                // Redirect to PayMaster with the generated payment message
                res.redirect("https://xxx.finexusgroup.com/upp/faces/upp/payment.xhtml?" + result);
            }
        });
    });
}

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

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

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

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

• setter函数用于赋值，它接受两个参数：setter(参数名，参数值)。

PayMaster商户插件（MPI）支持的字段请参考 预授权完成参数。

第 5 步：生成付款请求消息

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

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

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

请参阅 预授权完成响应了解PayMaster商户插件(MPI)支持的安全控制。