NICEPAY API
...
Advance API
Virtual Account - Advance API

NICEPAY Inquiry Virtual Account

23min

Tentang API NICEPAY Inquiry Virtual Account



Integrasi

 digunakan untuk


tipe NICEPAY Inquiry Virtual Account. Pada

ini, data

berada di sisi

. Sehingga, pada setiap

dari

,

membutuhkan inquiry data

, konfirmasi

, dan melakukan request

ke

.



Alur NICEPAY Inquiry Virtual Account


Flow NICEPAY Inquiry Virtual Account
Flow NICEPAY Inquiry Virtual Account




Inquiry Process NICEPAY to Merchant



Proses ini bertujuan untuk mengetahui rincian tagihan. Setelah

 mendapatkan permintaan inquiry dari

,

akan menggunakan Merchant service untuk mendapatkan

rincian data

. Kemudian, data tersebut akan tersimpan dalam riwayat internal sistem

dan akan dikirim ke

menggunakan format response

inquiry.

API URL

https:// < merchant URL for inquiry >

Request Method

POST (Body Raw JSON)

Merchant Token

-

Request Format

-



Inquiry Request Parameter



Berikut ini adalah daftar

 untuk melakukan

Inquiry

kepada

dari


dilakukan pada


tipe NICEPAY Inquiry Virtual Account. Parameter ini digunakan melalui platform pengujian

sebagai salah satu tahapan supaya

milik

dapat terhubung dengan

dari

.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

customerId

N

9



 ID

891011101

merchantToken

AN

255

SHA256 (Merchant ID + Customer ID + Merchant Key)

141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b

prefix

N

7



 Prefix Number

7015102

bankCd

AN

4

Bank Code

CENA



Inquiry Response Parameter



Berikut adalah response

 dari hasil request

untuk

Inquiry

kepada

.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

billingNm

N

100



 Name

John Doe

goodsNm

AN

100

Goods/Item Name

Testing Buying

referenceNo

N

40

Reference Number for



ordNo20221130101148

amt

AN

12

Total Bill Amount

5000



Normal Amount Only

resultCd

N

4

Result Code of Inquiry Status

0000

resultMsg

AN

255

Result Message for

 Result Code

SUCCESS



Sample JSON Inquiry Process NICEPAY to Merchant


JSON Request
JSON Response
Java Request




Payment Process NICEPAY to Merchant



Payment Process NICEPAY to Merchant adalah tahap untuk melanjutkan




dilakukan

. Saat

melakukan payment request ke

menggunakan nomor

,

akan memanggil Merchant payment URL service untuk


.

menentukan response payment untuk menerima atau menolak

dari

.

API End Point

https:// <

 URL for

>

Method

POST (Body Raw JSON)



Payment Request Parameter



Berikut ini adalah daftar

 untuk melakukan Payment Process NICEPAY to Merchant dari


dilakukan pada


tipe NICEPAY Inquiry Virtual Account. Parameter ini digunakan melalui platform pengujian

sebagai salah satu tahapan supaya

milik

dapat terhubung dengan

dari

.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

customerId

N

9



 ID

110000001

merchantToken

AN

255

SHA256 (Merchant ID + Customer ID + amt + Merchant Key)

141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b

referenceNo

AN

40

Reference Number from Inquiry

OrdNo202210102323223

prefix

N

7



 Prefix Number

7015102

bankCd

AN

4

Bank Code

CENA

amt

N

12

Total Bill Amount

10000

tXid

AN

30

Transaction ID from



NORMALTEST02202211301010513135



Payment Response Parameter



Berikut adalah response parameter dari hasil request

 untuk Payment Process NICEPAY to Merchant.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

billingNm

N

100



 Name

John Doe

goodsNm

AN

255

Goods/Item Name

Testing Buying

referenceNo

N

7

Reference Number for



ordNo2022113010114

amt

AN

4

Total Bill Amount

Normal amount only

resultCd



4

Result Code of Inquiry Status

0000

resultMsg

AN

255

Result Message for

 Result Code

SUCCESS



Sample JSON Payment Process NICEPAY to Merchant


JSON Request
JSON Response
Java Request




Reversal Process NICEPAY to Merchant



Reversal Process NICEPAY to Merchant adalah

 pengembalian dana

terjadi akibat terjadi isu di dalam internal


. Pada

ini,

akan melanjutkan



didapat dari

kepada

.

API End Point

https:// <

 URL for reversal >

Method

POST (Body Raw JSON)



Process Flow

Proses Reversal VA
Proses Reversal VA




Reversal Request Parameter



Berikut ini adalah daftar

 untuk melakukan Reversal Process NICEPAY to Merchant dari


dilakukan pada


tipe NICEPAY Inquiry Virtual Account. Parameter ini digunakan melalui platform pengujian

sebagai salah satu tahapan supaya

milik

dapat terhubung dengan

dari

.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

customerId

N

9



 ID

110000001

merchantToken

AN

255

SHA256 (Merchant ID + Customer ID + amt + Merchant Key)

141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b

referenceNo

AN

40

Reference Number from Inquiry

OrdNo202210102323223

prefix

N

7



 Prefix Number

7015102

bankCd

AN

4

Bank Code

CENA

amt

N

12

Total Bill Amount

10000

tXid

AN

30

Transaction ID from



NORMALTEST02202211301010513135



Reversal Response Parameter



Berikut adalah response

 dari hasil request

untuk Reversal Process NICEPAY to Merchant.

Parameter

Tipe

Ukuran

Deskripsi

Contoh / Catatan

billingNm

N

100



 Name

John Doe



Top-Up Amount Only

goodsNm

AN

100

Goods/Item Name

Testing Reversal Transaction



Top-Up Amount Only

referenceNo

N

40

Reference Number for



OrdNo202210102323223

amt

AN

12

Total Bill Amount

50000

resultCd



34

Result Code of Inquiry Status Result Code

0000

resultMsg



255

Result Message for

 Result Code

SUCCESS



Sample JSON Reversal Process NICEPAY to Merchant


JSON Request
JSON Response
Java Request




See also





Status Inquiry - API Checkout untuk mengetahui

untuk memeriksa

inquiry khusus

.





Cancel - API Checkout untuk mengetahui

untuk membatalkan

khusus

.





Status Inquiry - API Virtual Account untuk mengetahui


untuk memeriksa

inquiry pada

khusus

.





Cancel - API Virtual Account untuk mengetahui


untuk membatalkan

pada

khusus

.