付款响应
以下指南解释了如何在商户应用程序中集成和利用相应的源代码,从 PayMaster 返回的响应消息中检索支付响应参数。
- Java
- .Net
- PHP
- Python
- Node.js
第 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 a variable for PayMaster Properties - 1st Parameter = File Path, 2nd Parameter = File Name
PropertiesReader propertiesReader = new PropertiesReader("./PayMasterProperties/", "CardPayment.properties");
// Declare a variable for PayMaster Entity
PayMasterEntity paymentResponseEntity = new PayMasterEntity();
// Get the response message from PayMaster and set it into PayMaster Entity
paymentResponseEntity.setter("ResponseMessage", responseMessage);
// Call PaymentResponseMessageBuilder to parse the response message
PaymentResponseMessageBuilder paymentResponseMessageBuilder = new PaymentResponseMessageBuilder();
paymentResponseMessageBuilder.buildCardPaymentResponseMessage(paymentResponseEntity, propertiesReader);
// Retrieve values from PayMaster Response Entity
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 步:指示 PayMaster 属性文件位置
商家必须使用PropertiesReader
指定 PayMaster 属性文件的位置。
第 5 步:使用 Setter 设置响应消息
商户必须使用setter方法设置PayMaster网关返回的响应消息:paymentResponseEntity.setter("ResponseMessage", "<PayMaster网关返回的响应消息>");
第 6 步: 解析 PayMaster 响应实体并为其赋值
商户应调用 CardPaymentResponseMessageBuilder
来解析响应消息并将值分配给PayMaster响应实体。
PayMaster商户插件(MPI)支持的字段请参见 冲销支付参数。
第 7 步: 从 PayMaster 响应实体检索值
商家可以从 PayMaster 响应实体检索值。
- getter 函数用于检索值并接受一个参数:
getter(参数名称)
。
确保 TxnStatDetCde
的值不等于 5015,因为这表示无效的安全哈希值。
第 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 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 ccPaymentResponseEntity = new PayMasterEntity();
// Set the response message received from PayMaster into the PayMaster Entity
ccPaymentResponseEntity.setter("ResponseMessage", responseMessage);
// Call PaymentResponseMessageBuilder to parse the response message
PaymentResponseMessageBuilder cardPaymentResponseMessageBuilder = new PaymentResponseMessageBuilder();
cardPaymentResponseMessageBuilder.buildCardPaymentResponseMessage(ccPaymentResponseEntity, propertiesReader);
// Retrieve values from PayMaster Response Entity
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 步:指示 PayMaster 属性文件位置
商家必须使用PropertiesReader
指定 PayMaster 属性文件的位置。
第 5 步:将响应消息分配给支付响应实体
商户必须将从 PayMaster 网关收到的响应消息分配给 PayMaster 响应实体,使用: ccPaymentResponseEntity.setter("ResponseMessage", "<PayMaster 网关返回的响应消息>");
第 6 步: 解析 PayMaster 响应实体并为其赋值
商户应调用 CardPaymentResponseMessageBuilder
来解析响应消息并将值分配给 PayMaster 响应实体。
PayMaster商户插件(MPI)支持的字段请参见 冲销支付参数。
第 7 步: 从 PayMaster 响应实体检索值
商户可以使用 getter 函数从 PayMaster 响应实体检索值,该函数接受一个参数:ccPaymentResponseEntity.getter("参数名称");
确保 TxnStatDetCde
的值不等于 5015,因为这表示无效的安全哈希值。
第 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;
// 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 PayMaster Properties - 1st Parameter = File Path, 2nd Parameter = File Name
$propertiesReader = new PropertiesReader();
$propertiesReader->PropertiesReader("<absolute path>/paymaster", "CCPayment.ini");
// Declare variable for PayMaster Entity
$paymentResponseEntity = new PayMasterEntity();
// Set the response message received from PayMaster into the PayMaster Entity
$paymentResponseEntity->setter("ResponseMessage", $responseMessage);
// Call PaymentResponseMessageBuilder to parse the response message
$paymentResponseMessageBuilder = new PaymentResponseMessageBuilder();
$paymentResponseMessageBuilder->buildCardPaymentResponseMessage($paymentResponseEntity, $propertiesReader);
// Retrieve values from PayMaster Response Entity
$MerchantID = $paymentResponseEntity->getter("MerchantID");
$MerchRefNo = $paymentResponseEntity->getter("MerchRefNo");
$TxnStatus = $paymentResponseEntity->getter("TxnStatus");
$SHAlgorithmType = $paymentResponseEntity->getter("SHAlgorithmType");
$SHValue = $paymentResponseEntity->getter("SHValue");
?>
第 4 步:找到PayMaster.phar的绝对路径
商户必须找到 PayMaster.phar 的绝对路径来定义源代码中的 $basePath
。
例子 : $basePath=’phar://<absolute path of PayMaster.phar>/’
第 5 步:指示 PayMaster 属性文件位置
商家必须使用PropertiesReader
指定 PayMaster 属性文件的位置。
第 6 步: 将响应消息分配给支付响应实体
商户必须将从 PayMaster 网关收到的响应消息分配给 PayMaster 响应实体,使用:$paymentResponseEntity->setter("ResponseMessage", "<PayMaster 网关返回的响应消息>");
第 7 步: 解析 PayMaster 响应实体并为其赋值
商户应调用 PaymentResponseMessageBuilder
来解析响应消息并将值分配给PayMaster响应实体。
PayMaster商户插件(MPI)支持的字段请参见 冲销支付参数。
第 8 步: 从 PayMaster 响应实体检索值
商户可以使用 getter 函数从 PayMaster 响应实体检索值,该函数接受一个参数:$paymentResponseEntity->getter("参数名称");
TxnStatus
应为 00,TxnStatDetCde
应为 0000。- 确保
TxnStatDetCde
的值不等于 5015,因为这表示无效的安全哈希值。
第 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
propertiesReader = PropertiesReader("PayMasterProperties/", "CCPayment.properties")
# Declare variable for Payment Master Entity
ccPaymentResponseEntity = PayMasterEntity()
# Set the response message received from PayMaster into the PayMaster Entity
ccPaymentResponseEntity.setter("ResponseMessage", responseMessage)
# Call Payment Response Message Builder to parse and set values
cardPaymentResponseMessageBuilder = PaymentResponseMessageBuilder()
cardPaymentResponseMessageBuilder.buildCardPaymentResponseMessage(ccPaymentResponseEntity, propertiesReader)
# Retrieve values from PayMaster Response Entity
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 步:将响应消息分配给支付响应实体
商户必须将从 PayMaster 收到的响应消息分配给 PayMaster 响应实体,使用: ccPaymentResponseEntity.setter("ResponseMessage", "<PayMaster 网关返回的响应消息>")
第 6 步: 解析 PayMaster 响应实体并为其赋值
商户应调用 PaymentResponseMessageBuilder
来解析响应消息并将值分配给PayMaster响应实体。
PayMaster商户插件(MPI)支持的字段请参见 冲销支付参数。
第 7 步: 从 PayMaster 响应实体检索值
商户可以使用 getter 函数从 PayMaster 响应实体检索值,该函数接受一个参数:value = ccPaymentResponseEntity.getter("parameter name")
确保 TxnStatDetCde
的值不等于 5015,因为这表示无效的安全哈希值。
第 1 步:图书馆
商户应在商户应用程序中设置并包含 PayMaster 商户插件 (MPI) Node.js 库。
第 2 步:功能
MERCH_CardPaymentResponse()
- 此功能应在商户的撤销付款响应页面中使用。它检索PayMaster网关返回的响应参数,并返回商户所需的结果。
第 3 步:源代码示例
var paymaster = require('./js/PayMaster.min.js');
module.exports = function (app) {
app.get('/UPPPayment', (req, res) => {
// Load PayMaster Properties File
paymaster.PropertiesReader('./properties/', 'CCPayment.properties');
// Retrieve the response parameters
payment.MERCH_CardPaymentResponse(req, paymaster.propDetails, function(err, response, result) {
if (err) {
throw err;
}
if (response) {
// Check if transaction status detail code is valid
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');
// Handle response values here
// to do ...
}
}
});
});
}
第 4 步:指示 PayMaster 属性文件位置
商家必须使用PropertiesReader
指定 PayMaster 属性文件的位置。
第 5 步:从 PayMaster 响应实体检索值
商家可以使用 getter 函数从 PayMaster 响应实体检索值,该函数接受一个参数:var value = paymaster.getter('parameter name');
PayMaster商户插件(MPI)支持的字段请参见 冲销支付参数。
确保 TxnStatDetCde
的值不等于 5015,因为这表示无效的安全哈希值。