支付参数

Method POST

URL

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

IsPreauthInd仅适用于信用卡支付。

请求参数

必填字段

字段名称	类型	长度	描述	例子
MsgVer	String	20	版本号。	"1"
PmtType	String	2	付款类型。	"01" - 卡支付
IsPreauthInd	String	1	是否为预授权交易指示符。	"Y" - Yes "N" - No
CallerDeviceType	String	20	呼叫者设备类型。	"04" - 基于网络
Email	String	100	登录到设备的用户电子邮件地址。	"customer123@gmail.com"
DeviceSN	String	20	设备序列号。	"PPXXX72209005XXX"
CallerDeviceVer	String	20	呼叫方设备的应用程序版本号。	"1"
TxnID	String	50	由调用者应用程序分配的唯一事务 ID。	"2021061414062021072"
LocalTxnDTTime	String	14	交易发生的本地日期和时间，格式为 YYYYMMDDhhmmss。	"20200131091025"
AmtTxn	String	12	交易金额。	"100"
CrcyTxn	String	3	原始交易货币数字代码。	"458"
MID	String	15	商户 ID。	"0000100000130XX"
sourceSystem	String	3	频道/来源名称。	"mxx"
sequenceNo	String	16	运行消息序列号，在一个日历日内系统内唯一，每天从 1 重新开始。	"2022091511262180"
signedMessage	String	2048	签名值是从其他字段生成的，然后用 RSA 私钥进行签名。 请参考附录 1。	"..."

可选字段

字段名称	类型	长度	描述	例子
Description	String	256	订单描述。	Coffee
CallerDeviceId	String	32	呼叫者设备 ID。
OptInPrintReceipt	String	1	选择加入打印收据功能。	"Y" - 打印收据按钮可见。 "N" - 打印收据按钮不可见。 默认为"Y"
OptInSendEReceipt	String	1	选择加入发送电子收据功能。	"Y" - 发送电子收据按钮可见。 "N" - 发送电子收据按钮不可见。 默认为"Y"
OptInPmtAckmnt	String	1	选择加入付款确认功能。	"Y" - 将显示付款确认信息。 "N" - 不会显示付款确认信息。 默认为"Y"

响应参数

必填/条件字段

字段名称	类型	长度	描述	例子
MsgVer	String	20	版本号。	"1"
TxnID	String	50	由调用者应用程序分配的唯一事务 ID。	"2021061414062020000"
ResultCode	String	2	MPOS 回复结果码。 详情请参阅附录 3。	"00"
RespCd	String	2	条件字段 获取主机返回的响应。 Please refer to 附录 2 for details.	"00"
OrgRespCd	String	2	条件字段 发卡行/银行的原始响应代码。	"00"
RRN	String	12	条件字段 由收单方主机生成的检索参考号。	"307219058382"
STAN	String	6	条件字段 由主机返回，在结果 Intent 中设置。 原始交易的系统跟踪审计编号。	"58382"
AuthIdResp	String	16	条件字段 发卡机构/银行的授权代码仅适用于已批准的交易。消费者应使用此代码作为已批准的支付交易的参考。	"484684"
MRN	String	40	条件字段 来自收单主机的商户参考号。	"23072AMgLI"
TxnDTTime	String	14	条件字段 交易发生的本地日期和时间，采用 YYYYMMDDMMDDhhmmss 格式。	"20230313190732"
MaskedPAN	String	4	条件字段 返回蒙面 PAN。	"443322******1234"
PaymentScheme	String	20	条件字段 交易的付款方案。	“AF”- 蚂蚁金服（支付宝） “JC”- JCB “MC”- 万事达卡 “PN”- Paynet (DuitNow) “UP”- 银联 (fka CUP) “VS”- Visa
HTR	String	20	条件字段 主机交易参考号 由 ACQ 主机生成的唯一交易参考号。
AdvMsg	String	256	由主机包含以简化支持和问题诊断。
sourceSystem	String	3	频道/来源名称。	"mxx"
sequenceNo	String	16	运行消息序列号，在一个日历日内系统内唯一，每天从 1 重新开始。	"2022091511262180"
signedMessage	String	2048	签名值是从其他字段生成的，然后用 RSA 私钥进行签名。 请参考附录 1。	"..."

消息示例

请求

POST Request

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"
        IsPreauthInd:"01"
        CallerDeviceType:"04"
        Email:"customer123@gmail.com"
        DeviceSN:"PPXXX72209005XXX"
        CallerDeviceVer:"1"
        TxnID:"2021061414062021072"
        LocalTxnDTTime:"20200131091025"
        AmtTxn:"100""
        CrcyTxn:"458"
        MID:"0000100000130XX"
        sourceSystem:"mxx"
        sequenceNo:"2022091511262180"
        signedMessage:""
    }'

响应

POST Response

{
    "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":"",
    "AdvMsg":"",
    "sourceSystem":"mxx",
    "sequenceNo":"2022091511262180",
    "signedMessage":"..."
}