付款请求

以下指南介绍了如何在商户应用程序中应用相应的源代码，形成付款请求参数并将其发送给 PayMaster 进行冲销付款处理。

Java
.Net
PHP
Python
Node.js

第 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 a variable for PayMaster Properties - 1st Parameter = File Path, 2nd Parameter = File Name
PropertiesReader propertiesReader = new PropertiesReader("./PayMasterProperties/", "CCPayment.properties");

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

// Get all the parameter values from the user side and set them into PayMaster Entity
paymentRequestEntity.setter("PaymentID", "C04");
paymentRequestEntity.setter("MerchRefNo", "MYB2023030315435025LL");
paymentRequestEntity.setter("CurrCode", "458");
paymentRequestEntity.setter("TxnAmt", "1.00");
paymentRequestEntity.setter("ExpTxnAmt", "2");
paymentRequestEntity.setter("ECI", "12");
paymentRequestEntity.setter("CardNo", "8853010000095323");
paymentRequestEntity.setter("TokenFlag", "Y");
paymentRequestEntity.setter("POSEnvFlag", "R");
paymentRequestEntity.setter("MerchUserID", "guest");
paymentRequestEntity.setter("ExpiryYear", "20");
paymentRequestEntity.setter("ExpiryMth", "12");
paymentRequestEntity.setter("TokenShrtName", "testcard");

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

// POST request to PayMaster Gateway for reversal payment
String initialUrl = "https://xxx.finexusgroup.com/upp/faces/ccpayment.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网关以实现撤销支付功能。

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

第 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 a variable for PayMaster Properties - 1st Parameter = File Path, 2nd Parameter = File Name
PropertiesReader propertiesReader = new PropertiesReader("./PayMasterProperties/", "CCPayment.properties");

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

// Get all the parameter values from the user side and set them into PayMaster Entity
ccPaymentRequestEntity.setter("PaymentID", "C04");
ccPaymentRequestEntity.setter("ECI", "12");
ccPaymentRequestEntity.setter("MerchRefNo", "MYB2023030315435025LL");
ccPaymentRequestEntity.setter("CurrCode", "458");
ccPaymentRequestEntity.setter("TxnAmt", "1.00");
ccPaymentRequestEntity.setter("ExpTxnAmt", "2");
ccPaymentRequestEntity.setter("CardNo", "8853010000095323");
ccPaymentRequestEntity.setter("ExpiryYear", "20");
ccPaymentRequestEntity.setter("ExpiryMth", "12");
ccPaymentRequestEntity.setter("TokenFlag", "Y");
ccPaymentRequestEntity.setter("MerchUserID", "guest");
ccPaymentRequestEntity.setter("TokenShrtName", "testcard");

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

// POST request to PayMaster Gateway for reversal payment
string initialUrl = "https://xxx.finexusgroup.com/upp/faces/ccpayment.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 步：生成付款消息

一旦分配了所有强制值，商家应调用PaymentRequestMessageBuilder来生成反转ccPaymentMessage。

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

ccPaymentMessage 将用于发送至 PayMaster 网关以实现撤销支付功能。

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

第 1 步：图书馆

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

第 2 步：导入

对于冲销付款，商家应将以下内容导入其代码中：

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

第 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 PayMaster Properties - 1st Parameter = File Path, 2nd Parameter = File Name
$propertiesReader = new PropertiesReader();
$propertiesReader->PropertiesReader(<absolute path>, "CCPayment.ini");

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

// Get all the parameter values from the user side and set them into PayMaster Entity
$paymentRequestEntity->setter("PaymentID", "C04");
$paymentRequestEntity->setter("MerchRefNo", "MYB2023030315435025LL");
$paymentRequestEntity->setter("CurrCode", "458");
$paymentRequestEntity->setter("TxnAmt", "1.00");
$paymentRequestEntity->setter("ExpTxnAmt", "2");
$paymentRequestEntity->setter("ECI", "12");
$paymentRequestEntity->setter("CardNo", "8853010000095323");
$paymentRequestEntity->setter("TokenFlag", "Y");
$paymentRequestEntity->setter("POSEnvFlag", "R");
$paymentRequestEntity->setter("MerchUserID", "guest");
$paymentRequestEntity->setter("TokenShrtName", "testcard");
$paymentRequestEntity->setter("ExpiryYear", "20");
$paymentRequestEntity->setter("ExpiryMth", "12");

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

// POST request to PayMaster Gateway for reversal payment
$initialUrl = "https://xxx.finexusgroup.com/upp/faces/ccpayment.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(parameterName,parameterValue)。

PayMaster商户插件（MPI）支持的字段请参见冲销支付参数。

第 7 步：生成付款消息

一旦分配了所有强制值，商家应调用PaymentRequestMessageBuilder来生成反转 paymentMessage。

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

paymentMessage将被发送到PayMaster网关以实现撤销支付功能。

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

第 1 步：打包

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

第 2 步：导入

对于撤销付款，商家应在其代码中包含以下内容：

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

第 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 PayMaster Properties - 1st Parameter = File Path, 2nd Parameter = File Name
properties_reader = PropertiesReader("PayMasterProperties/", "CCPayment.properties")

# Declare variable for PayMaster Entity
cc_payment_request_entity = PayMasterEntity()

# Get all the parameter values from the user side and set them into PayMaster Entity
cc_payment_request_entity.setter("PaymentID", "C04")
cc_payment_request_entity.setter("ECI", "12")
cc_payment_request_entity.setter("MerchRefNo", "MYB2023030315435025LL")
cc_payment_request_entity.setter("TxnDtTm", "")
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", "8853010000095323")
cc_payment_request_entity.setter("ExpiryYear", "20")
cc_payment_request_entity.setter("ExpiryMth", "12")
cc_payment_request_entity.setter("TokenFlag", "Y")
cc_payment_request_entity.setter("MerchUserID", "guest")
cc_payment_request_entity.setter("TokenShrtName", "testcard")

# 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 PayMaster Gateway for reversal payment
initial_url = "https://xxx.finexusgroup.com/upp/faces/ccpayment.xhtml?" + cc_payment_message
response = requests.post(initial_url)
final_url = response.url 

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

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

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

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

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

PayMaster商户插件（MPI）支持的字段请参见冲销支付参数。

第 6 步：生成付款消息

一旦分配了所有强制值，商家应调用PaymentRequestMessageBuilder来生成反转ccPaymentMessage。

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

ccPaymentMessage 将被发送到 PayMaster 网关以实现撤销支付功能。

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

第 1 步：图书馆

商户应在其应用程序中设置并包含 PayMaster Merchant Plug-In (MPI) Node.js 库。

第 2 步源代码

module.exports = function (app) {
    app.post('/CCPayment', (req, res) => {
        delete require.cache[
            require.resolve("./js/PayMaster.min.js")
        ];
        const paymaster = require("./js/PayMaster.min.js");

        // Initialize the PayMaster PropertiesReader with the file path and name
        paymaster.PropertiesReader('./properties/', 'CCPayment.properties');
        
        // Set all required parameters using the setter function
        paymaster.setter('PaymentID', 'C04');
        paymaster.setter('MerchRefNo', 'MYB2023030315435025LL');
        paymaster.setter('CurrCode', '458');
        paymaster.setter('TxnAmt', '1.00');
        paymaster.setter('ExpTxnAmt', '2');
        paymaster.setter('ECI', '12');
        paymaster.setter('CardNo', '8853010000095323');
        paymaster.setter('TokenFlag', 'Y');
        paymaster.setter('POSEnvFlag', 'R');
        paymaster.setter('MerchUserID', 'guest');
        paymaster.setter('ExpiryYear', '20');
        paymaster.setter('ExpiryMth', '12');
        paymaster.setter('TokenShrtName', 'testcard');

        // Generate the payment request message
        paymaster.MERCH_CardPaymentRequest(paymaster.PaymentRequestEntity, paymaster.propDetails, function(err, response, result) {
            if (err) {
                throw err;
            }
            if (response) {
                const initialUrl = "https://xxx.finexusgroup.com/upp/faces/ccpayment.xhtml?" + result;
                
                // Function to send a POST request to the PayMaster Gateway
                async function sendPostRequest() {
                    try {
                        const response = await axios.post(initialUrl);
                        const finalUrl = response.request.res.responseUrl;
                        // Handle the final URL or further actions
                        .....
                    } catch (error) {
                        console.error('Error sending POST request:', error);
                    }
                }
                sendPostRequest();
            }
        });
    });
}

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

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

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

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

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

PayMaster商户插件（MPI）支持的字段请参见冲销支付参数。

第 5 步生成请求消息

使用 MERCH_CardPaymentRequest() 函数生成冲销支付请求消息。

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

支付消息将被发送至PayMaster网关以实现冲销支付功能。

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