支付响应

以下指南旨在解释如何在商家应用程序中应用相应的源代码，以从PayMaster返回的响应消息中检索支付响应参数。

Java

步骤 1 : 库

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

步骤 2 : 导入

对于定期支付，商家应将以下内容导入到商家代码中：

• 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/","CardPayment.properties");

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

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

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

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");

.....

步骤 4 : 使用 PropertiesReader 指示 PayMaster 属性文件的位置

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

步骤 5 : 使用 setter 指示 PayMaster 属性文件的位置

商家必须使用 setter("ResponseMessage", "<PayMaster网关返回的响应消息>") 指示 PayMaster 属性文件的位置。

步骤 6 : 将值分配到 PayMaster 响应实体

商家调用 Card Payment Response Message Builder 来生成响应消息并将值分配到 PayMaster 响应实体中。

信息

参考 定期支付参数 了解 PayMaster 商家插件（MPI）支持的字段。

步骤 7 : 从 PayMaster 响应实体检索值

商家可以从 PayMaster 响应实体中检索值。

• Getter 函数用于检索值，该函数只接受一个参数 – getter(参数名称)。

备注

请确保TxnStatDetCde的值不等于5015，因为这代表着一个无效的安全哈希值。

.Net

步骤 1 : 库

商家应将 PayMaster 商家插件（MPI）.Net 库 PayMaster.dll 包含到商家应用程序中。

步骤 2 : 命名空间

对于定期支付，商家在商家代码中应使用以下命名空间：

• 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/","CCPayment.properties");

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

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

//Call Payment Master Payment Response Message Builder to set value
PaymentResponseMessageBuilder cardPaymentResponseMessageBuilder = new PaymentResponseMessageBuilder();
cardPaymentResponseMessageBuilder.buildCardPaymentResponseMessage(ccPaymentResponseEntity, propertiesReader);

String MerchantID = ccPaymentResponseEntity.getter("MerchantID");
String MerchRefNo = ccPaymentResponseEntity.getter("MerchRefNo");
String TxnStatus = ccPaymentResponseEntity.getter("TxnStatus");
String SHAlgorithmType = ccPaymentResponseEntity.getter("SHAlgorithmType");
String SHValue = ccPaymentResponseEntity.getter("SHValue");

.....

步骤 4 : 指明属性文件位置

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

步骤 5 : 将响应消息分配给 Payment Response 实体

商家需将从 PayMaster 收到的响应消息分配给 PayMaster Response 实体，使用 setter("ResponseMessage","<PayMaster网关返回的响应消息>")。

步骤 6 : 将值分配到 PayMaster Response 实体

信息

参考 定期支付参数 了解 PayMaster 商家插件（MPI）支持的字段。

商家调用 Card Payment Response Message Builder 来生成响应消息，并将值分配到 PayMaster Response 实体中。

步骤 7 : 从 PayMaster Response 实体检索值

商家可以从 PayMaster Response 实体中检索值。

• Getter 函数用于检索值，该函数只接受一个参数 – getter(参数名称)。

备注

请确保TxnStatDetCde的值不等于5015，因为这代表着一个无效的安全哈希值。

PHP

步骤 1 : 库

商家应将 PayMaster 商家插件（MPI）PHP库 PayMaster.phar 包含到商家应用程序中。

步骤 2 : 商家代码

对于定期支付，商家应在商家代码中导入以下内容：

• PropertiesReader - 用于读取属性文件。
• PayMasterEntity - 用于为 PayMaster 定期支付分配所有可接受的值。
• PaymentResponseMessageBuilder - 用于生成 PayMaster 定期支付响应消息。

步骤 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>/' . '/paymaster/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> . "/paymaster","CardPayment.ini");

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

//Get all the parameter values from the user side and set into Payment Master Entity
$paymentResponseEntity->setter("ResponseMessage", $responseMessage);

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

$MerchantID = $paymentResponseEntity->getter("MerchantID");
$MerchRefNo = $paymentResponseEntity->getter("MerchRefNo");
$TxnStatus = $paymentResponseEntity->getter("TxnStatus");
$SHAlgorithmType = $paymentResponseEntity->getter("SHAlgorithmType");
$SHValue = $paymentResponseEntity->getter("SHValue");

.....

步骤 4 : 定位绝对路径

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

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

步骤 5 : 指明 PayMaster 属性文件

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

步骤 6 : 将响应消息分配给 Payment Response 实体

商家需要使用 setter(“ResponseMessage”,<PayMaster网关返回的响应消息>) 函数，将从 PayMaster 收到的响应消息分配给 PayMaster Response 实体。

步骤 7 : 将值分配到 PayMaster Response 实体

商家调用 Card Payment Response Message Builder 来处理响应消息，并将值分配到 PayMaster Response 实体中。

信息

参考 定期支付参数 了解 PayMaster 商家插件（MPI）支持的字段。

步骤 8 : 从 PayMaster Response 实体检索值

商家可以从 PayMaster Response 实体中检索值。

• Getter 函数用于检索值，该函数只接受一个参数 getter(参数名称)。

备注

请确保TxnStatDetCde的值不等于5015，因为这代表着一个无效的安全哈希值。

Python

步骤 1 : 包

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

步骤 2 : 导入

对于定期支付，商家应在商家代码中导入以下内容：

• PropertiesReader - 用于读取属性文件。
• PayMasterEntity - 用于为 PayMaster 定期支付分配所有可接受的值。
• PaymentResponseMessageBuilder - 用于生成 PayMaster 定期支付响应消息。

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

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

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

##Call Payment Master Payment Response Message Builder to set value
cardPaymentResponseMessageBuilder = PaymentResponseMessageBuilder()
cardPaymentResponseMessageBuilder.buildCardPaymentResponseMessage(ccPaymentResponseEntity, propertiesReader)

MerchantID = ccPaymentResponseEntity.getter("MerchantID")
MerchRefNo = ccPaymentResponseEntity.getter("MerchRefNo")
TxnStatus = ccPaymentResponseEntity.getter("TxnStatus")
SHAlgorithmType = ccPaymentResponseEntity.getter("SHAlgorithmType")
SHValue = ccPaymentResponseEntity.getter("SHValue")

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

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

步骤 5：将响应消息分配给 Payment Response 实体

商家需使用 setter(“ResponseMessage”,<PayMaster网关返回的响应消息>) 函数，将从 PayMaster 收到的响应消息分配给 PayMaster Response 实体。

步骤 6：将值分配到 PayMaster Response 实体

商家调用 Card Payment Response Message Builder 来处理响应消息，并将值分配到 PayMaster Response 实体中。

信息

参考 定期支付参数 了解 PayMaster 商家插件（MPI）支持的字段。

步骤 7：从 PayMaster Response 实体检索值

商家可以从 PayMaster Response 实体中检索值。

• Getter 函数用于检索值，该函数只接受一个参数 getter(参数名称)。

备注

请确保TxnStatDetCde的值不等于5015，因为这代表着一个无效的安全哈希值。

Node.js

步骤 1 : 包

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

步骤 2: 函数

• MERCH_CardPaymentResponse()
  • 该函数应在商家的响应页面上运行，用于重复支付。
  • 该函数将从 PayMaster 网关返回的响应参数中检索信息，并返回商家所需的结果。

步骤 3 : 源代码

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

module.exports = function (app) {
    app.get('/UPPPayment', (req, res)=>{
        paymaster.PropertiesReader('./properties/','CCPayment.properties');
        payment.MERCH_CardPaymentResponse(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');
                    //to do ...
                }
            }
        });
        .....
    });
}

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

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

信息

参考 定期支付参数 了解 PayMaster 商家插件（MPI）支持的字段。

步骤 5：从 PayMaster Response 实体检索值

商家可以从 PayMaster Response 实体中检索值。

• Getter 函数用于检索值，该函数只接受一个参数 getter(参数名称)。

备注

请确保TxnStatDetCde的值不等于5015，因为这代表着一个无效的安全哈希值。