NICEPAY API
API Versi 1

V1 Check Transaction Status

11min

Tentang V1 Check Transaction Status



ini berguna untuk memeriksa .

  • Ketika Notifikasi di dbProcessUrl sudah diterima, sangat disarankan bagi untuk melakukan verifikasi menggunakan V1 Check Transaction Status.
  • Ketika callbackUrl sudah diterima, kami merekomendasikan para untuk melakukan verifikasi Status dengan menggunakan V1 Check Transaction Status.
  • CallBack Handling berguna untuk mengurangi aksi Fraud, kami merekomendasikan untuk melakukan verifikasi dengan CallBack Handling.

CallBack Handling Flow
CallBack Handling Flow


Deskripsi langkah:

  1.  melakukan checkout.
  2.  mengajukan kepada .
  3.  mengirimkan response callback dan hasil (callBackUrl) kepada .
  4.  memeriksa .
  5.  mengirimkan kepada .
  6.  mengirimkan response (final status flag) kepada .



API Check Transaction Status



API Endpoint

/nicepay/api/onePassStatus.do

Request Method application/x-www-form-urlencoded

POST

Description

Inquires to server

Merchant Token

SHA256(iMid+referenceNo+amt+merchantKey)

Notification Handling tersebut sangat membantu untuk meminimalisir tindakan Fraud, sangat disarankan bagi untuk melakukan Notification Handling.

Notification Handling Flow
Notification Handling Flow


Deskripsi langkah:

  1.  melakukan checkout.
  2.  mengirimkan kepada .
  3.  mengirimkan URL (dbProcessUrl) kepada .
  4.  memeriksa .
  5.  mengirimkan kepada .
  6.  mengembalikan response (final status flag) kepada .



Request Parameters - Check Status

Check Status - Request Parameter


Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

iMid Required

AN

10

 ID

IONPAYTEST

merchantTokenRequired 

AN

255

 Token

6cfccfc0046773c1b89d8e98c...

tXid Required 

AN

30

Transaction ID

IONPAYTEST02201603091207051498

amt Required 

N

12

Goods Amount

1000

referenceNo Required

ANS

40

 Order Number

MerchantReferenceNumber001



Response Parameter - Check Status

Check Status - Response Parameter


Parameter

Tipe

Ukuran

Deskipsi

resultCd

N

4

Result Code

resultMsg

AN

255

tXid

AN

30

Transaction ID

referenceNo

ANS

40

 Reference Number

payMethod

N

2

amt

N

12

 Amount

reqDt

N

8

Transaction Date (YYYYMMDD)

reqTm

N

6

Transaction Time (HH24MISS)

currency

A

3

Currency

goodsNm

AN

100

Goods Name

billingNm

AN

30

Billing Name

status

N

1

instmntMon

N

2

Installment Month

instmntType

N

2

acquirerData

Array

20

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

Additional Response for Virtual Account

Parameter

Tipe

Ukuran

Deskripsi

vacctValidDt

N

8

Batas Tanggal VA (YYYYMMDD)

vacctValidTm

N

6

Batas Waktu VA (HH24MISS)

vacctNo

N

16

Nomor VA

bankCd

A

4

Bank Code

Additional Response for QRIS

Parameter

Tipe

Ukuran

Deskripsi

mitraCd

A

4

Mitra Code (QRIS)

cancelAmt

N

12

Nominal Pembatalan

paymentTrxSn

AN

32

Nomor Pembayaran Transaksi

paymentExpDt

N

6

Batas Waktu Pembayaran QR (YYYYMMDD)

shopId

AN

32

Shop ID

transTm

N

6

Tanggal Transaksi (HH24MISS)

paymentExpTm

N

6

Batas Waktu Pembayaran QR (HH24MISS)

cancelTrxSn

AN

32

Nomor Pembatalan Transaksi

userId

AN

128

Hash ID Pengguna 

transDt

N

8

Tanggal Transaksi (YYYYMMDD)

depositDt

N

8

Tanggal Transaksi Terbayar (YYYYMMDD)

depositTm

N

6

Tanggal Transaksi Terbayar (HH24MISS)

Additional Response for Others Payment Method

Parameter

Tipe

Ukuran

Deskripsi

mitraCd

A

4

Mitra Code (CVS, , )

payNo

N

12

Nomor Pembayaran (CVS)

payValidDt

N

8

Batas Tanggal Pembayaran CVS (YYYYMMDD)

payValidTm

N

6

Batas Waktu Pembayaran CVS (HH24MISS)

receiptCode

ANS

18

Authorization Number