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