Status Inquiry - API Checkout

11min

Tentang Status Inquiry - API Checkout
﻿
Setelah  sukses melakukan  dengan Registration - API Checkout﻿ ,   siap untuk melakukan  secara real dengan  . Namun,  rekomendasikan  melakukan  Checkout API﻿ lainnya seperti Inquiry  ini.
﻿ ini digunakan untuk memeriksa     ajukan pada Registration - API Checkout﻿ sebelumnya seperti berhasil atau gagal  nya.
Ketika  sudah selesai dilakukan,  akan menerima  secara otomatis dari kami,  sangat merekomendasikan  untuk memeriksa   kembali tersebut dengan menggunakan Status Inquiry - API Checkout﻿.  
﻿
Status Inquiry - API Checkout
﻿
API URL
/nicepay/direct/v2/inquiry
Request Method 
POST
Header
﻿Content-Type: application/json﻿
Merchant Token
SHA256 (timestamp+ iMid+ referenceNo+ amt+ merchantKey)
Ketika  diterima oleh dbProcessUrl , kami sangat merekomendasikan  untuk melakukan verifikasi  dengan menggunakan Status Inquiry - API Checkout﻿.
﻿
Notification Handling
Notification Handling berguna untuk meminimalisir aksi penipuan, kami sangat merekomendasikan para  untuk melakukan verifikasi Notification Handling.
Status Inquiry - Notification Handling
﻿
﻿
Request Parameters
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
timeStamp
﻿Required﻿
N
14
﻿ Request Date (YYYYMMDDHH24MISS)
20221012080918
tXid
﻿Required﻿
AN
30
Transaction ID
﻿
IONPAYTEST00202212191025073439
iMid
﻿Required﻿
AN
10
﻿ ID
﻿
IONPAYTEST
referenceNo
﻿Required﻿
ANS
40
﻿ Order Number
﻿
ORDER20221012080918
amt
﻿Required﻿
N
12
Transaction Amount
﻿
10000
merchantToken
﻿Required﻿
AN
255
﻿ Token
﻿
d8d0968892c568bc6ff5adc17cd755f85334a0b58fce85392682993a9ba653ed
﻿
Response Parameters
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
resultCd
N
4
﻿Result Code﻿ 
0000
resultMsg
AN
255
Result Message: Error Code﻿ 
(empty)
tXid
AN
30
Transaction ID
IONPAYTEST00202212191025073439
iMid
AN
10
﻿ ID
IONPAYTEST
referenceNo
ANS
40
﻿ Order Number
ORDER20221012080918
payMethod
N
2
﻿Payment Method Code﻿ 
00
amt
N
12
﻿ Amount
10000
cancelAmt
N
12
Cancel Amount
null
reqDt
N
8
Transaction Request Date (YYYYMMDD)
20221219
reqTm
N
6
Transaction Request Time (HH24MISS)
102507
transDt
N
8
Transaction Date (YYYYMMDD)
null
transTm
N
6
Transaction Time (HH24MISS)
null
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﻿﻿
null
Additional - Credit Card
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
authNo
N
10
Approval Number
﻿
issuBankCd
A
4
﻿Issuing Bank Code﻿ 
﻿
acquBankCd
A
4
﻿Acquiring Bank Code﻿ 
﻿
acquBankNm
A
255
Acquiring  Name
﻿
issuBankNm
A
255
Issuing  Name
﻿
cardNo
ANS
20
Card Number with Masking
﻿
cardExpYymm
N
4
Card Expiration (YYMM)
﻿
instmntMon
N
2
Installment Month 
1: 1 Month/Full , jika instmntType: null/1
3: 3 Months
6: 6 Months
12: 12 Months
﻿
instmntType
N
2
﻿Installment Type Code﻿﻿
﻿
preauthToken
AN
255
Pre-Auth Token (Needed for Capture )
﻿
recurringToken
AN
255
Recurring Token (Needed for Recurring )
﻿
ccTransType
N
2
﻿Credit Card Transaction Type﻿﻿
﻿
﻿
acquStatus
N
2
Purchase Status
1: Normal
2: Recurring
3: Pre-Auth
4: Capture
﻿
vat
N
12
﻿ 
﻿
fee
N
12
Service Fee
﻿
notaxAmt
N
12
Tax-Fee Amount
﻿
Additional - Virtual Account
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
bankCd
A
4
﻿Bank Code﻿ 
﻿
vacctNo
N
16
﻿  Number
﻿
vacctValidDt
N
8
VA Expiry date (YYYYMMDD)
﻿
vacctValidTm
N
6
VA Expiry time (HH24MISS)
﻿
Additional - Others
Parameter
Tipe
Ukuran
Deskripsi
Contoh / Catatan
mitraCd
A
4
﻿Mitra Code﻿ 
(CVS, , , Paylater)
﻿
payNo
N
12
CVS Number (CVS)
﻿
payValidDt
N
8
CVS Expiry Date (YYYYMMDD) (CVS)
﻿
payValidTm
N
6
CVS Expiry time (HH24MISS) (CVS)
﻿
receiptCode
ANS
20
Authorization Code (CVS)
﻿
mRefNo
AN
20
﻿ Reference Number ()
﻿
﻿
Sample JSON for API Checkout Status Inquiry
﻿
JSON Request
JSON Response
Java Request
{
    "tXid": "IONPAYTEST00202212191025073439",
    "iMid": "IONPAYTEST",
    "currency": "IDR",
    "amt": "10000",
    "instmntMon": "1",
    "instmntType": "2",
    "referenceNo": "ORDER20221012080918",
    "goodsNm": "Test Transaction Nicepay",
    "payMethod": "00",
    "billingNm": "John Doe",
    "reqDt": "20221219",
    "reqTm": "102507",
    "status": null,
    "resultCd": "0000",
    "resultMsg": "",
    "cardNo": null,
    "preauthToken": null,
    "acquBankCd": null,
    "issuBankCd": null,
    "vacctValidDt": null,
    "vacctValidTm": null,
    "vacctNo": null,
    "bankCd": null,
    "payNo": null,
    "mitraCd": null,
    "receiptCode": null,
    "cancelAmt": null,
    "transDt": null,
    "transTm": null,
    "recurringToken": null,
    "ccTransType": null,
    "payValidDt": null,
    "payValidTm": null,
    "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": "IONPAYTEST00202212191025073439",
    "iMid": "IONPAYTEST",
    "currency": "IDR",
    "amt": "10000",
    "instmntMon": "1",
    "instmntType": "2",
    "referenceNo": "ORDER20221012080918",
    "goodsNm": "Test Transaction Nicepay",
    "payMethod": "00",
    "billingNm": "John Doe",
    "reqDt": "20221219",
    "reqTm": "102507",
    "status": null,
    "resultCd": "0000",
    "resultMsg": "",
    "cardNo": null,
    "preauthToken": null,
    "acquBankCd": null,
    "issuBankCd": null,
    "vacctValidDt": null,
    "vacctValidTm": null,
    "vacctNo": null,
    "bankCd": null,
    "payNo": null,
    "mitraCd": null,
    "receiptCode": null,
    "cancelAmt": null,
    "transDt": null,
    "transTm": null,
    "recurringToken": null,
    "ccTransType": null,
    "payValidDt": null,
    "payValidTm": null,
    "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 URL	/nicepay/direct/v2/inquiry
Request Method	POST
Header	Content-Type: application/json
Merchant Token	SHA256 (timestamp+ iMid+ referenceNo+ amt+ merchantKey)

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
timeStamp Required	N	14	Request Date (YYYYMMDDHH24MISS)	20221012080918
tXid Required	AN	30	Transaction ID	IONPAYTEST00202212191025073439
iMid Required	AN	10	ID	IONPAYTEST
referenceNo Required	ANS	40	Order Number	ORDER20221012080918
amt Required	N	12	Transaction Amount	10000
merchantToken Required	AN	255	Token	d8d0968892c568bc6ff5adc17cd755f85334a0b58fce85392682993a9ba653ed

Parameter	Tipe	Ukuran	Deskripsi	Contoh / Catatan
resultCd	N	4	Result Code	0000
resultMsg	AN	255	Result Message: Error Code	(empty)
tXid	AN	30	Transaction ID	IONPAYTEST00202212191025073439
iMid	AN	10	ID	IONPAYTEST
referenceNo	ANS	40	Order Number	ORDER20221012080918
payMethod	N	2	Payment Method Code	00
amt	N	12	Amount	10000
cancelAmt	N	12	Cancel Amount	null
reqDt	N	8	Transaction Request Date (YYYYMMDD)	20221219
reqTm	N	6	Transaction Request Time (HH24MISS)	102507
transDt	N	8	Transaction Date (YYYYMMDD)	null
transTm	N	6	Transaction Time (HH24MISS)	null
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	null

Parameter	Tipe	Ukuran	Deskripsi
authNo	N	10	Approval Number
issuBankCd	A	4	Issuing Bank Code
acquBankCd	A	4	Acquiring Bank Code
acquBankNm	A	255	Acquiring Name
issuBankNm	A	255	Issuing Name
cardNo	ANS	20	Card Number with Masking
cardExpYymm	N	4	Card Expiration (YYMM)
instmntMon	N	2	Installment Month 1: 1 Month/Full , jika instmntType: null/1 3: 3 Months 6: 6 Months 12: 12 Months
instmntType	N	2	Installment Type Code
preauthToken	AN	255	Pre-Auth Token (Needed for Capture )
recurringToken	AN	255	Recurring Token (Needed for Recurring )
ccTransType	N	2	Credit Card Transaction Type
acquStatus	N	2	Purchase Status 1: Normal 2: Recurring 3: Pre-Auth 4: Capture
vat	N	12
fee	N	12	Service Fee
notaxAmt	N	12	Tax-Fee Amount

Parameter	Tipe	Ukuran	Deskripsi
bankCd	A	4	Bank Code
vacctNo	N	16	Number
vacctValidDt	N	8	VA Expiry date (YYYYMMDD)
vacctValidTm	N	6	VA Expiry time (HH24MISS)

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

Updated 30 Aug 2024

Did this page help you?

Payment - API Checkout

Notification - API Checkout

Status Inquiry - API Checkout

Tentang Status Inquiry - API Checkout

Status Inquiry - API Checkout

Notification Handling

Request Parameters

Response Parameters

Additional - Credit Card

Additional - Virtual Account

Additional - Others

Sample JSON for API Checkout Status Inquiry

Selamat Datang di NICEPAY DOCS