支付请求

以下指南旨在说明如何在商户应用程序中应用相应的源代码，以形成并发送支付请求参数至 PayMaster，进行冲正支付处理。

Java

步骤 1：库文件

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

步骤 2：导入

对于冲正支付，商户应将以下内容导入到商户代码中：

• com.PayMaster.Entities.PayMasterEntity
• com.PayMaster.PropertiesReader.PropertiseReader
• 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/","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("PaymentID", "C15");
paymentRequestEntity("MerchRefNo", "merchant-refNo-0001");
paymentRequestEntity("CurrCode", "458");
paymentRequestEntity("TxnAmt", "1.00");
paymentRequestEntity("ExpTxnAmt", "2");

//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 reversal
String initialUrl = "https://xxx.finexusgroup.com/upp/faces/reversal0400.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 Properties 文件位置

商户必须使用 PropertiesReader 指定 PayMaster Properties 文件的位置。

步骤 5：将值分配给 Payment Request Entity

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

• Setter 函数用于分配值，该函数接受两个参数 - setter(parameter name, parameter value)。

信息

请参阅 冲正支付参数 以了解 PayMaster 商户插件（MPI）支持的字段。

步骤 6：生成 Payment Message

一旦分配了所有强制性值，商户调用 Payment Request Message Builder 生成冲正的 paymentMessage。

步骤 7：将 Payment Message 发送到 PayMaster Gateway

paymentMessage 将被发送到 PayMaster Gateway 以进行冲正支付功能。

信息

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

.Net

步骤 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 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", "C15");
paymentRequestEntity.setter("MerchRefNo", "merchant-refNo-0001");
paymentRequestEntity.setter("CurrCode", "458");
paymentRequestEntity.setter("TxnAmt", "1.00");
paymentRequestEntity.setter("ExpTxnAmt", "2");

//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 reversal
string initialUrl  = "https://xxx.finexusgroup.com/upp/faces/reversal0400.xhtml?" + paymentMessage;
HttpClient httpClient = new HttpClient();
HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Post, initialUrl );
HttpResponseMessage response = await httpClient.SendAsync(request);
Uri finalUrl = response.RequestMessage.RequestUri;
.....

步骤 4：指定 PayMaster Properties 文件位置

商户必须使用 PropertiesReader 指定 PayMaster Properties 文件的位置。

步骤 5：将值分配给 Payment Request Entity

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

• Setter 函数用于分配值，该函数接受两个参数 - setter(parameter name, parameter value)。

信息

请参阅 冲正支付参数 以了解 PayMaster 商户插件（MPI）支持的字段。

步骤 6：生成 Payment Message

一旦分配了所有强制性值，商户调用 Payment Request Message Builder 生成冲正的 ccPaymentMessage。

步骤 7：将 Payment Message 发送到 PayMaster Gateway

ccPaymentMessage 将被发送到 PayMaster Gateway 以进行冲正支付功能。

信息

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

PHP

步骤 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 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", "C15");
$paymentRequestEntity->setter("MerchRefNo", "merchant-refNo-0001");
$paymentRequestEntity->setter("CurrCode", "458");
$paymentRequestEntity->setter("TxnAmt", "1022.00");
$paymentRequestEntity->setter("ExpTxnAmt", "2");

//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 reversal
$initialUrl = "https://xxx.finexusgroup.com/upp/faces/reversal0400.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 Properties 文件位置

商户必须使用 PropertiesReader 指定 PayMaster Properties 文件的位置。

步骤 6：将值分配给 Payment Request Entity

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

• Setter 函数用于分配值，该函数接受两个参数 - setter(parameter name, parameter value)。
• MerchRefNo 是从需要执行冲正的支付中获取的。

信息

请参阅 冲正支付参数 以了解 PayMaster 商户插件（MPI）支持的字段。

步骤 7：生成冲正

一旦分配了所有强制性值，商户调用 Payment Request Message Builder 生成冲正 paymentMessage。

步骤 8：将冲正消息发送到 PayMaster Gateway

paymentMessage 将被发送到 PayMaster Gateway 以进行冲正支付功能。

信息

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

Python

步骤 1：包

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

步骤 2：导入

对于冲正支付，商户应将以下内容包含到商户代码中：

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

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

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

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

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

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

.....

步骤 4：指定 PayMaster Properties 文件位置

商户必须使用 PropertiesReader 指定 PayMaster Properties 文件的位置。

步骤 5：将值分配给 Payment Request Entity

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

• Setter 函数用于分配值，该函数接受两个参数 - setter(parameter name, parameter value)。

信息

请参阅 冲正支付参数 以了解 PayMaster 商户插件（MPI）支持的字段。

步骤 6：生成 Payment Message

一旦分配了所有强制性值，商户调用 Payment Request Message Builder 生成冲正的 ccPaymentMessage。

步骤 7：将 Payment Message 发送到 PayMaster Gateway

ccPaymentMessage 将用于发送到 PayMaster Gateway 以进行冲正支付功能。

信息

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

Node.js

步骤 1：库文件

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

步骤 2：源代码

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

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

        .....
        
        paymaster.PropertiesReader('./properties/','CCPayment.properties');
        paymaster.setter('PaymentID', 'C15');
        paymaster.setter('MerchRefNo', 'merchant-refNo-0001');
        paymaster.setter('CurrCode', '458');
        paymaster.setter('TxnAmt', '1.00');
        paymaster.setter('ExpTxnAmt', '2');


        payment.MERCH_CardPaymentRequest(paymaster.PaymentRequestEntity, paymaster.propDetails, function(err, response, result){
            if(err){
                throw err;
            }
            if(response){
                const initialUrl = "https://xxx.finexusgroup.com/upp/faces/reversal0400.xhtml?" + result;
                async function sendPostRequest() {
                    const response = await axios.post(initialUrl);
                    const finalUrl = response.request.res.responseUrl;
                    .....
                }
                sendPostRequest();
            }
        });
    });
}

步骤 3：指定 PayMaster Properties 文件位置

商户必须使用 PropertiesReader 指定 PayMaster Properties 文件的位置。

步骤 4：将值分配给 Payment Request Entity

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

• Setter 函数用于分配值，该函数接受两个参数 - setter(parameter name, parameter value)。

信息

请参阅 冲正支付参数 以了解 PayMaster 商户插件（MPI）支持的字段。

步骤 5：生成请求消息

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

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

支付消息将被发送到 PayMaster Gateway 以进行冲正支付功能。

信息

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