支付查询

以下指南旨在解释如何在商户网站或商户应用程序中应用相应的源代码，以形成必要的支付请求参数，商户可以在重定向链接中使用，并发送给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();
messageBuilder.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服务支付请求消息生成器

一旦指定了所有必填值，商户将使用 buildUPPPaymentQueryRequest 函数调用Web服务支付请求消息生成器。

将生成支付查询请求消息并提交给PayMaster网关。
从PayMaster网关接收到的查询响应将被消息化，并重新赋值到PayMaster请求实体中。

步骤 7：从PayMaster请求实体检索值

商户可以使用相同的PayMaster请求实体来检索查询响应的信息。

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

信息

参考UPP支付查询参数获取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服务支付请求

一旦指定了所有必填值，商户将使用 buildUPPPaymentQueryRequest 函数调用Web服务支付请求消息生成器。

将生成支付查询请求消息并提交给PayMaster网关。
从PayMaster网关接收到的查询响应将被消息化，并重新赋值到PayMaster请求实体中。

步骤 7：从PayMaster请求实体检索值

商户可以使用相同的PayMaster请求实体来检索查询响应的信息。

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

信息

参考UPP支付查询参数获取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();
$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 的绝对路径作为 basePath（在上述示例的第7行）。

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

步骤 5：将值分配到 PayMaster 请求实体

商家需要将值分配到 PayMaster 请求实体中。商家代码必须包括示例代码中提到的所有字段，因为这是强制性的。

使用 setter 函数分配值，该函数接受两个参数 – setter(参数名称，参数值)。

步骤 6：调用 Web 服务支付请求

一旦分配了所有强制性值，商家调用 Web 服务支付请求消息生成器的 buildUPPPaymentQueryRequest 函数。

将生成支付查询请求消息并提交给 PayMaster 网关。
从 PayMaster 网关接收到的查询响应将被处理并分配回 PayMaster 请求实体。

步骤 7：从 PayMaster 请求实体检索值

商家可以使用相同的 PayMaster 请求实体来检索查询响应的信息。

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

信息

请参考 UPP 支付查询参数查看 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 服务支付请求

一旦分配了所有必需值，商家调用 Web 服务支付请求消息生成器的 buildUPPPaymentQueryRequest 函数。

将生成支付查询请求消息并提交给 PayMaster 网关。
从 PayMaster 网关接收到的查询响应将被处理并分配回 PayMaster 请求实体。

步骤 7：从 PayMaster 请求实体检索值

商家可以使用相同的 PayMaster 请求实体来检索查询响应的信息。

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

信息

请参考 UPP 支付查询参数查看 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(参数名称)。

信息

请参考 UPP 支付查询参数查看 PayMaster 商家插件（MPI）支持的字段。

支付查询

与我们联系