支付参数

Method : POST
URL : https://xxx.finexusgroup.com/fnx-fintech/xxx/mqpos-host/thirdparty/paymentAuthorization

请求参数

信息

配置字段 PmtType，用于卡支付和二维码支付选项。

强制字段

字段名称	类型	长度	描述	示例
MsgVer	字符串	20	版本号	"1"
PmtType	字符串	2	付款类型	"01" - 信用卡付款 "04" - Duitnow QR 付款（商家呈现） "08" - 支付宝+ QR 付款（商家呈现）
CallerDeviceType	字符串	20	调用设备类型	"04" - 基于网络
Email	字符串	100	登录设备的用户电子邮件地址	"customer123@gmail.com"
DeviceSN	字符串	20	设备序列号	"PPXXX72209005XXX"
CallerDeviceVer	字符串	20	调用设备的应用程序版本号	"1"
TxnID	字符串	50	调用应用程序分配的唯一交易ID	"2021061414062021072"
LocalTxnDTTime	字符串	14	交易发生的本地日期和时间，格式为YYYYMMDDhhmmss	"20200131091025"
AmtTxn	字符串	12	交易金额	"100"
CrcyTxn	字符串	3	原始交易货币的数字代码	"458"
sourceSystem	字符串	3	渠道/来源名称	"mxx"
sequenceNo	字符串	16	每天在系统内唯一的运行消息序列号，并且每天从1开始重新启动。	"2022091511262180"
signedMessage	字符串	2048	签名值是从其他字段生成的，然后由RSA私钥签名。 请参阅附录1。	"..."

可选字段

字段名称	类型	长度	描述	示例
Description	字符串	256	订单描述	咖啡
OptInPrintReceipt	字符串	1	允许打印收据功能。	"Y" - 显示打印收据按钮。 "N" - 隐藏打印收据按钮。 默认为 "Y"
OptInSendEReceipt	字符串	1	允许发送电子收据功能。	"Y" - 显示发送电子收据按钮。 "N" - 隐藏发送电子收据按钮。 默认为 "Y"
OptInPmtAckmnt	字符串	1	允许付款确认功能。	"Y" - 显示付款确认。 "N" - 隐藏付款确认。 默认为 "Y"

返回参数

必填/有条件的字段

字段名称	类型	长度	描述	示例
MsgVer	字符串	20	版本号	"1"
TxnID	字符串	50	由调用方应用分配的唯一交易ID。	"2021061414062020000"
ResultCode	字符串	2	mPOS 响应的结果代码。 请参阅附录3。	"00"
RespCd	字符串	2	条件性字段 收单主机返回的响应。 请参阅附录2。	"00"
OrgRespCd	字符串	2	条件性字段 发卡行/银行的原始响应代码。	"00"
RRN	字符串	12	条件性字段 由收单主机生成的检索参考号。	"307219058382"
STAN	字符串	6	条件性字段 主机返回的，设置在结果 Intent 中的系统跟踪审核号（原始交易）。	"58382"
AuthIdResp	字符串	16	条件性字段 仅针对已批准的交易的发卡行/银行授权码。消费者应将此代码用作已批准付款交易的参考。	"484684"
MRN	字符串	40	条件性字段 收单主机提供的商户参考号。	"23072AMgLI"
TxnDTTime	字符串	14	条件性字段 交易发生的本地日期和时间，格式为 YYYYMMDDMMDDhhmmss。	"20230313190732"
MaskedPAN	字符串	4	条件性字段 返回掩码化的主帐号。 根据当前的 PCI-DSS 3.2 版本，该字段仅包含用于完成卡付款的卡号/主帐号的前6位和最后4位。	"443322**1234"
PaymentScheme	字符串	20	条件性字段 交易的支付方案。	"VS"
HTR	字符串	20	条件性字段 主机交易参考号。 收单主机生成的唯一交易参考号。
sourceSystem	字符串	3	渠道/来源名称。	"mxx"
sequenceNo	字符串	16	在日历日内系统内唯一的运行消息序列号，每天从1重新开始。	"2022091511262180"
signedMessage	字符串	2048	签名值是从其他字段生成的，然后由 RSA 私钥签名。 请参阅附录1。	"..."

示例消息

请求

POST 请求

curl -X POST "https://xxx.xxx.com/xxx/xxx/mqpos-host/thirdparty/paymentAuthorization" \
 -H "Accept: application/json" \
 -H "Content-Type: application/json" \ 
 -d '{
        MsgVer:"1"
        PmtType:"01"
        CallerDeviceType:"04"
        Email:"customer123@gmail.com"
        DeviceSN:"PPXXX72209005XXX"
        CallerDeviceVer:"1"
        TxnID:"2021061414062021072"
        LocalTxnDTTime:"20200131091025"
        AmtTxn:"100""
        CrcyTxn:"458"
        sourceSystem:"mxx"
        sequenceNo:"2022091511262180"
        signedMessage:""
    }'

响应

POST 响应

{
    "MsgVer":"1",
    "TxnID":"2021061414062020000",
    "ResultCode":"00",
    "RespCd":"00",
    "OrgRespCd":"00",
    "RRN":"307219058382",
    "STAN":"58382",
    "AuthIdResp":"484684",
    "MRN":"23072AMgLI",
    "TxnDTTime":"20230313190732",
    "MaskedPAN":"443322**1234",
    "PaymentScheme":"VS",
    "HTR":"",
    "sourceSystem":"mxx",
    "sequenceNo":"2022091511262180",
    "signedMessage":"..."
}