NICEPAY API
...
Payment API
API Convenience Store

Notification - API Convenience Store

6min

Tentang API Convenience Store Notification





 mengirimkan push notification

dikirim melalui dbProcessUrl

.

harus memastikan tidak melakukan Blacklist IP

dan melakukan Whitelist IP

untuk mendapatkan push notification

hanya dikirim dari server

.

Request Method

POST

Merchant Token

SHA256 ( iMid+ tXid + amt+ merchantKey)

IP

103.20.51.0/24

103.117.8.0/24

User-Agent

User-Agent: Jakarta Commons-HttpClient/3.1



Notification Parameter Convenience Store



Ketika

 diterima pada dbProcessUrl

, kami menyarankan dengan sangat kepada

untuk melakukan verifikasi

kembali menggunakan Status Inquiry - API Convenience Store.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

tXid

N

30

Transaction ID

TNICECV03103202212141459041632

merchantToken

AN

255



 Token

8b5565e793731a1a1c8817c9e42bcbbdc3f5fb6a2785a6e0b19a2d5e3a41a51b

referenceNo

ANS

40



 Order Number

ord0123456

mitraCd

A

4

Mitra Code

ALMA

payMethod

N

2

04

payNo

N

20



 Number

504100002539

payValidTm

N

6

CVS Expiry Time (HH24MISS)

null

payValidDt

N

8

CVS Expiry Date (YYYYMMDD) (CVS)

null

amt

N

12



 Amount

5000

clientUserKey

Mandatory if tokenize

AN

100

User Key, Must be Unique for Each



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

1

status

A

1

Deposit Status: Notification Status Code

0 : Deposit

1 : Reversal

0

instmntType

N

2

1

instmntMon

N

2

Installment Month

1

Merchant Token

 diterima dari Notification,

harus melakukan perbandingan kembali secara internal untuk mencegah

palsu/tidak berlaku.

💡Contoh Kasus:

Misalnya,

 memiliki merchantKey

digunakan untuk melakukan generate token, yaitu 1234. Ketika merchantToken

di-generate

diketahui adalah abcd, sementara merchantToken

didapatkan pada

adalah abdd, maka

tersebut dianggap palsu/tidak berlaku.



Sample for Convenience Store Notification


Sample POST for Convenience Store Notification