付款响应

以下指南说明如何在商户网站或应用程序中应用相应的源代码，从 PayMaster 返回的响应消息中检索支付响应参数。

Java

第 1 步：图书馆

将 PayMaster 商家插件 (MPI) Java 库 – PayMaster.jar – 包含到您的商家应用程序中。

第 2 步：导入

对于 UPP 付款，请将以下内容导入您的商家代码：

• com.PayMaster.Entities.PayMasterEntity
• com.PayMaster.PropertiesReader.PropertiesReader
• com.PayMaster.MessageResponseBuilder.PaymentResponseMessageBuilder

步骤 3：源代码

import com.PayMaster.Entities.PayMasterEntity;
import com.PayMaster.PropertiesReader.PropertiesReader;
import com.PayMaster.MessageResponseBuilder.PaymentResponseMessageBuilder;

.....

// 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 paymentResponseEntity = new PayMasterEntity();

// Get response message from PayMaster and set it into Payment Master Entity
paymentResponseEntity.setter("ResponseMessage", responseMessage);

// Call Payment Master Payment Response Message Builder to set value
PaymentResponseMessageBuilder paymentResponseMessageBuilder = new PaymentResponseMessageBuilder();
paymentResponseMessageBuilder.buildUPPPaymentResponseMessage(paymentResponseEntity, propertiesReader);

if (paymentResponseEntity.getter("TxnStatDetCde").equals("0000")) {
    String MerchantID = paymentResponseEntity.getter("MerchantID");
    String MerchRefNo = paymentResponseEntity.getter("MerchRefNo");
    String TxnStatus = paymentResponseEntity.getter("TxnStatus");
    String SHAlgorithmType = paymentResponseEntity.getter("SHAlgorithmType");
    String SHValue = paymentResponseEntity.getter("SHValue");
    // Additional processing...
}

.....

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

使用PropertiesReader指示 PayMaster 属性文件的位置。

第 5 步：设置响应消息

使用 setter 方法设置来自 PayMaster 网关的响应消息： paymentResponseEntity.setter("ResponseMessage", "<PayMaster 网关返回的响应消息>");。

第 6 步： 构建付款响应消息

调用 UPP 支付响应消息构建器来解析响应消息并将值分配给 PayMaster 响应实体。

第 7 步： 从 PayMaster 响应实体检索值

使用 getter 方法从 PayMaster 响应实体检索值：String value = paymentResponseEntity.getter("parameter name");。

确保 TxnStatDetCde 的值不等于 5015，因为这表示无效的安全哈希值。

PayMaster商户插件（MPI）支持的字段请参考UPP支付参数。

.Net

第 1 步：图书馆

将 PayMaster 商家插件 (MPI) .Net 库 – PayMaster.dll – 包含到您的商家应用程序中。

第 2 步：命名空间

对于 UPP 付款，请在商家代码中使用以下命名空间：

• using com.PayMaster.Entities
• using com.PayMaster.Properties
• using com.PayMaster.MessageResponseBuilder

步骤 3：源代码

using com.PayMaster.Entities;
using com.PayMaster.Properties;
using com.PayMaster.MessageResponseBuilder;

.....

// 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 uppPaymentResponseEntity = new PayMasterEntity();

// Get response message from PayMaster and set it into Payment Master Entity
uppPaymentResponseEntity.setter("ResponseMessage", responseMessage);

// Call Payment Master Payment Response Message Builder to set value
PaymentResponseMessageBuilder uppPaymentResponseMessageBuilder = new PaymentResponseMessageBuilder();
uppPaymentResponseMessageBuilder.buildUPPPaymentResponseMessage(uppPaymentResponseEntity, propertiesReader);

if (uppPaymentResponseEntity.getter("TxnStatDetCde").Equals("0000")) {
    String MerchantID = uppPaymentResponseEntity.getter("MerchantID");
    String MerchRefNo = uppPaymentResponseEntity.getter("MerchRefNo");
    String TxnStatus = uppPaymentResponseEntity.getter("TxnStatus");
    String SHAlgorithmType = uppPaymentResponseEntity.getter("SHAlgorithmType");
    String SHValue = uppPaymentResponseEntity.getter("SHValue");
    // Additional processing...
}

.....

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

使用PropertiesReader指示 PayMaster 属性文件的位置。

第 5 步：设置响应消息

使用 setter 方法设置来自 PayMaster 网关的响应消息：uppPaymentResponseEntity.setter("ResponseMessage", "<PayMaster 网关返回的响应消息>");。

第 6 步： 构建付款响应消息

调用 UPP 支付响应消息构建器来解析响应消息并将值分配给 PayMaster 响应实体。

第 7 步： 从 PayMaster 响应实体检索值

使用 getter 方法从 PayMaster 响应实体检索值：String value = uppPaymentResponseEntity.getter("parameter name");。

确保 TxnStatDetCde 的值不等于 5015，因为这表示无效的安全哈希值。

PayMaster商户插件（MPI）支持的字段请参考UPP支付参数。

PHP

第 1 步：图书馆

将 PayMaster 商家插件 (MPI) PHP 库 – PayMaster.phar – 包含到您的商家应用程序中。

第 2 步：商户代码

对于 UPP 付款，请将以下内容导入您的商家代码：

• PropertiesReader – 读取属性文件。
• PayMasterEntity – 为 PayMaster UPP 付款分配所有可接受的值。
• PaymentResponseMessageBuilder – 生成 PayMaster UPP 支付响应消息。

步骤 3：源代码

<?php
use com\PayMaster\Entities\PayMasterEntity;
use com\PayMaster\PropertiesReader\PropertiesReader;
use com\PayMaster\MessageResponseBuilder\PaymentResponseMessageBuilder;
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();
$propertiesReader->PropertiesReader('<absolute path>', 'UPPPayment.ini');

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

// Get response message from PayMaster and set it into Payment Master Entity
$paymentResponseEntity->setter('ResponseMessage', $responseMessage);

// Call Payment Master Payment Response Message Builder to set value
$paymentResponseMessageBuilder = new PaymentResponseMessageBuilder();
$paymentResponseMessageBuilder->buildUPPPaymentResponseMessage($paymentResponseEntity, $propertiesReader);

if (strncmp($paymentResponseEntity->getter('TxnStatDetCde'), '0000', 4) == 0) {
    $MerchantID = $paymentResponseEntity->getter('MerchantID');
    $MerchRefNo = $paymentResponseEntity->getter('MerchRefNo');
    $TxnStatus = $paymentResponseEntity->getter('TxnStatus');
    $SHAlgorithmType = $paymentResponseEntity->getter('SHAlgorithmType');
    $SHValue = $paymentResponseEntity->getter('SHValue');
    // Additional processing...
}
?>

第4步：找到PayMaster.phar的绝对路径

找到 PayMaster.phar 的绝对路径并将其设置为源代码中的 basePath。例如：$basePath = 'phar://<absolute path of PayMaster.phar>/';

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

使用PropertiesReader指示 PayMaster 属性文件的位置。

第 6 步： 将响应消息分配给支付响应实体

使用 setter 函数将从 PayMaster 收到的响应消息分配给支付响应实体：$paymentResponseEntity->setter('ResponseMessage', $responseMessage);

第 7 步： 构建付款响应消息

调用 UPP 支付响应消息构建器来解析响应消息并将值分配给 PayMaster 响应实体。

第 8 步： 从 PayMaster 响应实体检索值

使用 getter 函数从 PayMaster 响应实体检索值：$value = $paymentResponseEntity->getter('parameter name');

确保 TxnStatDetCde 的值不等于 5015，因为这表示无效的安全哈希值。

PayMaster商户插件（MPI）支持的字段请参考UPP支付参数。

Python

第 1 步：打包

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

第 2 步：导入

对于 UPP 付款，请在您的商家代码中包含以下内容：

• PropertiesReader – 读取属性文件。
• PayMasterEntity – 为 PayMaster UPP 付款分配所有可接受的值。
• PaymentResponseMessageBuilder – 生成 PayMaster UPP 支付响应消息。

步骤 3：源代码

from com.PayMaster.Entities.PayMasterEntity import PayMasterEntity
from com.PayMaster.PropertiesReader.PropertiesReader import PropertiesReader
from com.PayMaster.MessageResponseBuilder.PaymentResponseMessageBuilder import PaymentResponseMessageBuilder

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

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

# Get response message from PayMaster and set it into Payment Master Entity
uppPaymentResponseEntity.setter("ResponseMessage", responseMessage)

# Call Payment Master Payment Response Message Builder to set value
uppPaymentResponseMessageBuilder = PaymentResponseMessageBuilder()
uppPaymentResponseMessageBuilder.buildUPPPaymentResponseMessage(uppPaymentResponseEntity, propertiesReader)

if uppPaymentResponseEntity.getter("TxnStatDetCde") == '0000':
    MerchantID = uppPaymentResponseEntity.getter("MerchantID")
    MerchRefNo = uppPaymentResponseEntity.getter("MerchRefNo")
    TxnStatus = uppPaymentResponseEntity.getter("TxnStatus")
    SHAlgorithmType = uppPaymentResponseEntity.getter("SHAlgorithmType")
    SHValue = uppPaymentResponseEntity.getter("SHValue")
    # Additional processing...

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

使用PropertiesReader指示 PayMaster 属性文件的位置。

第 5 步：将响应消息分配给支付响应实体

使用 setter 函数将从 PayMaster 收到的响应消息分配给支付响应实体：uppPaymentResponseEntity.setter("ResponseMessage", responseMessage)

第 6 步： 构建付款响应消息

调用 UPP 支付响应消息构建器来解析响应消息并将值分配给 PayMaster 响应实体。

第 7 步： 从 PayMaster 响应实体检索值

使用 getter 函数从 PayMaster 响应实体检索值：value = uppPaymentResponseEntity.getter("parameter name")。

确保 TxnStatDetCde 的值不等于 5015，因为这表示无效的安全哈希值。

PayMaster商户插件（MPI）支持的字段请参考UPP支付参数。

Node.js

第 1 步：图书馆

设置 PayMaster 商家插件 (MPI) NodeJS 库并将其包含到您的商家应用程序中。

第 2 步：功能

• MERCH_UppPaymentResponse()
  • 此功能应在商户的UPP支付响应页面上运行。
  • 它将解析从PayMaster网关返回的响应参数并返回所需的结果。

步骤 3：源代码

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

module.exports = function (app) {
    app.get('/UPPPayment', (req, res) => {
        paymaster.PropertiesReader('./properties/', 'UPPPayment.properties');
        paymaster.MERCH_UPPPaymentResponse(req, paymaster.propDetails, function(err, response, result) {
            if (err) {
                throw err;
            }
            if (response) {
                if (paymaster.getter('TxnStatDetCde') === "0000") {
                    var MerchantID = paymaster.getter('MerchantID');
                    var MerchRefNo = paymaster.getter('MerchRefNo');
                    var TxnStatus = paymaster.getter('TxnStatus');
                    var SHAlgorithmType = paymaster.getter('SHAlgorithmType');
                    var SHValue = paymaster.getter('SHValue');
                    // Additional processing...
                }
            }
        });
        // Additional code...
    });
}

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

使用“PropertiesReader”来指示 PayMaster 属性文件所在的位置。

第 5 步：从 PayMaster 响应实体检索值

使用 getter 函数从 PayMaster 响应实体检索值：var value = paymaster.getter('parameter name');

确保 TxnStatDetCde 的值不等于 5015，因为这表示无效的安全哈希值。

PayMaster商户插件（MPI）支持的字段请参考UPP支付参数。