NICEPAY API
...
Payment API
API Virtual Account

Status Inquiry - API Virtual Account

10min

Tentang API Virtual Account Status Inquiry



Integrasi

 Status Inquiry pada

diperlukan supaya

dapat memeriksa


berlangsung pada



dilakukan oleh

baik ber

success, fail, dan lainnya. Sehingga

dapat memiliki laporan mengenai

tersebut.



API Virtual Account Status Inquiry



Integrasi

 inquiry pada

bertujuan supaya

dapat terhubung dengan


untuk melakukan pengecekan

pada


secara berkala.

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 Virtual Account.

Ketika

 diterima pada dbProcessUrl

, kami sangat menyarankan kepada

untuk melakukan verifikasi

kembali dengan menggunakan Notification - API Virtual Account.



Request Parameter for Virtual Account Status Inquiry



Berikut ini adalah daftar

 untuk melakukan request

inquiry pada



.

Parameter

Tipe

Ukuran

Deskripsi

Contoh

timeStamp

Required

N

14

Request Timestamp (YYYYMMDDHH24MISS)

20221215091222

tXid Required 

AN

30

Transaction ID

NORMALTEST02202212150929011967

iMid

Required 

AN

10



 ID

NORMALTEST

referenceNo Required 

ANS

40



 Order Number

ordNo20221215091214

amt Required 

N

12

Transaction Amount

1000

merchantToken Required 

AN

255



 token

ea6e691a895f1ccc0602f534205ee60bc552552dde7610062cd048ea6c87965e



Response Parameter for Virtual Account Status Inquiry



Berikut ini adalah daftar response dari request

 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

NORMALTEST02202212150929011967

iMid

AN

10



 ID

NORMALTEST

referenceNo

ANS

40



 Reference Number

ordNo20221215091214

payMethod

N

2

02

amt

N

12



 Amount

10000

CancelAmt

N

12

Cancel Amount

null

reqDt

N

8

Transaction Request Date (YYYYMMDD)

20221215

reqTm

N

6

Transaction Request Time (HH24MISS)

092901

transDt

N

8

Transaction Date (YYYYMMDD)

20221215

transTm

N

6

Transction Time (HH24MISS)

092901

depositDt

N

8

Transaction Deposit Date (YYYYMMDD)

null

depositTm

N

6

Transaction Deposit Time (HH24MISS)

null

mitraCd

A

4

Mitra Code

ALMA

instmntMon

N

2

Installment Month

null

instmntType

N

2

1

cardNo

N

20

Credit Card Number

null

preauthToken

AN

64

Pre-Auth Token

null

acquBankCd

A

4

null

issuBankCd

A

4

null

vacctValidDt

N

8

VA Expiry Date (YYYYMMDD)

20221231

vacctValidTm

N

6

VA Expiry Time (HH24MISS)

235959

vacctNo

N

20



 Number

9912304000001487

bankCd

A

4

Bank Code

CENA

payNo

N

12

CVS Number (CVS)

null

mitraCd

A

4

Mitra Code

null

receiptCode

ANS

20

Authorization Number

null

recurringToken

AN

64

Recurring

 Token

null

ccTransType

N

2

null

payValidDt

N

8

Expiry Date (YYYYMMDD)

null

payValidTm

N

6

Expiry Time (HH24MISS)

null

mRefNo

AN

18



 Reference Number

null

acquStatus

N

2

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

null

cardExpYymm

N

4

Card Expiration (YYMM)

null

acquBankNm

A

255

Acquiring

 Name

null

issuBankNm

A

255

Issuing

 Name

null

depositDt

N

8

Deposit Date (YYYYMMDD)

20221215

depositTm

N

6

Deposit Time (HH24MISS)

092936

paymentExpDt

N

6

QR

 Expiry Date (YYYYMMDD)

null

paymentExpTm

N

6

QR

 Expiry Time (HH24MISS)

null

paymentTrxSn

N

32



 Transaction Number

null

cancelAmt

N

12

Cancel Amount

null

cancelTrxSn

AN

32

Cancel Transaction Number

null

currency

A

3

Currency

IDR

goodsNm

AN

100

Goods Name

Test Transaction



billingNm

A

100

Buyer Name

John Doe

status

N

1

0

userId

AN

128

 User ID Hash

null

shopId

AN

32

Shop ID

null



Additional Response Parameter for Virtual Account Status Inquiry



Berikut ini adalah

 daftar response tambahan dari request

inquiry pada



.

Parameter

Tipe

Ukuran

Deskripsi

bankCd

A

4

Bank Code

vacctNo

N

16





Number

vacctValidDt

N

8

VA Expiry Date (YYYYMMDD)

vacctValidTm

N

9

VA Expiry Time (HH24MISS)



Sample JSON for Virtual Account Status Inquiry


JSON Request
JSON Response
Java Request