Notification - API QRIS SNAP

13 min

Tentang Notification - API QRIS SNAP

API dengan standar SNAP ini digunakan untuk mengirimkan notifikasi transaksi pembayaran pada metode pembayaran QRIS.

Panduan Validasi X-SIGNATURE

Berikut adalah cara untuk melakukan validasi X-SIGNATURE pada Request Header Notify:

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

Informasi khusus API Notifikasi SNAP terkait kredensial Public_Key akan diberikan oleh tim NICEPAY kepada Merchant melalui email, karena kredensial Public_Key yang akan digunakan di API Notifikasi SNAP berbeda dengan API Transaksi SNAP (Registration, Inquiry & Payment).

Silakan menghubungi Tim Integrasi melalui email ([email protected]) untuk informasi atau bantuan lebih lanjut.

Berikut adalah contoh hasil X-SIGNATURE dari cara validasi di atas:

mYyscWBs00bm0TJQ/xY7Uu1Goh8qXJyYSlo88rFrhQ+mlyQkMtq NKMlZDpS+

Merchant Notification - API QRIS SNAP

Service Code	52
API Endpoint	[merchant-domain]/api/v1.0/qr/qr-mpm-notify
HTTP Method	POST
Content-type	application/json
Description	Transaction Result Notification (when success) If your system use firewall, add allow policy for NICEPAY IP = IP Public environtment Production: 103.20.51.34 103.20.51.33 18.98.96.50 IP Public environtment Dev: 103.20.51.39 103.20.51.40 18.98.96.54

Request Header Parameter for Notification - API QRIS SNAP

Parameter	Tipe	Kebutuhan	Deskripsi
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	Signature will be generated by Merchant. Panduan X-Signature - Symmetric

Request Body Parameter for Notification - API QRIS SNAP

Parameter	Tipe	Ukuran	Kebutuhan	Deskripsi
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 Header Parameter for Notification - API QRIS SNAP

Parameter	Tipe	Kebutuhan	Deskripsi
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 Body Parameter for Notification - API QRIS SNAP

Parameter	Tipe	Ukuran	Kebutuhan	Deskripsi
responseCode	String	7	Mandatory	General Response Code and Message - API SNAP
responseMessage	String	150	Mandatory	Response Message

Sample Parameter for Notification - API QRIS SNAP

Request Parameter

curl -X POST \
  '[merchant-domain]/api/v1.0/qr/qr-mpm-notify' \
  -H 'Content-Type: application/json' \
  -H 'X-TIMESTAMP: 2023-11-23T07:44:11+07:00' \
  -H 'X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5' \
  -H 'X-CLIENT-KEY: 82150823919040624621823174737537' \
  -d '{
  "originalReferenceNo": "TNICEQR08108202210141451109841",
  "originalPartnerReferenceNo": "2020102900000000000001",
  "latestTransactionStatus": "00",
  "transactionStatusDesc": "success",
  "amount": {
    "value": "12345678.00",
    "currency": "IDR"
  },
  "externalStoreId": "124928924949487",
  "additionalInfo": {
    "transactionDateTime": "2019-07-03T12:08:56-07:00",
    "paymentTrxSn": "07202210051341224326",
    "userId": "13naUASIQBIH341bdjashf1204gkjbcas"
  }
}'

Response Parameter

{
  "responseCode": "2005200",
  "responseMessage": "Success"
}