支付查询
以下指南旨在说明如何在商家网站或商家应用程序中应用相应的源代码,以便形成必要的支付请求参数,该参数可以包含在重定向链接中,并发送给 PayMaster 以进行 UPP 支付查询处理。
- Java
- .Net
- PHP
- Python
- Node.js
步骤 1:库
商家应将 PayMaster 商家插件(MPI)Java库 PayMaster.jar 包含到商家应用程序中。
步骤 2:导入
对于 UPP 支付查询,商家应在商家代码中导入以下内容:
com.PayMaster.Entities.PayMasterEntity
com.PayMaster.PropertiesReader.PropertiesReader
com.PayMaster.MessageRequestBuilder.WebservicePaymentRequestMessageBuilder
步骤 3:源代码
import com.PayMaster.Entities.PayMasterEntity;
import com.PayMaster.PropertiesReader.PropertiseReader;
import com.PayMaster.MessageRequestBuilder.WebservicePaymentRequestMessageBuilder;
.....
//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 paymentRequestEntity = new PayMasterEntity();
//Get all the parameter value from the user side and set into Payment Master Entity
paymentRequestEntity.setter("PaymentID", "U02");
paymentRequestEntity.setter("MerchantID", "000010000099939");
paymentRequestEntity.setter("ServiceID", "FNX");
paymentRequestEntity.setter("MerchRefNo", "MYB2023030315435025LL");
paymentRequestEntity.setter("QueryRespURL", "https://XXX.XXXXX.XXX/query.jsp");
//Call Payment Master Payment Request Message Builder to generate the message
WebservicePaymentRequestMessageBuilder MessageBuilder = new WebservicePaymentRequestMessageBuilder();
buildUPPQueryRequestMessage(paymentRequestEntity, propertiesReader);
String MerchantID = paymentRequestEntity.getter("MerchantID");
String CardNo = paymentRequestEntity.getter("CardNo");
String TxnDtTm = paymentRequestEntity.getter("TxnDtTm");
String TxnAmt = paymentRequestEntity.getter("TxnAmt");
String TxnStatus = paymentRequestEntity.getter("TxnStatus");
String CurrCode = paymentRequestEntity.getter("CurrCode");
String AuthIDRespCode = paymentRequestEntity.getter("AuthIDRespCode");
String ExpTxnAmt = paymentRequestEntity.getter("ExpTxnAmt");
String RetrievalRefNo = paymentRequestEntity.getter("RetrievalRefNo");
String OrgRespCode = paymentRequestEntity.getter("OrgRespCode");
String OrigTxnAmt = paymentRequestEntity.getter("OrigTxnAmt");
String OrigCurrCode = paymentRequestEntity.getter("OrigCurrCode");
String TxnChannel = paymentRequestEntity.getter("TxnChannel");
String FICode = paymentRequestEntity.getter("FICode");
String PymtGwRefNo = paymentRequestEntity.getter("PymtGwRefNo");
String TxnStatDetCde = paymentRequestEntity.getter("TxnStatDetCde");
String TxnStatMsg = paymentRequestEntity.getter("TxnStatMsg");
String ServiceID = paymentRequestEntity.getter("ServiceID");
String MerchHostID = paymentRequestEntity.getter("MerchHostID");
String MerchSessionID = paymentRequestEntity.getter("MerchSessionID");
String MerchRefNo = paymentRequestEntity.getter("MerchRefNo");
String OrderRefNo = paymentRequestEntity.getter("OrderRefNo");
String QueryStatus = paymentRequestEntity.getter("QueryStatus");
String FPXRefNo = paymentRequestEntity.getter("FPXRefNo");
String UppPymtMode = paymentRequestEntity.getter("UppPymtMode");
String OrigRespCode = paymentRequestEntity.getter("OrigRespCode");
String ExporigTxnAmt = paymentRequestEntity.getter("ExporigTxnAmt");
.....
步骤 4:使用 PropertiesReader
指示 PayMaster 属性文件位置
商家必须使用 PropertiesReader
指示 PayMaster 属性文件的位置。
步骤 5:将值分配给 PayMaster 请求实体
商家需要为 PayMaster 请求实体分配值。商家代码必须包含示例代码中指定的所有字段,因为这些是必填字段。
- 使用 setter 函数分配值,该函数接受两个参数 -
setter(参数名称, 参数值)
。
步骤 6:调用 Web Service 支付请求消息生成器
一旦分配了所有必填值,商家使用 buildUPPPaymentQueryRequest
函数调用 Web Service 支付请求消息生成器。
- 将生成支付查询请求消息,并提交给 PayMaster 网关。
- 从 PayMaster 网关收到的查询响应将被消息化,并分配回 PayMaster 请求实体。
步骤 7:从 PayMaster 请求实体检索值
商家可以再次使用相同的 PayMaster 请求实体来检索查询响应的信息。
- 使用 getter 函数检索值,该函数只接受一个参数 -
getter(参数名称)
。
请参阅 OBW 支付查询 了解 PayMaster 商家插件(MPI)支持的字段。
步骤 1:库
商家应将 PayMaster 商家插件(MPI).Net 库 PayMaster.dll 包含到商家应用程序中。
步骤 2:命名空间
对于 UPP 支付查询,商家应在商家代码中使用以下命名空间:
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/","UPPPayment.properties");
//Declare variable for Payment Master Entity
PayMasterEntity uppPaymentRequestEntity = new PayMasterEntity();
//Get all the parameter values from the user side and set into Payment Master Entity
uppPaymentRequestEntity.setter("PaymentID", "U02");
uppPaymentRequestEntity.setter("MerchantID", "000010000099939");
uppPaymentRequestEntity.setter("ServiceID", "FNX");
uppPaymentRequestEntity.setter("MerchRefNo", "MYB2023030315435025LL");
uppPaymentRequestEntity.setter("QueryRespURL", "https://XXX.XXXXX.XXX/query.jsp");
//Call Payment Master Web Service Payment Request Message Builder for upp query request
WebServicePaymentRequestMessageBuilder uppMessageBuilder = new WebServicePaymentRequestMessageBuilder();
await uppMessageBuilder.buildUPPPaymentQueryRequest(uppPaymentRequestEntity, propertiesReader);
String MerchantID = uppPaymentRequestEntity.getter("MerchantID");
String CardNo = uppPaymentRequestEntity.getter("CardNo");
String TxnDtTm = uppPaymentRequestEntity.getter("TxnDtTm");
String TxnAmt = uppPaymentRequestEntity.getter("TxnAmt");
String TxnStatus = uppPaymentRequestEntity.getter("TxnStatus");
String CurrCode = uppPaymentRequestEntity.getter("CurrCode");
String AuthIDRespCode = uppPaymentRequestEntity.getter("AuthIDRespCode");
String ExpTxnAmt = uppPaymentRequestEntity.getter("ExpTxnAmt");
String RetrievalRefNo = uppPaymentRequestEntity.getter("RetrievalRefNo");
String OrgRespCode = uppPaymentRequestEntity.getter("OrgRespCode");
String OrigTxnAmt = uppPaymentRequestEntity.getter("OrigTxnAmt");
String OrigCurrCode = uppPaymentRequestEntity.getter("OrigCurrCode");
String TxnChannel = uppPaymentRequestEntity.getter("TxnChannel");
String FICode = uppPaymentRequestEntity.getter("FICode");
String PymtGwRefNo = uppPaymentRequestEntity.getter("PymtGwRefNo");
String TxnStatDetCde = uppPaymentRequestEntity.getter("TxnStatDetCde");
String TxnStatMsg = uppPaymentRequestEntity.getter("TxnStatMsg");
String ServiceID = uppPaymentRequestEntity.getter("ServiceID");
String MerchHostID = uppPaymentRequestEntity.getter("MerchHostID");
String MerchSessionID = uppPaymentRequestEntity.getter("MerchSessionID");
String MerchRefNo = uppPaymentRequestEntity.getter("MerchRefNo");
String OrderRefNo = uppPaymentRequestEntity.getter("OrderRefNo");
String QueryStatus = uppPaymentRequestEntity.getter("QueryStatus");
String FPXRefNo = uppPaymentRequestEntity.getter("FPXRefNo");
String UppPymtMode = uppPaymentRequestEntity.getter("UppPymtMode");
String OrigRespCode = uppPaymentRequestEntity.getter("OrigRespCode");
String ExporigTxnAmt = uppPaymentRequestEntity.getter("ExporigTxnAmt");
.....
步骤 4:指明属性文件位置
商家必须使用 PropertiesReader
指明 PayMaster 属性文件的位置。
步骤 5:将值分配给支付请求实体
商家需将值分配给 PayMaster 请求实体。商家代码必须包含示例代码中指定的所有字段,因为这些字段是必填的。
- 使用 setter 函数分配值,该函数接受两个参数 –
setter(参数名称, 参数值)
。
步骤 6:调用 Web Service 支付请求
一旦分配了所有必填值,商家调用 Web Service 支付请求消息生成器,使用 buildUPPPaymentQueryRequest
函数。
- 支付查询请求消息将生成并提交给 PayMaster 网关。
- 从 PayMaster 网关收到的查询响应将被消息化,并重新分配到 PayMaster 请求实体中。
步骤 7:从 PayMaster 请求实体检索值
商家可以再次使用相同的 PayMaster 请求实体来检索查询响应的信息。
- 使用 getter 函数检索值,该函数只接受一个参数 –
getter(参数名称)
。
请参阅 OBW 支付查询 了解 PayMaster 商家插件(MPI)支持的字段。
步骤 1:库
商家应将 PayMaster 商家插件(MPI)PHP 库 PayMaster.phar 包含到商家应用程序中。
步骤 2:商家代码
对于 UPP 支付查询,商家应将以下内容导入商家代码中:
PropertiesReader
- 用于读取属性文件。PayMasterEntity
– 用于为 PayMaster UPP 支付查询分配所有可接受的值。WebServicePaymentRequestMessageBuilder
– 用于生成 PayMaster UPP 支付查询请求消息。
步骤 3:源代码
<?php
use com\PayMaster\Entities\PayMasterEntity;
use com\PayMaster\PropertiesReader\PropertiesReader;
use com\PayMaster\MessageRequestBuilder\WebServicePaymentRequestMessageBuilder;
use com\PayMaster\Import\ImportFile;
//Merchant to locate the absolute path of PayMaster.phar
$basePath = 'phar://<PayMaster.phar path>/';
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("./PayMasterProperties/","UPPPayment.ini");
//Declare variable for Payment Master Entity
$paymentRequestEntity = new PayMasterEntity();
//Get response message from PayMaster and set into Payment Master Entity
$paymentRequestEntity->setter("PaymentID", "U02");
$paymentRequestEntity->setter("MerchantID", "000010000099939");
$paymentRequestEntity->setter("ServiceID", "FNX");
$paymentRequestEntity->setter("MerchRefNo", "MYB2023030315435025LL");
$paymentRequestEntity->setter("QueryRespURL", "https://XXX.XXXXX.XXX/query.jsp");
//Call Payment Master Payment Response Message Builder to set value
$WebServicePaymentRequestMessageBuilder = new WebServicePaymentRequestMessageBuilder();
$paymentMessage = $WebServicePaymentRequestMessageBuilder->buildUPPQueryRequestMessage($paymentRequestEntity, $propertiesReader);
$MerchantID = $paymentRequestEntity->getter("MerchantID");
$CardNo = $paymentRequestEntity->getter("CardNo");
$TxnDtTm = $paymentRequestEntity->getter("TxnDtTm");
$TxnAmt = $paymentRequestEntity->getter("TxnAmt");
$TxnStatus = $paymentRequestEntity->getter("TxnStatus");
$CurrCode = $paymentRequestEntity->getter("CurrCode");
$AuthIDRespCode = $paymentRequestEntity->getter("AuthIDRespCode");
$ExpTxnAmt = $paymentRequestEntity->getter("ExpTxnAmt");
$RetrievalRefNo = $paymentRequestEntity->getter("RetrievalRefNo");
$OrgRespCode = $paymentRequestEntity->getter("OrgRespCode");
$OrigTxnAmt = $paymentRequestEntity->getter("OrigTxnAmt");
$OrigCurrCode = $paymentRequestEntity->getter("OrigCurrCode");
$TxnChannel = $paymentRequestEntity->getter("TxnChannel");
$FICode = $paymentRequestEntity->getter("FICode");
$PymtGwRefNo = $paymentRequestEntity->getter("PymtGwRefNo");
$TxnStatDetCde = $paymentRequestEntity->getter("TxnStatDetCde");
$TxnStatMsg = $paymentRequestEntity->getter("TxnStatMsg");
$ServiceID = $paymentRequestEntity->getter("ServiceID");
$MerchHostID = $paymentRequestEntity->getter("MerchHostID");
$MerchSessionID = $paymentRequestEntity->getter("MerchSessionID");
$MerchRefNo = $paymentRequestEntity->getter("MerchRefNo");
$OrderRefNo = $paymentRequestEntity->getter("OrderRefNo");
$QueryStatus = $paymentRequestEntity->getter("QueryStatus");
$FPXRefNo = $paymentRequestEntity->getter("FPXRefNo");
$UppPymtMode = $paymentRequestEntity->getter("UppPymtMode");
$OrigRespCode = $paymentRequestEntity->getter("OrigRespCode");
$ExporigTxnAmt = $paymentRequestEntity->getter("ExporigTxnAmt");
.....
步骤 4:定位绝对路径
商家需在商家源代码中找到 PayMaster.phar 的绝对路径(如上例中的第 7 行作为 basePath)。
示例: $basePath=’phar://<PayMaster.phar 的绝对路径>/’
步骤 5:分配值给 PayMaster 请求实体
商家需分配值给 PayMaster 请求实体。商家代码必须包含示例代码中的所有字段,因为这些字段是必填的。
- 使用 setter 函数分配值,该函数接受两个参数 –
setter(参数名称, 参数值)
。
步骤 6:调用 Web 服务支付请求
一旦分配了所有必填值,商家将使用 buildUPPPaymentQueryRequest
函数调用 Web 服务支付请求消息生成器。
- 支付查询请求消息将生成并提交给 PayMaster 网关。
- 从 PayMaster 网关收到的查询响应将被消息化,并重新分配到 PayMaster 请求实体中。
步骤 7:从 PayMaster 请求实体检索值
商家可以再次使用相同的 PayMaster 请求实体来检索查询响应的信息。
- 使用 getter 函数检索值,该函数只接受一个参数 –
getter(参数名称)
。
请参阅 OBW 支付查询 了解 PayMaster 商家插件(MPI)支持的字段。
步骤 1:包
商家应将 PayMaster 商家插件(MPI)Python 包设置并包含到商家应用程序中。
步骤 2:导入
对于 UPP 支付查询,商家应将以下内容导入商家代码中:
PropertiesReader
– 用于读取属性文件。PayMasterEntity
– 用于为 PayMaster UPP 支付查询分配所有可接受的值。WebServicePaymentRequestMessageBuilder
– 用于生成 PayMaster UPP 支付查询请求消息。
步骤 3:源代码
from com.PayMaster.Entities.PayMasterEntity import PayMasterEntity
from com.PayMaster.PropertiesReader.PropertiseReader import PropertiseReader
from com.PayMaster.MessageRequestBuilder.WebServicePaymentRequestMessageBuilder import WebServicePaymentRequestMessageBuilder
##Declare variable for Payment Master Properties - 1st Parameter = File Path , 2nd Parameter = File name
PropertiesReader = PropertiesReader("UPPPayment.properties","PayMasterProperties/")
##Declare variable for Payment Master Entity
uppPaymentRequestEntity = PayMasterEntity()
##Get all the parameter value from the user side and set into Payment Master Entity
uppPaymentRequestEntity.setter("PaymentID", "U02")
uppPaymentRequestEntity.setter("MerchantID", "000010000099939")
uppPaymentRequestEntity.setter("ServiceID", "FNX")
uppPaymentRequestEntity.setter("MerchRefNo", "MYB2023030315435025LL")
uppPaymentRequestEntity.setter("QueryRespURL", "https://XXX.XXXXX.XXX/query.jsp")
##Call Payment Master Web Service Payment Request Message Builder for upp query request
uppMessageBuilder = WebServicePaymentRequestMessageBuilder()
uppMessageBuilder.buildUPPPaymentQueryRequest(uppPaymentRequestEntity, propertiesReader)
MerchantID = uppPaymentRequestEntity.getter("MerchantID")
CardNo = uppPaymentRequestEntity.getter("CardNo")
TxnDtTm = uppPaymentRequestEntity.getter("TxnDtTm")
TxnAmt = uppPaymentRequestEntity.getter("TxnAmt")
TxnStatus = uppPaymentRequestEntity.getter("TxnStatus")
CurrCode = uppPaymentRequestEntity.getter("CurrCode")
AuthIDRespCode = uppPaymentRequestEntity.getter("AuthIDRespCode")
ExpTxnAmt = uppPaymentRequestEntity.getter("ExpTxnAmt")
RetrievalRefNo = uppPaymentRequestEntity.getter("RetrievalRefNo")
OrgRespCode = uppPaymentRequestEntity.getter("OrgRespCode")
OrigTxnAmt = uppPaymentRequestEntity.getter("OrigTxnAmt")
OrigCurrCode = uppPaymentRequestEntity.getter("OrigCurrCode")
TxnChannel = uppPaymentRequestEntity.getter("TxnChannel")
FICode = uppPaymentRequestEntity.getter("FICode")
PymtGwRefNo = uppPaymentRequestEntity.getter("PymtGwRefNo")
TxnStatDetCde = uppPaymentRequestEntity.getter("TxnStatDetCde")
TxnStatMsg = uppPaymentRequestEntity.getter("TxnStatMsg")
ServiceID = uppPaymentRequestEntity.getter("ServiceID")
MerchHostID = uppPaymentRequestEntity.getter("MerchHostID")
MerchSessionID = uppPaymentRequestEntity.getter("MerchSessionID")
MerchRefNo = uppPaymentRequestEntity.getter("MerchRefNo")
OrderRefNo = uppPaymentRequestEntity.getter("OrderRefNo")
QueryStatus = uppPaymentRequestEntity.getter("QueryStatus")
FPXRefNo = uppPaymentRequestEntity.getter("FPXRefNo")
UppPymtMode = uppPaymentRequestEntity.getter("UppPymtMode")
OrigRespCode = uppPaymentRequestEntity.getter("OrigRespCode")
ExporigTxnAmt = uppPaymentRequestEntity.getter("ExporigTxnAmt")
步骤 4:指示 PayMaster 属性文件位置
商家必须使用 PropertiesReader
指示 PayMaster 属性文件的位置。
步骤 5:将值分配给 PayMaster 请求实体
商家需要将值分配给 PayMaster 请求实体。商家代码必须包含示例代码中的所有字段,因为这些字段是必填的。
- 使用 setter 函数分配值,该函数接受两个参数 –
setter(参数名称, 参数值)
。
步骤 6:调用 Web 服务支付请求
一旦分配了所有必填值,商家将使用 buildUPPPaymentQueryRequest
函数调用 Web 服务支付请求消息生成器。
- 支付查询请求消息将生成并提交给 PayMaster 网关。
- 从 PayMaster 网关收到的查询响应将被消息化,并重新分配到 PayMaster 请求实体中。
步骤 7:从 PayMaster 请求实体检索值
商家可以再次使用相同的 PayMaster 请求实体来检索查询响应的信息。
- 使用 getter 函数检索值,该函数只接受一个参数 –
getter(参数名称)
。
请参阅 OBW 支付查询 了解 PayMaster 商家插件(MPI)支持的字段。
步骤 1:库
商家应在商家应用程序中设置并包含 PayMaster 商家插件(MPI)NodeJS 库。
步骤 2:源代码
var paymaster = require('./js/PayMaster.min.js');
module.exports = function (app) {
app.get('/UPPQuery', (req, res)=>{
paymaster.setter('PaymentID', 'U02');
paymaster.setter('MerchantID', '000010000099939');
paymaster.setter('ServiceID', 'FNX');
paymaster.setter('MerchRefNo', 'MYB2023030315435025LL');
paymaster.setter('QueryRespURL', 'https://XXX.XXXXX.XXX/query.jsp');
payment.MERCH_UPPPaymentQueryRequest(paymaster.PaymasterRequestEntity, paymaster.propDetails, function(err, response, result){
if(err){
throw err;
}
if(response){
var MerchantID = paymaster.getter('MerchantID');
var CardNo = paymaster.getter('CardNo');
var TxnDtTm = paymaster.getter('TxnDtTm');
var TxnAmt = paymaster.getter('TxnAmt');
var TxnStatus = paymaster.getter('TxnStatus');
var CurrCode = paymaster.getter('CurrCode');
var AuthIDRespCode = paymaster.getter('AuthIDRespCode');
var ExpTxnAmt = paymaster.getter('ExpTxnAmt');
var RetrievalRefNo = paymaster.getter('RetrievalRefNo');
var OrgRespCode = paymaster.getter('OrgRespCode');
var OrigTxnAmt = paymaster.getter('OrigTxnAmt');
var OrigCurrCode = paymaster.getter('OrigCurrCode');
var TxnChannel = paymaster.getter('TxnChannel');
var FICode = paymaster.getter('FICode');
var PymtGwRefNo = paymaster.getter('PymtGwRefNo');
var TxnStatDetCde = paymaster.getter('TxnStatDetCde');
var TxnStatMsg = paymaster.getter('TxnStatMsg');
var ServiceID = paymaster.getter('ServiceID');
var MerchHostID = paymaster.getter('MerchHostID');
var MerchSessionID = paymaster.getter('MerchSessionID');
var MerchRefNo = paymaster.getter('MerchRefNo');
var OrderRefNo = paymaster.getter('OrderRefNo');
var QueryStatus = paymaster.getter('QueryStatus');
var FPXRefNo = paymaster.getter('FPXRefNo');
var UppPymtMode = paymaster.getter('UppPymtMode');
var OrigRespCode = paymaster.getter('OrigRespCode');
var ExporigTxnAmt = paymaster.getter('ExporigTxnAmt');
}
});
.....
});
}
步骤 3:指示 PayMaster 属性文件
商家需要使用 PropertiesReader
指定 PayMaster 属性文件的位置。
步骤 4:为所有字段分配值
商家代码必须包含并为所有字段分配值,如示例代码所述,因为这些字段是必填的。
- 使用 setter 函数分配值,该函数接受两个参数 –
setter(参数名称, 参数值)
。
步骤 5:向 PayMaster 提交支付请求
MERCH_UppPaymentQueryRequest()
函数用于生成并向 PayMaster 提交支付请求消息。
步骤 6:PayMaster 返回的响应参数
PayMaster 返回的响应参数将由 PayMaster MPI NodeJS 进行消息化。
步骤 7:检索支付查询响应参数的值
商家可以检索支付查询响应参数的值。
- 使用 getter 函数检索值,该函数只接受一个参数 –
getter(参数名称)
。
请参阅 OBW 支付查询 了解 PayMaster 商家插件(MPI)支持的字段。