取消支付参数

Method POST

URL

https://xxx.finexusgroup.com/fnx-fintech/xxx/mqpos-host/api/cancel

请求参数
响应参数

字段名	是否必需	类型	描述
`Signature`	是	String	包含消息的签名值。消息的发起者负责生成签名，而消息的接收者必须验证签名，以确保消息的完整性、真实性和不可否认性。请参考附录 1
`sourceSystem`	是	String	消息发起者的系统 ID。

Body

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

字段名	是否必需	类型	长度	描述	示例
`msgVer`	是	String	8	版本数字	"1.0"
`billerType`	是	String	2	付款类型	"PS" - POS 系统
`callerDeviceType`	是	String	2	呼叫设备类型.	"02" - 安卓 EDC/卡支付终端
`callerDeviceVer`	是	String	8	呼叫设备的应用版本数字。	"1"
`sequenceNo`	是	String	16	在日历日内系统中唯一的运行消息序列数字，每天从 1 重新开始。注意: 推荐的格式为 [Terminal ID][消息类型指示符][流水号]。	"20090XX130000001"
`sellerId`	是	String	6	由 FINEXUS 提供，用于识别卖方或纳税人（商户）以进行电子发票处理。注意: 如果没有使用电子发票，请默认使用 '000000'。	"000000"
`mid`	是	String	15	商户 ID	"100000"
`mrn`	是	String	40	在 submit 接口中由 POS 系统发送的 Payment 对象中的 mrn 字段。	"INV2025062410000009"
`cancelMrn`	是	String	40	由 POS 系统分配的唯一参考编号，用于标识取消请求。	"INV2025062410020009"
`currency`	是	Number	3	此交易的 ISO 4217 数字货币代码。	"458"
`refundAmount`	Yes	Number	18	退款金额	"1000"
`invoice`	条件的	Object		用于向 LHDN 提交的发票对象，以用于电子发票。
`cancelReason`	Yes	String	300	Cancellation Reason.	"..."

Field Name	Required	Type	Length	Description	Example
`sequenceNo`	Yes	String	16	从请求回显的序列数字。	"20090XX130000001"
`resultCode`	Yes	String	5	结果代码	"00000"
`advMsg`	No	String	1000	来自 KPOS 的建议消息。	"..."
`issuedInvoiceInd`	Conditional	String	1	此取消请求的最终开具发票文件。	"C" - 已开具贷项通知单。 "R" - 已开具退款通知单。 "N" - 未生成电子发票。
`transactionAction`	Conditional	String	1	用于指示为该交易所触发的操作类型。	"C" - 该交易已被取消。 "R" - 该交易已退款。 "N" - 未执行任何操作。

示例请求和响应主体

请求
响应

加密之前
{
    "msgVer": "1.0",
    "billerType": "PS",
    "callerDeviceType": "02",
    "callerDeviceVer": "1",
    "sequenceNo": "20090XX130000001",
    "sellerId": "000000",
    "mid": "000010000012XXX",
    "mrn": "INV2025062410000009",
    "cancelMrn": "INV2025062410020009",
    "currency": "458",
    "refundAmount": "100",
    "cancelReason": "..."
}

加密之后并添加消息类型指示符

0013eyJlcGsiOnsia3R5IjoiRUMiLCJjcnYiOiJQLTI1NiIsImtpZCI6ImU4NmQ0Y2ZiLTFkNzMtNDJkNi05MGVlLWRlNWJlNjcwMjVlOSIsIngiOiI0UmxIeDAzX3ZlTURWaGFaTl91TVppZ2YzV1dPWGlveG52Zy1rRXhyMzFrIiwieSI6ImcyU1VqNkJnVHdYakxWYWlTRnVobGtSWklrMndaWlNaMWJEWG1DSTZSVXcifSwia2lkIjoiMTIzIiwiZW5jIjoiQTI1NkNCQy1IUzUxMiIsImFsZyI6ImRpciJ9..UIzHIjrFX8fPX91SEUzZpA.9hmtgLHx_UZjYTwduAtdruZB60QPRPjvczVeJwSI7tomXmEU720zuokvMdf9VxQqHOh2PHvtTtqW8OZQuIqYyDmss06ii-fy73a897AJv2KXPARY6DduoiLSJwDCJKhBiJlnZkAMyRZdB5xGzJwXL21QaXbO86EF6_d9qzrOhQvrNlfkTOBQYnv5Mhnnetda0_zm59HRMW2mg-rEOGj1W0Q4U0I8ZZrXQSxO3MnalxuzWQ4oTU2uHZrFnsyL93PeKiG_RmIszQGXqG0bN8WsoJfL0BTd20rnxldLQcSZYNdxGJw0EBGwlSp7DTpcmP1kzd1v2PzLGISZiPa9zadcVuLaODBZQ5GdHoPgIi76pTRwDJrv1CuD8ugfuuu_L5DxFIErnqs5cTONqxhCQ23ZeCSbnuDJDJju9yyr2wYoFFKQQciZmPddPgi2phew31DRjju4y4Ab6H7Vv01gqk6h2b9clR7v54wZSvR0CVROLZj79nKM1eLDhEo8JEv6T5APb2EHMTaU-sIlT-XqENbwV-A5HSEuEdvU7K3fsgioU5qJWwk9SS1WWmyqHnvCK1Rl5azJcKbfyN07a7znZD66IAoSUoCHjsqmFC4bd6ckdLA.Q3Ys35PhzHsnNnlJQ3rzwR-RsfEmYeDxXDsw9h97Azo

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

解密之前

0014eyJlcGsiOnsia3R5IjoiRUMiLCJjcnYiOiJQLTI1NiIsImtpZCI6ImI0YjIxMmM5LTIyNjMtNDAxYi1hZjdkLTMwOWI3MjRlOTEzOSIsIngiOiJvYmx1ZFdKRy1TTWJlakVqY1hlY3Q2dl9zY19ZZExyTzUtWEV2ZGFZQjdNIiwieSI6Il9MaFdTUDRrUUMwSkpWc09GMkJndWpfamc3dFZSMlRRcTctVExoUFZOeFUifSwia2lkIjoiOGM0MDFlYWMtYjM0OS00MDIyLWJhYTItZWNhMmQ3M2I4NTc5IiwiZW5jIjoiQTI1NkNCQy1IUzUxMiIsImFsZyI6ImRpciJ9..L2N0tzgQbvbbqjTa5XFCeA.TIgLgaNOwqFEchw3r0ls75zFL74mWBCJjuQFm7e7a2Ahk83m_xoS47g6m-Y7AewFcGFWBKbb4i0aGKW1moH70g.4JNcfZMyJqQKcadQIfxb224fqiM3MoUQ5ytA7lUQ4Bw

移除消息类型指示符并解密后
{
  "sequenceNo": "20090XX130000001",
  "resultCode": "00000",
  "advMsg": "...",
  "issuedInvoiceInd": "N",
  "transactionAction": "C"
}

示例消息

请求
响应

POST 请求
curl -X POST "https://xxx.finexusgroup.com/fnx-fintech/xxx/mqpos-host/api/cancel" \
 -H "Accept: application/json" \
 -H "Content-Type: text/plain" \
 -H "Signature: ..." \
 -H "sourceSystem: ..." \
 -d '0013eyJlcGsiOnsia3R5IjoiRUMiLCJ...'

POST 响应
0014eyJlcGsiOnsia3R5IjoiRUMiLCJjcnYiOiJQLTI1NiIsImtpZCI6ImI0YjIxMmM5LTIyNjMtNDAxYi1hZjdkLTMwOWI3MjRlOTEzOSIsIngiOiJvYmx1ZFdKRy1TTWJlakVqY1hlY3Q2dl9zY19ZZExyTzUtWEV2ZGFZQjdNIiwieSI6Il9MaFdTUDRrUUMwSkpWc09GMkJndWpfamc3dFZSMlRRcTctVExoUFZOeFUifSwia2lkIjoiOGM0MDFlYWMtYjM0OS00MDIyLWJhYTItZWNhMmQ3M2I4NTc5IiwiZW5jIjoiQTI1NkNCQy1IUzUxMiIsImFsZyI6ImRpciJ9..L2N0tzgQbvbbqjTa5XFCeA.TIgLgaNOwqFEchw3r0ls75zFL74mWBCJjuQFm7e7a2Ahk83m_xoS47g6m-Y7AewFcGFWBKbb4i0aGKW1moH70g.4JNcfZMyJqQKcadQIfxb224fqiM3MoUQ5ytA7lUQ4Bw

取消支付参数

Header​

Body​

示例请求和响应主体​

示例消息​

Header

Body

示例请求和响应主体

示例消息