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