Status Inquiry - API Convenience Store

10 min

Tentang API Convenience Store Status Inquiry
﻿
﻿﻿ Status Inquiry untuk ﻿ diperlukan untuk ﻿ untuk memeriksa kembali ﻿ ﻿ ﻿ ﻿ dilakukan ﻿, baik ber﻿ success, fail, dan lainnya. Sehingga, ﻿ mendapatkan laporan mengenai ﻿ atau ﻿ ﻿ tersebut.
﻿
API Convenience Store Status Inquiry
﻿

﻿ Status Inquiry pada ﻿ bertujuan untuk ﻿ dapat terhubung dengan ﻿ ﻿ ﻿ digunakan untuk melakukan pemeriksaan ﻿ ﻿ ﻿ secara berkala.

API Endpoint
/nicepay/direct/v2/inquiry
Request Method
﻿POST﻿
Description
Performs Inquiry Request to ﻿ for Status Checking
Merchant Token
SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)
Request Format
application/json
Ketika ﻿ diterima dbProcessUrl ﻿, kami sangat menganjurkan ﻿ untuk melakukan verifikasi ﻿ tersebut dengan menggunakan Status Inquiry - API Convenience Store﻿.
Notification Handling sangat berguna untuk meminimalisir terjadinya Fraud. Kami sangat menganjurkan ﻿ untuk melakukan verifikasi Notification Handling melalui Notification - API Convenience Store﻿.
﻿
Request Parameter for Convenience Store Status Inquiry 
﻿

Berikut ini adalah daftar ﻿ untuk melakukan request ﻿ inquiry pada ﻿ ﻿ ﻿. 
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
timeStamp
﻿Required
N
14
Request Timestamp (YYYYMMDDHH24MISS)
20170708123456
tXid
Required
﻿
AN
30
Transaction ID
IONPAYTEST00202212091011228108
iMid
﻿Required
﻿
AN
10
﻿﻿ ID
IONPAYTEST
referenceNo
Required
﻿
ANS
40
﻿﻿ Order Number
ORDER20221012080918
amt
Required
﻿
N
12
Transaction Amount	
1
merchantToken
Required
﻿
AN
255
﻿﻿ Token
666b397e7bce1d65e2cc553205ebab7330f9b2da8293b02c342279c1b6999ceb
﻿
Response Parameter for Convenience Store Status Inquiry
﻿
Berikut ini adalah daftar response dari request ﻿ inquiry pada ﻿ ﻿ ﻿. 
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
resultCd
N
4
﻿Result Code﻿ 
0000
resultMsg
AN
255
Result Message: Error Code﻿ 
unpaid
tXid
AN
30
Transaction ID
IONPAYTEST00202212091011228108
iMid
AN
10
﻿﻿ ID
IONPAYTEST
referenceNo
ANS
40
﻿﻿ Reference Number
ORDER20221012080918
payMethod
N
2
﻿Payment Method Code﻿ 
03
amt
N
12
﻿﻿ Amount
1
CancelAmt
N
12
Cancel Amount
﻿
reqDt
N
8
Transaction Request Date (YYYYMMDD)
20221209
reqTm
N
6
Transaction Request Time (HH24MISS)
101122
transDt
N
8
Transaction Date (YYYYMMDD)
﻿
transTm
N
6
Transaction Time (HH24MISS)
﻿
depositDt
N
8
Transaction Deposit Date (YYYYMMDD)
﻿
depositTm
N
6
Transaction Deposit Time (HH24MISS)
﻿
currency
A
3
Currency
IDR
goodsNm
AN
100
Goods Name
Test Transaction ﻿ 
billingNm
A
100
Buyer Name
John Doe
status
N
1
﻿Payment Status Code﻿﻿
3
﻿
Additional Response Parameter for Others Status Inquiry
﻿
Berikut ini adalah ﻿ daftar respon tambahan dari request ﻿ inquiry pada ﻿ ﻿ lainnya. 
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
mitraCd
A
4

Mitra Code﻿ (CVS, ﻿, ﻿, ﻿)
ALMA
payNo
N
12
CVS Number (CVS)

9041091011228108
payValidDt
N
8
CVS Expiry Date (YYYYMMDD) (CVS)
20221216
payValidTm
N
6
CVS Expiry Time (HH24MISS) (CVS)
235959
receiptCode
ANS
20
Authorization Code (CVS)

﻿
mRefNo
AN
20
﻿﻿ Reference Number (﻿)
﻿
﻿
Sample JSON for Convenience Store Status Inquiry
﻿
JSON Request
JSON Response
Java Request
{
    "tXid": "IONPAYTEST00202212091011228108",
    "iMid": "IONPAYTEST",
    "currency": "IDR",
    "amt": "1",
    "instmntMon": null,
    "instmntType": "1",
    "referenceNo": "ORDER20221012080918",
    "goodsNm": "Test Transaction Nicepay",
    "payMethod": "03",
    "billingNm": "John Doe",
    "reqDt": "20221209",
    "reqTm": "101122",
    "status": "3",
    "resultCd": "0000",
    "resultMsg": "unpaid",
    "cardNo": null,
    "preauthToken": null,
    "acquBankCd": null,
    "issuBankCd": null,
    "vacctValidDt": null,
    "vacctValidTm": null,
    "vacctNo": null,
    "bankCd": null,
    "payNo": "9041091011228108",
    "mitraCd": "ALMA",
    "receiptCode": null,
    "cancelAmt": null,
    "transDt": "20221209",
    "transTm": "101122",
    "recurringToken": null,
    "ccTransType": null,
    "payValidDt": "20221216",
    "payValidTm": "235959",
    "mRefNo": null,
    "acquStatus": null,
    "cardExpYymm": null,
    "acquBankNm": null,
    "issuBankNm": null,
    "depositDt": null,
    "depositTm": null,
    "paymentExpDt": null,
    "paymentExpTm": null,
    "paymentTrxSn": null,
    "cancelTrxSn": null,
    "userId": null,
    "shopId": null
}
{
    "tXid": "IONPAYTEST00202212091011228108",
    "iMid": "IONPAYTEST",
    "currency": "IDR",
    "amt": "1",
    "instmntMon": null,
    "instmntType": "1",
    "referenceNo": "ORDER20221012080918",
    "goodsNm": "Test Transaction Nicepay",
    "payMethod": "03",
    "billingNm": "John Doe",
    "reqDt": "20221209",
    "reqTm": "101122",
    "status": "3",
    "resultCd": "0000",
    "resultMsg": "unpaid",
    "cardNo": null,
    "preauthToken": null,
    "acquBankCd": null,
    "issuBankCd": null,
    "vacctValidDt": null,
    "vacctValidTm": null,
    "vacctNo": null,
    "bankCd": null,
    "payNo": "9041091011228108",
    "mitraCd": "ALMA",
    "receiptCode": null,
    "cancelAmt": null,
    "transDt": "20221209",
    "transTm": "101122",
    "recurringToken": null,
    "ccTransType": null,
    "payValidDt": "20221216",
    "payValidTm": "235959",
    "mRefNo": null,
    "acquStatus": null,
    "cardExpYymm": null,
    "acquBankNm": null,
    "issuBankNm": null,
    "depositDt": null,
    "depositTm": null,
    "paymentExpDt": null,
    "paymentExpTm": null,
    "paymentTrxSn": null,
    "cancelTrxSn": null,
    "userId": null,
    "shopId": null
}
﻿
﻿

API Endpoint	/nicepay/direct/v2/inquiry
Request Method	POST
Description	Performs Inquiry Request to for Status Checking
Merchant Token	SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)
Request Format	application/json

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
timeStamp Required	N	14	Request Timestamp (YYYYMMDDHH24MISS)	20170708123456
tXid Required	AN	30	Transaction ID	IONPAYTEST00202212091011228108
iMid Required	AN	10	ID	IONPAYTEST
referenceNo Required	ANS	40	Order Number	ORDER20221012080918
amt Required	N	12	Transaction Amount	1
merchantToken Required	AN	255	Token	666b397e7bce1d65e2cc553205ebab7330f9b2da8293b02c342279c1b6999ceb

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
resultCd	N	4	Result Code	0000
resultMsg	AN	255	Result Message: Error Code	unpaid
tXid	AN	30	Transaction ID	IONPAYTEST00202212091011228108
iMid	AN	10	ID	IONPAYTEST
referenceNo	ANS	40	Reference Number	ORDER20221012080918
payMethod	N	2	Payment Method Code	03
amt	N	12	Amount	1
CancelAmt	N	12	Cancel Amount
reqDt	N	8	Transaction Request Date (YYYYMMDD)	20221209
reqTm	N	6	Transaction Request Time (HH24MISS)	101122
transDt	N	8	Transaction Date (YYYYMMDD)
transTm	N	6	Transaction Time (HH24MISS)
depositDt	N	8	Transaction Deposit Date (YYYYMMDD)
depositTm	N	6	Transaction Deposit Time (HH24MISS)
currency	A	3	Currency	IDR
goodsNm	AN	100	Goods Name	Test Transaction
billingNm	A	100	Buyer Name	John Doe
status	N	1	Payment Status Code	3

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
mitraCd	A	4	Mitra Code (CVS, , , )	ALMA
payNo	N	12	CVS Number (CVS)	9041091011228108
payValidDt	N	8	CVS Expiry Date (YYYYMMDD) (CVS)	20221216
payValidTm	N	6	CVS Expiry Time (HH24MISS) (CVS)	235959
receiptCode	ANS	20	Authorization Code (CVS)
mRefNo	AN	20	Reference Number ()

Registration - API Convenience Store

Notification - API Convenience Store

Status Inquiry - API Convenience Store

Tentang API Convenience Store Status Inquiry

API Convenience Store Status Inquiry

Request Parameter for Convenience Store Status Inquiry

Response Parameter for Convenience Store Status Inquiry

Additional Response Parameter for Others Status Inquiry

Sample JSON for Convenience Store Status Inquiry

Selamat Datang di NICEPAY DOCS