NICEPAY API
...
Payment API - SNAP
API QRIS SNAP

Notification - API QRIS SNAP

9min

About Notification - API QRIS SNAP



This API with SNAP standards uses to send payment transaction notifications on the QRIS payment method.



X-SIGNATURE Guidance Validation



The following is guidance to proceed X-SIGNATURE validation on Request Header Notify:

SHA256withRSA (Public_Key, stringToSign) stringToSign = client_ID + “|” + X-TIMESTAMP

The following is the example of X-SIGNATURE result from the above guidance validation"

mYyscWBs00bm0TJQ/xY7Uu1Goh8qXJyYSlo88rFrhQ+mlyQkMtq NKMlZDpS+



Merchant Notification - API QRIS SNAP



Service Code

52

API Endpoint

[merchant-domain]/api/v1.0/qr/qr-mpm-notif

HTTP Method

POST

Content-type

application/json

Description

Transaction Result Notification (when success) If your system use firewall, add allow policy for NICEPAY IP

103.20.51.0/24

103.117.8.0/24



Request Notification Header Parameter

Parameter

Type

Required

Description

Content-Type

String

Mandatory

Application / JSON

X-TIMESTAMP

String

Mandatory

Using ISO 8601 as timestamp format.

Transaction date time, in format YYYYMMDDTHH:mm:ss+07:00.

Time must be in GMT+7 (Jakarta time).

2022-03-21T10:11:40+07:00.

X-CLIENT-KEY

String

Mandatory

Unique Partner ID, Partner ID = Client ID

X-SIGNATURE

String

Mandatory

Request message signature

(85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5)



Request Notification Body Parameter

Parameter

Type

Length

Required

Description

originalReferenceNo

String

40

Mandatory

Original transaction identifier on service provider system

originalPartnerReferenceNo

String

40

Mandatory

Original transaction identifier on consumer system

amount

Object

Variable

Mandatory

Amount of transaction

value

String

12

Mandatory

Value

currency

String

3

Mandatory

Currency

latestTransactionStatus

String

2

Mandatory

Category code for the status of the transaction.

Example :

00- Success 05- Cancelled

transactionStatusDesc

String

50

Optional

Description status transaction

externalStoreID

String

32

Mandatory

Unique identifier of shop id in client system

additionalInfo

Object

Variable

Mandatory

Additional information

transactionDateTime

String

25

Optional

Transaction Date Using ISO-8601 Format YYYY-MM-DDTHH:MM:SS

paymentTrxSn

Object

32

Mandatory

Payment Transaction Number from Acquiring side

userId

String

128

Optional

QRIS User ID



Response Notification Header Parameter

Parameter

Type

Required

Description

Content-Type

String

Mandatory

Application / JSON

X-TIMESTAMP

String

Mandatory

Using ISO 8601 as timestamp format.

Transaction date time, in format YYYYMMDDTHH:mm:ss+07:00.

Time must be in GMT+7 (Jakarta time).

2022-03-21T10:11:40+07:00.



Response Notification Body Parameter

Parameter

Type

Length

Required

Description

responseCode

String

7

Mandatory

responseMessage

String

150

Mandatory

Response Message



Sample Post For Notification

Sample Request Notification
Sample Response Notification