跳到主要内容

通知参数

Method POST

URL
https://xxx/xxx/xxx.paymentNotiUrl
字段名是否必需类型描述
Signature是String包含消息的签名值。消息的发起者负责生成签名，而消息的接收者必须验证签名，以确保消息的完整性、真实性和不可否认性。

请参考 附录 1
sourceSystem是String消息发起者的系统 ID。

Body​

请参考 嵌入代码对内容进行加密，并在正文前添加消息类型指示符0011。

字段名是否必需类型长度描述示例
msgVer是String8版本数字"1.0"
billerType是String2付款类型"AM" - 自动化机器
callerDeviceType是String2呼叫设备类型."17" - 本地部署停车系统
"18" - 云端停车系统
callerDeviceVer是String8呼叫设备的应用版本数字。"1"
sequenceNo是String16在日历日内系统中唯一的运行消息序列数字，每天从 1 重新开始。"202409288868"
mrn是String40由 POS 系统分配的唯一参考数字，用于识别原始支付交易。"8e8c6e61-f9e4-40f0-a4a5-9e561579c901"
resultCode是String5结果代码"00000"
authIdResp条件的String16仅用于已批准交易的发卡行/银行授权码。消费者应将此代码作为已批准支付交易的参考。"484684"
paymentScheme条件的String2交易的支付方案。"AF" - 蚂蚁金融（支付宝）
"JC" - JCB
"MC" - 万事达卡
"PN" - Paynet（DuitNow）
"UP" - 银联（前称 CUP）
"VS" - Visa
maskedPAN条件的String4返回的掩码 PAN"443322XXX1234"
htr条件的String20主机交易参考
paymentMethod条件的Number2客户选择的最终支付方式，以完成付款。"00" - KPOS 将显示所有可用的支付方式，客户可以选择他们的首选方式进行支付。
"01" - 卡支付
"04" - Duitnow QR 支付（商户呈现）
"08" - Alipay+ QR 支付（商户呈现）
advMsg可选String1000来自 KPOS 的建议消息。"..."

示例请求和响应主体​

从主体中移除消息类型指示符 0025 并解密内容.

解密之前
0025eyJlcGsiOnsia3R5IjoiRUMiLCJjcnYiOiJQLTI1NiIsImtpZCI6ImU4NmQ0Y2ZiLTFkNzMtNDJkNi05MGVlLWRlNWJlNjcwMjVlOSIsIngiOiI0UmxIeDAzX3ZlTURWaGFaTl91TVppZ2YzV1dPWGlveG52Zy1rRXhyMzFrIiwieSI6ImcyU1VqNkJnVHdYakxWYWlTRnVobGtSWklrMndaWlNaMWJEWG1DSTZSVXcifSwia2lkIjoiMTIzIiwiZW5jIjoiQTI1NkNCQy1IUzUxMiIsImFsZyI6ImRpciJ9..UIzHIjrFX8fPX91SEUzZpA.9hmtgLHx_UZjYTwduAtdruZB60QPRPjvczVeJwSI7tomXmEU720zuokvMdf9VxQqHOh2PHvtTtqW8OZQuIqYyDmss06ii-fy73a897AJv2KXPARY6DduoiLSJwDCJKhBiJlnZkAMyRZdB5xGzJwXL21QaXbO86EF6_d9qzrOhQvrNlfkTOBQYnv5Mhnnetda0_zm59HRMW2mg-rEOGj1W0Q4U0I8ZZrXQSxO3MnalxuzWQ4oTU2uHZrFnsyL93PeKiG_RmIszQGXqG0bN8WsoJfL0BTd20rnxldLQcSZYNdxGJw0EBGwlSp7DTpcmP1kzd1v2PzLGISZiPa9zadcVuLaODBZQ5GdHoPgIi76pTRwDJrv1CuD8ugfuuu_L5DxFIErnqs5cTONqxhCQ23ZeCSbnuDJDJju9yyr2wYoFFKQQciZmPddPgi2phew31DRjju4y4Ab6H7Vv01gqk6h2b9clR7v54wZSvR0CVROLZj79nKM1eLDhEo8JEv6T5APb2EHMTaU-sIlT-XqENbwV-A5HSEuEdvU7K3fsgioU5qJWwk9SS1WWmyqHnvCK1Rl5azJcKbfyN07a7znZD66IAoSUoCHjsqmFC4bd6ckdLA.Q3Ys35PhzHsnNnlJQ3rzwR-RsfEmYeDxXDsw9h97Azo
移除消息类型指示符并解密后
{
    "msgVer": "1.0",
    "billerType": "AM",
    "callerDeviceType": "17",
    "callerDeviceVer": "1",
    "sequenceNo": "2022091511262185",
    "mrn": "000000",
    "resultCode": "8e8c6e61-f9e4-40f0-a4a5-9e561579c901",
    "authIdResp": "484684",
    "paymentScheme": "AM",
    "maskedPAN": "443322XXX1234",
    "htr": "",
    "paymentMethod": "00"
}

示例消息​

POST 请求
curl -X POST "https://xxx/xxx/xxx.paymentNotiUrl" \
 -H "Accept: application/json" \
 -H "Content-Type: text/plain" \
 -H "Signature: ..." \
 -H "sourceSystem: ..." \
 -d '0025eyJlcGsiOnsia3R5IjoiRUMiLCJ...'

© 2025 Finexus Group。版权所有。