---
title: Notification - API Convenience Store
slug: nicepay-api-non-snap-notification-api-convenience-store
description: Informasi tentang API Non-SNAP Payment - Notification - API Convenience Store yang terdapat pada sistem NICEPAY
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/GNbhZcQ3XBInQkEb0kqB8_rdrx9d8diaz-pgm07xfz2-test-1-1.png
icon: {"faIcon":"fa-solid fa-book"}
docTags:
createdAt: 2022-12-01T07:50:13.000Z
---
# Tentang API Convenience Store Notification
***
NICEPAY mengirimkan *push notification* yang dikirim melalui `dbProcessUrl` Merchant. Merchant harus memastikan tidak melakukan Blacklist IP NICEPAY dan melakukan Whitelist IP NICEPAY untuk mendapatkan *push notification* yang hanya dikirim dari server NICEPAY.
| **Request Method** | **POST****** |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Merchant Token** | SHA256 ( `iMid`+ `tXid` + `amt`+ `merchantKey`) |
| **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` |
| **User-Agent** | `User-Agent: Jakarta Commons-HttpClient/3.1` |
# Notification Parameter Convenience Store
***
:::hint{type="info"}
Ketika notifikasi diterima pada `dbProcessUrl` Anda, kami menyarankan dengan sangat kepada Merchant untuk melakukan verifikasi notifikasi kembali menggunakan [Status Inquiry - API Convenience Store](docId\:WMITrWcw3j9ChajRg-o1D).
:::
| **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** |
| ----------------------------------------------------------------------------------------- | -------- | ---------- | ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| `tXid` | N | 30 | Transaction ID | TNICECV03103202212141459041632 |
| `merchantToken` | AN | 255 | Merchant Token | 8b5565e793731a1a1c8817c9e42bcbbdc3f5fb6a2785a6e0b19a2d5e3a41a51b |
| `referenceNo` | ANS | 40 | Merchant Order Number | ord0123456 |
| `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8)
| ALMA |
| `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 04 |
| `payNo` | N | 20 | Payment Number | 504100002539 |
| `payValidTm` | N | 6 | CVS Expiry Time (`HH24MISS`) | null |
| `payValidDt` | N | 8 | CVS Expiry Date (`YYYYMMDD`) (CVS) | null |
| `amt` | N | 12 | Payment Amount | 5000 |
| `clientUserKey`
Mandatory if tokenize
| AN | 100 | User Key, Must be Unique for Each Customer
| 1134431 |
| `userToken` | ANS | | User Token | 12345eea9-6234-6789-12r3-123re3456tt5 |
| `tokenizeUser` | N | 1 | Transaction Tokenize Type
| 1 |
| `transDt` | N | 8 | Transaction Date | 20221214 |
| `transTm` | N | 6 | Transaction Time | 150229 |
| `currency` | A | 3 | Currency | IDR |
| `goodsNm` | AN | 100 | Goods Name | Testing |
| `billingNm` | A | 100 | Billing Name | John-Doe |
| `matchCl` | N | 1 | Payment Flag: [Notification Match Amount Indicator](docId\:WdoGjBeqc1VmRdFJqG1ZE) | 1 |
| `status` | A | 1 | Deposit Status: [Notification Status Code](docId\:CdRwf99UxER6PH64ADA2C)
`0` : Deposit
`1` : Reversal | 0 |
| `instmntType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 1 |
| `instmntMon` | N | 2 | Installment Month | 1 |
:::hint{type="warning"}
*Merchant Token* yang diterima dari *Notification*, Merchant harus melakukan perbandingan kembali secara internal untuk mencegah notifikasi palsu/tidak berlaku.
**💡Contoh Kasus:**
Misalnya, Anda memiliki `merchantKey` yang digunakan untuk melakukan *generate *token, yaitu `1234`. Ketika `merchantToken` yang di-*generate *Merchant diketahui adalah `abcd`, sementara `merchantToken` yang didapatkan pada notifikasi adalah `abdd`, maka notifikasi tersebut dianggap **palsu/tidak berlaku.**
:::
## Sample for Convenience Store Notification
***
:::CodeblockTabs
Sample POST for Convenience Store Notification
```none
merchantToken=8b5565e793731a1a1c8817c9e42bcbbdc3f5fb6a2785a6e0b19a2d5e3a41a51b
goodsNm=Testing
referenceNo=ord0123456
mitraCd=ALMA
transTm=150229
tXid=TNICECV03103202212141459041632
amt=5000
instmntType=1
billingNm=John-Doe
matchCl=1
payNo=504100002539
payValidTm=null
payMethod=03
currency=IDR
instmntMon=1
payValidDt=null
transDt=20221214
status=0
```
:::