NICEPAY API
...
Payment API
API Convenience Store

Status Inquiry - API Convenience Store

10min

About API Convenience Store Status Inquiry



Integration of Status Inquiry into is necessary so that s can check ongoing of carried out by , whether is successful, failed or failed, and others. So that can have a report on that .



API Convenience Store Status Inquiry



Integration of Inquiry Status at aims to enable s to connect with to check of s on a regular basis.

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

When your dbProcessUrl received a , we strongly encourage s to verify using Status Inquiry - API Convenience Store.

Notification Handling is very useful to minimize risk of Fraud. We strongly encourage s to verify Notification Handling through Notification - API Convenience Store.



Request Parameter for Convenience Store Status Inquiry



The following is a list of s for requesting a inquiry on a .

Parameter

Type

Size

Description

Example / Notes

timeStamp

Required

N

14

Request Timestamp (YYYYMMDDHH24MISS)

20221012080918

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

Merchant token

666b397e7bce1d65e2cc553205ebab7330f9b2da8293b02c342279c1b6999ceb



Response Parameter for Convenience Store Status Inquiry



The following is a list of responses to requests for inquiry in .

Parameter

Type

Size

Description

Example / Notes

resultCd

N

4

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

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

3



Additional Response Parameter for Others Status Inquiry



The following is additional response list from request inquiry in other es.

Parameter

Type

Size

Description

Example / Notes

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