Notification Parameters

Method POST

URL

https://xxx/xxx/xxx.paymentNotiUrl

Request Parameters
Response Parameters

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 0025 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"
`mrn`	Yes	String	40	An unique reference number assigned by POS system to identify the original payment transaction.	"8e8c6e61-f9e4-40f0-a4a5-9e561579c901"
`resultCode`	Yes	String	5	Result code.	"00000"
`authIdResp`	Conditional	String	16	Authorization code from issuer/bank for approved transaction only. The consumer should use this code as the reference to the approved payment transaction.	"484684"
`paymentScheme`	Conditional	String	2	Payment scheme of the transaction.	"AF" - Ant Financial (Alipay) "JC" - JCB "MC" - MasterCard "PN" - Paynet (DuitNow) "UP" - UnionPay (fka CUP) "VS" - Visa
`maskedPAN`	Conditional	String	4	Returned Masked PAN.	"443322XXX1234"
`htr`	Conditional	String	20	Host Transaction Reference.
`paymentMethod`	Conditional	Number	2	The final payment method chosen by the customer to complete the payment.	"00" - KPOS will display all available payment method, the customer can then choose their preferred method to proceed. "01" - Card payment "04" - Duitnow QR payment (Merchant presented) "08" - Alipay+ QR payment (Merchant presented)
`advMsg`	No	String	1000	Advisory message from KPOS.	"..."

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"

Example Request and Response Body

Request
Response

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

Before decryption

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

After remove Message Type Indicator and perform decryption
{
    "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"
}

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

Before encryption
{
  "sequenceNo": "2022091511262185",
  "resultCode": "00000"
}

After encryption and add Message Type Indicator

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

Example Message

Request
Response

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

POST Response
0026eyJlcGsiOnsia3R5IjoiRUMiLCJjcnYiOiJQLTI1NiIsImtpZCI6ImI0YjIxMmM5LTIyNjMtNDAxYi1hZjdkLTMwOWI3MjRlOTEzOSIsIngiOiJvYmx1ZFdKRy1TTWJlakVqY1hlY3Q2dl9zY19ZZExyTzUtWEV2ZGFZQjdNIiwieSI6Il9MaFdTUDRrUUMwSkpWc09GMkJndWpfamc3dFZSMlRRcTctVExoUFZOeFUifSwia2lkIjoiOGM0MDFlYWMtYjM0OS00MDIyLWJhYTItZWNhMmQ3M2I4NTc5IiwiZW5jIjoiQTI1NkNCQy1IUzUxMiIsImFsZyI6ImRpciJ9..L2N0tzgQbvbbqjTa5XFCeA.TIgLgaNOwqFEchw3r0ls75zFL74mWBCJjuQFm7e7a2Ahk83m_xoS47g6m-Y7AewFcGFWBKbb4i0aGKW1moH70g.4JNcfZMyJqQKcadQIfxb224fqiM3MoUQ5ytA7lUQ4Bw

Notification Parameters

Header​

Body​

Example Request and Response Body​

Example Message​

Header

Body

Example Request and Response Body

Example Message