Status Inquiry - API GPN

10min

Tentang API GPN Status Inquiry 
﻿
Integrasi 
﻿ Status Inquiry pada 
﻿ diperlukan supaya 
﻿ dapat memeriksa 
﻿ 
﻿ berlangsung pada 
﻿ 
﻿ dengan 
﻿ success, fail, dan lainnya. Sehingga, 
﻿ dapat memiliki laporan mengenai 
﻿ tersebut.
﻿
API GPN Status Inquiry 
﻿

Integrasi Status Inquiry pada 
﻿ bertujuan supaya 
﻿ dapat terhubung dengan 
﻿ 
﻿ untuk melakukan pemeriksaan 
﻿ pada 
﻿ 
﻿ 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 GPN﻿.
Notification Handling sangat berguna untuk meminimalisir terjadinya Fraud. Kami sangat menganjurkan 
﻿ untuk melakukan verifikasi Notification Handling. 
﻿ dapat membaca 
﻿ lebih rinci mengenai Notification Handling pada Notification - API GPN﻿.
﻿
Request Parameter for GPN Status Inquiry  

﻿
Berikut ini adalah daftar 
﻿ untuk melakukan request 
﻿ inquiry pada 
﻿ 
﻿ 
﻿. 
Parameter
Tipe
Ukuran
Deskripsi
Contoh/Catatan
timeStamp
﻿Required
N
14
Request Timestamp (YYYYMMDDHH24MISS)
20221114114338
tXid
Required
﻿
AN
30
Transaction ID
IONPAYTEST01202212071629087180
iMid
﻿Required
﻿
AN
10
﻿
﻿ ID
IONPAYTEST
referenceNo
Required
﻿
ANS
40
﻿
﻿ Order Number
815123412341
amt
Required
﻿
N
12
Transaction Amount	
10000
merchantToken
Required
﻿
AN
255
﻿
﻿ Token
4b11d820b0d2ef509715e7b923430643416efc0df4ca2ba2d4b66eb549e074bd
﻿
Response Parameter for GPN 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﻿ 
paid
tXid 
AN
30
Transaction ID
IONPAYTEST01202212071629087180
iMid 
AN
10
﻿
﻿ ID
IONPAYTEST
referenceNo
ANS
40
﻿
﻿ Reference Number
815123412341
payMethod 
N
2
﻿Payment Method Code﻿ 
09
amt 
N
12
﻿
﻿ Amount
10000
CancelAmt
N
12
Cancel Amount
null
reqDt 
N
8
Transaction Request Date (YYYYMMDD)
20221207
reqTm 
N
6
Transaction Request Time (HH24MISS)
162908
transDt 
N
8
Transaction Date (YYYYMMDD)
20221207
transTm 
N
6
Transction Time (HH24MISS)
162908
depositDt
N
8
Transaction Deposit Date (YYYYMMDD)
null
depositTm
N
6
Transaction Deposit Time (HH24MISS)
null
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﻿﻿
0
instmntType
N
2
﻿Installment Type Code﻿ 
1
instmntMon
N
2
Installment Month
1
cardNo
N
20
Card Number
62210082****0590
preauthToken
AN
64
Pre-Auth Token
null
issuBankCd
A
4
﻿Issuing Bank Code﻿ 
OTHR
acquBankCd
A
4
﻿Acquiring Bank Code﻿ 
BNIN
vacctValidDt
N
8
VA Expiry Date (YYYYMMDD)
null
vacctValidTm
N
6
VA Expiry Time (HH24MISS)
null
vacctNo
N
20
VA Number
null
bankCd
A
4
﻿Bank Code﻿ 
null
payNo
N
12
﻿
﻿ Number
null
mitraCd
A
4
﻿Mitra Code﻿ 
null
receiptCode
ANS
20
Authorization Number
null
recurringToken
AN
255
Recurring Token (Needed for Recurring 
﻿)
null
ccTransType
N
2
﻿Credit Card Transaction Type﻿﻿
1
payValidDt
N
8
CVS Expiry Date (YYYYMMDD) (CVS)
null
payValidTm
N
6
CVS Expiry Time (HH24MISS) (CVS)
null
mRefNo
AN
20
﻿
﻿ Reference Number (
﻿)
null
acquStatus
N
2
Status 
﻿ Acquiring
20
cardExpYymm
N
4
Card Expiry (YYMM)
2612
acquBankNm
A
255
Acquiring 
﻿ Name
BNI
issuBankNm
A
255
Issuing 
﻿ Name
OTHER
paymentExpDt
N
6
QR 
﻿ Expiry Date (YYYYMMDD)
null
paymentExpTm
N
6
QR 
﻿ Expiry Time (HH24MISS)
null
paymentTrxSn
AN
32
﻿
﻿ Transaction Number
null
cancelTrxSn
AN
128
Cancel Transaction Number
null
userId
AN
128
﻿
﻿ User ID Hash
null
shopId
AN
32
Shop ID
null
﻿
Additional Response Parameter for Others Status Inquiry
﻿
Berikut ini adalah 
﻿ daftar response tambahan dari request 
﻿ inquiry pada 
﻿ 
﻿ lainnya. 
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
mitraCd
A
4

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

null
payValidDt
N
8
CVS Expiry Date (YYYYMMDD) (CVS)
null
payValidTm
N
6
CVS Expiry Time (HH24MISS) (CVS)
null
receiptCode
ANS
20
Authorization Code (CVS)
null
mRefNo
AN
20
﻿
﻿ Reference Number (
﻿)
null
﻿
Sample JSON for GPN Status Inquiry 
﻿
JSON Request
JSON Response
Java Request
{
    "tXid": "IONPAYTEST01202212071629087180",
    "iMid": "IONPAYTEST",
    "currency": "IDR",
    "amt": "10000",
    "instmntMon": "1",
    "instmntType": "1",
    "referenceNo": "815123412341",
    "goodsNm": "Test Transaction Nicepay",
    "payMethod": "09",
    "billingNm": "John Doe",
    "reqDt": "20221207",
    "reqTm": "162908",
    "status": "0",
    "resultCd": "0000",
    "resultMsg": "paid",
    "cardNo": "62210082****0590",
    "preauthToken": null,
    "acquBankCd": "BNIN",
    "issuBankCd": "OTHR",
    "vacctValidDt": null,
    "vacctValidTm": null,
    "vacctNo": null,
    "bankCd": null,
    "payNo": null,
    "mitraCd": null,
    "receiptCode": null,
    "cancelAmt": null,
    "transDt": "20221207",
    "transTm": "162908",
    "recurringToken": null,
    "ccTransType": "1",
    "payValidDt": null,
    "payValidTm": null,
    "mRefNo": null,
    "acquStatus": "10",
    "cardExpYymm": "2612",
    "acquBankNm": "BNI",
    "issuBankNm": "OTHER",
    "depositDt": null,
    "depositTm": null,
    "paymentExpDt": null,
    "paymentExpTm": null,
    "paymentTrxSn": null,
    "cancelTrxSn": null,
    "userId": null,
    "shopId": null
}
{
    "tXid": "IONPAYTEST01202212071629087180",
    "iMid": "IONPAYTEST",
    "currency": "IDR",
    "amt": "10000",
    "instmntMon": "1",
    "instmntType": "1",
    "referenceNo": "815123412341",
    "goodsNm": "Test Transaction Nicepay",
    "payMethod": "09",
    "billingNm": "John Doe",
    "reqDt": "20221207",
    "reqTm": "162908",
    "status": "0",
    "resultCd": "0000",
    "resultMsg": "paid",
    "cardNo": "62210082****0590",
    "preauthToken": null,
    "acquBankCd": "BNIN",
    "issuBankCd": "OTHR",
    "vacctValidDt": null,
    "vacctValidTm": null,
    "vacctNo": null,
    "bankCd": null,
    "payNo": null,
    "mitraCd": null,
    "receiptCode": null,
    "cancelAmt": null,
    "transDt": "20221207",
    "transTm": "162908",
    "recurringToken": null,
    "ccTransType": "1",
    "payValidDt": null,
    "payValidTm": null,
    "mRefNo": null,
    "acquStatus": "10",
    "cardExpYymm": "2612",
    "acquBankNm": "BNI",
    "issuBankNm": "OTHER",
    "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)	20221114114338
tXid Required	AN	30	Transaction ID	IONPAYTEST01202212071629087180
iMid Required	AN	10	ID	IONPAYTEST
referenceNo Required	ANS	40	Order Number	815123412341
amt Required	N	12	Transaction Amount	10000
merchantToken Required	AN	255	Token	4b11d820b0d2ef509715e7b923430643416efc0df4ca2ba2d4b66eb549e074bd

Parameter	Tipe	Ukuran	Deskripsi	Contoh/Catatan
resultCd	N	4	Result Code	0000
resultMsg	AN	255	Result Message: Error Code	paid
tXid	AN	30	Transaction ID	IONPAYTEST01202212071629087180
iMid	AN	10	ID	IONPAYTEST
referenceNo	ANS	40	Reference Number	815123412341
payMethod	N	2	Payment Method Code	09
amt	N	12	Amount	10000
CancelAmt	N	12	Cancel Amount	null
reqDt	N	8	Transaction Request Date (YYYYMMDD)	20221207
reqTm	N	6	Transaction Request Time (HH24MISS)	162908
transDt	N	8	Transaction Date (YYYYMMDD)	20221207
transTm	N	6	Transction Time (HH24MISS)	162908
depositDt	N	8	Transaction Deposit Date (YYYYMMDD)	null
depositTm	N	6	Transaction Deposit Time (HH24MISS)	null
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	0
instmntType	N	2	Installment Type Code	1
instmntMon	N	2	Installment Month	1
cardNo	N	20	Card Number	62210082****0590
preauthToken	AN	64	Pre-Auth Token	null
issuBankCd	A	4	Issuing Bank Code	OTHR
acquBankCd	A	4	Acquiring Bank Code	BNIN
vacctValidDt	N	8	VA Expiry Date (YYYYMMDD)	null
vacctValidTm	N	6	VA Expiry Time (HH24MISS)	null
vacctNo	N	20	VA Number	null
bankCd	A	4	Bank Code	null
payNo	N	12	Number	null
mitraCd	A	4	Mitra Code	null
receiptCode	ANS	20	Authorization Number	null
recurringToken	AN	255	Recurring Token (Needed for Recurring )	null
ccTransType	N	2	Credit Card Transaction Type	1
payValidDt	N	8	CVS Expiry Date (YYYYMMDD) (CVS)	null
payValidTm	N	6	CVS Expiry Time (HH24MISS) (CVS)	null
mRefNo	AN	20	Reference Number ( )	null
acquStatus	N	2	Status Acquiring	20
cardExpYymm	N	4	Card Expiry (YYMM)	2612
acquBankNm	A	255	Acquiring Name	BNI
issuBankNm	A	255	Issuing Name	OTHER
paymentExpDt	N	6	QR Expiry Date (YYYYMMDD)	null
paymentExpTm	N	6	QR Expiry Time (HH24MISS)	null
paymentTrxSn	AN	32	Transaction Number	null
cancelTrxSn	AN	128	Cancel Transaction Number	null
userId	AN	128	User ID Hash	null
shopId	AN	32	Shop ID	null

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

Updated 18 Sep 2024

Did this page help you?

Payment - API GPN

Notification - API GPN

Status Inquiry - API GPN

Tentang API GPN Status Inquiry

API GPN Status Inquiry

Request Parameter for GPN Status Inquiry

Response Parameter for GPN Status Inquiry

Additional Response Parameter for Others Status Inquiry

Sample JSON for GPN Status Inquiry

Selamat Datang di NICEPAY DOCS