NICEPAY API
...
Payment API
API Credit Card

Status Inquiry - API Credit Card

10min

Tentang API Credit Card Status Inquiry



Integrasi dengan Status Inquiry pada diperlukan supaya dapat memeriksa pada sedang berlangsung baik berstatus success, fail, dan lainnya.



API Credit Card Status Inquiry



Integrasi inquiry pada bertujuan supaya dapat terhubung dengan untuk melakukan pemeriksaan pada .

API End Point

/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 menyarankan untuk melakukan verifikasi tersebut dengan menggunakan Status Inquiry - API Credit Card.

Notification Handling sangat berguna untuk meminimalisir terjadinya Fraud. Kami sangat menganjurkan untuk memverifikasi Notification Handling. dapat membaca lebih rinci mengenai Notification Handling pada Notification - API Credit Card.



Request Parameter for Credit Card Status Inquiry



Berikut ini adalah daftar untuk melakukan request inquiry pada .

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

timeStamp

Required

N

14

Request Timestamp (YYYYMMDDHH24MISS)

20221214091282

tXid Required 

AN

30

Transaction ID

IONPAYTEST01202212140949101366

iMid

Required 

AN

10

 ID

IONPAYTEST

referenceNo Required 

ANS

40

 Order Number

ordNo20221214091293

amt Required 

N

12

Transaction Amount

5000

merchantToken Required 

AN

255

 Token

7eceb5801db4e039223698c4eb9...



Response Parameter for Credit Card Status Inquiry



Berikut ini adalah daftar response dari pengajuan inquiry pada .

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

resultCd

N

4

0000

resultMsg

AN

255

Result Message: Error Code

Paid

tXid

AN

30

Transaction ID

IONPAYTEST01202212140949101366

iMid

AN

10

 ID

IONPAYTEST

currency

A

3

Currency

IDR

instmntMon

N

2

Installment Month

1

instmntType

N

2

1

referenceNo

ANS

40

 Reference Number

ordNo20221214091293

payMethod

N

2

01

amt

N

12

 Amount

5000

CancelAmt

N

12

Cancel Amount

null

reqDt

N

8

Transaction Request Date (YYYYMMDD)

20221214

reqTm

N

6

Transaction Request Time (HH24MISS)

094910

status

N

1

0

transDt

N

8

Transaction Date (YYYYMMDD)

20221214

transTm

N

6

Transaction Time (HH24MISS)

094910

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

Goods

billingNm

A

100

Buyer name

John Doe

status

N

1

0



Additional Response Parameter for Credit Card Status Inquiry



Berikut ini adalah daftar response tambahan dari request inquiry pada .

Parameter

Tipe

Ukuran

Deskripsi

Catatan / Contoh

authNo

N

10

Auth Number

101366

issuBankCd

A

4

OTHR

acquBankCd

A

4

BMRI

acquBankNm

A

255

Acquiring Name

Mandiri

vacctValidDt

N

8

VA Expiry Date (YYYYMMDD)

null

vacctValidTm

N

6

VA Expiry Time (HH24MISS)

null

vacctNo

N

20

 Number

null

bankCd

A

4

Bank Code

null

payNo

N

12

CVS Number

null

mitraCd

A

4

Mitra Code

null

receiptCode

ANS

20

Authorization Number

null

cancelAmt

N

12

Cancel Amount

null

payValidDt

N

8

CVS Expiry Date (YYYYMMDD)

null

payValidTm

N

6

CVS Expiry Time (HH24MISS)

null

mRefNo

AN

20

 Reference Number



issuBankNm

A

100

Issuing Name

OTHER

paymentExpDt

N

6

 Expiry Date (YYYYMMDD)

null

paymentExpTm

N

6

 Expiry Time (HH24MISS)

null

paymentTrxSn

AN

32

 Transaction Number

null

userId

AN

128

 User ID Hash

null

shopId

AN

32

Shop ID

null

cardNo

ANS

20

Masked Card Number

453211*1111

cardExpYymm

N

4

Card Expiration (YYMM)

2712

instmntMon

N

2

Installment Month

1

instmntType

N

2

1

preauthToken

AN

255

Pre-Auth Token (Needed for Capture )

null

recurringToken

AN

255

Recurring Token (Needed for Recurring )

null

ccTransType

N

2

1

acquStatus

N

2

Purchase Status 1: Normal 2: Recurring 3: Pre-Auth 4: Capture

10

acquirerData

Array

20

A dynamic array consisting of a unique reference number RRN that is provided by ing when a refund is ed. This reference number can be used by to track of refund with .

"acquirerData": { "rrn": "332608321717" }

latestFailHistory

Array Object



Failed records are only displayed if the transaction fails and 1 Transaction may have more than 1 failed record if the merchant has a retry mechanism.

"latestFailHistory": [ { "resultCd": "1231", "resultMsg": "Fail 3ds", "transDt": "20240707", "transTm": "121213" } ]



Sample JSON for Credit Card Status Inquiry


JSON Request
JSON Response
Java Request