Abort Parameters

Method POST

URL

https://xxx.finexusgroup.com/fnx-fintech/sandbox/mqpos-host/api/submit/abort

Request Parameters

Header

Field Name	Required	Type	Description
Signature	Yes	String	Contains the signature value of the message. The message originator is responsible for generating the signature, while the message receiver must verify it to ensure the integrity, authenticity, and non-repudiation of the message . Please refer to Appendix 1.
sourceSystem	Yes	String	The system ID of the message originator.

Body

Please refer to Embed Code to encrypt the content and prepend the Message Type Indicator 0031 to the body.

Field Name	Required	Type	Length	Description	Example
msgVer	Yes	String	8	Version number.	"1.0"
billerType	Yes	String	2	Type of payment.	"AM" - Automated Machine
callerDeviceType	Yes	String	2	Caller device type.	"17" - On-premises Car Parking System "18" - Cloud-based Car Parking System
callerDeviceVer	Yes	String	8	Application version number of the caller device.	"1"
sequenceNo	Yes	String	16	A running message sequence number which unique within system on a calendar day and shall restart from 1 every day.	"202409288868"
sellerId	Yes	String	6	Provided by FINEXUS to identify the seller or taxpayer (the Merchant) for e-Invoice processing. Note: If no e-invoice is available, default to '000000'.	"000000"
mid	Yes	String	15	Merchant ID	"100000"
mrn	Yes	String	50	An unique reference number assigned by POS system to identify the original payment transaction.	"8e8c6e61-f9e4-40f0-a4a5-9e561579c901"
deviceSN	Yes	String	32	Device SN.	"PPXXX72209005XXX"

Response Parameters

Field Name	Required	Type	Length	Description	Example
sequenceNo	Yes	String	16	Sequence number echo from the request.	"1726817309256"
resultCode	Yes	String	5	Result code.	"00000"
advMsg	No	String	1000	Advisory message from KPOS.	"..."

Example Request and Response Body

Request

Encrypt the content and prepend the Message Type Indicator 0031 to the body.

Before encryption

{
    "msgVer": "1.0",
    "billerType": "AM",
    "callerDeviceType": "17",
    "callerDeviceVer": "1",
    "sequenceNo": "2022091511262185",
    "sellerId": "000000",
    "mid": "000010000012XXX",
    "mrn": "2021061414062021078",
    "deviceSN": "PPXXX72209005XXX"
}

After encrytion and add Message Type Indicator

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

Response

Remove the Message Type Indicator 0032 from the body and decrypt the content.

Before decryption

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

After remove Message Type Indicator and perform decryption

{
  "sequenceNo": "2022091511262185",
  "resultCode": "00000",
  "htr": ""
}

Example Message

Request

POST Request

curl -X POST "https://xxx.finexusgroup.com/fnx-fintech/sandbox/mqpos-host/api/submit/abort" \
 -H "Accept: application/json" \
 -H "Content-Type: text/plain" \
 -H "Signature: ..." \
 -H "sourceSystem: ..." \
 -d '0031eyJlcGsiOnsia3R5IjoiRUMiLCJ...'

Response

POST Response

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