Notification - API Convenience Store

6 min

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
﻿Payment Method Code﻿ 
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
Payment Flag: Notification Match Amount Indicator﻿ 
1
status
A
1
Deposit Status: Notification Status Code﻿ 
0 : Deposit
1 : Reversal
0
instmntType
N
2
﻿Installment Type Code﻿ 
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
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
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
﻿
﻿

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

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	Payment Method Code	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	Payment Flag: Notification Match Amount Indicator	1
status	A	1	Deposit Status: Notification Status Code 0 : Deposit 1 : Reversal	0
instmntType	N	2	Installment Type Code	1
instmntMon	N	2	Installment Month	1

Status Inquiry - API Convenience Store

Cancel - API Convenience Store

Notification - API Convenience Store

Tentang API Convenience Store Notification

Notification Parameter Convenience Store

Sample for Convenience Store Notification

Selamat Datang di NICEPAY DOCS