---
title: NICEPAY Inquiry Virtual Account
slug: nicepay-api-non-snap-nicepay-inquiry-virtual-account
description: Informasi tentang API Non-SNAP Advance - NICEPAY Inquiry Virtual Account yang terdapat pada sistem NICEPAY
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/zxW9jooztG-kGp97LGJjz_nicepay-docs-logo.png
icon: {"faIcon":"fa-solid fa-anchor-lock"}
docTags: 
createdAt: 2022-11-18T06:22:25.000Z
---

# Tentang API NICEPAY Inquiry Virtual Account

***

Integrasi NICEPAY Inquiry Virtual Account digunakan untuk metode pembayaran Virtual Account *tipe NICEPAY Inquiry Virtual Account*. Pada metode pembayaran ini, data Pelanggan berada di sisi Merchant. Sehingga, pada setiap pembayaran dari Bank, NICEPAY membutuhkan inquiry data Pelanggan, konfirmasi pembayaran, dan melakukan *request* pembayaran ke Merchant.



# Alur NICEPAY Inquiry Virtual Account

***

![](https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/OJT2u3IojTYOzGRGOaDFd_payment-va-bulk.png "Flow NICEPAY Inquiry Virtual Account")



# Inquiry Process NICEPAY to Merchant

***

Proses ini bertujuan untuk mengetahui rincian tagihan. Setelah NICEPAY mendapatkan permintaan inquiry dari Bank, NICEPAY akan menggunakan *Merchant service* untuk mendapatkan informasi rincian data Pelanggan. Kemudian, data tersebut akan tersimpan dalam riwayat internal sistem NICEPAY dan akan dikirim ke Bank menggunakan format *response *Bank inquiry.

| **API URL**              | https\:// \< merchant URL for inquiry >                   |
| ------------------------ | --------------------------------------------------------- |
| **Request Method&#x20;** | <font color="#3b9f0f">**POST (Body Raw JSON)**</font>**** |
| **Merchant Token**       | -                                                         |
| **Request Format**       | -                                                         |



## Inquiry Request Parameter&#x20;

***

Berikut ini adalah daftar parameter untuk melakukan proses Inquiry NICEPAY kepada Merchant dari transaksi yang dilakukan pada metode pembayaran Virtual Account tipe *NICEPAY Inquiry Virtual Account*. Parameter ini digunakan melalui platform pengujian API sebagai salah satu tahapan supaya sistem milik Merchant dapat terhubung dengan layanan dari NICEPAY. &#x20;

| **Parameter**   | **Tipe** | **Ukuran** | **Deskripsi**                                           | **Contoh / Catatan**                                             |
| --------------- | -------- | ---------- | ------------------------------------------------------- | ---------------------------------------------------------------- |
| `customerId`    | N        | 9          | Customer ID                                             | 891011101                                                        |
| `merchantToken` | AN       | 255        | SHA256 (`Merchant ID` + `Customer ID` + `Merchant Key`) | 141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b |
| `prefix`        | N        | 7          | Virtual Account Prefix Number                           | 7015102                                                          |
| `bankCd`        | AN       | 4          | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad)                | CENA                                                             |



## Inquiry Response Parameter&#x20;

***

Berikut adalah *response&#x20;*&#x70;arameter dari hasil *request&#x20;*&#x70;arameter untuk proses Inquiry NICEPAY kepada Merchant.&#x20;

| **Parameter**    | **Tipe** | **Ukuran** | **Deskripsi**                                                       | **Contoh / Catatan**                          |
| ---------------- | -------- | ---------- | ------------------------------------------------------------------- | --------------------------------------------- |
| `billingNm`&#xD; | N        | 100        | Customer Name                                                       | John Doe                                      |
| `goodsNm`        | AN       | 100        | Goods/Item Name                                                     | Testing Buying                                |
| `referenceNo`    | N        | 40         | Reference Number for Payment                                        | ordNo20221130101148                           |
| `amt`            | AN       | 12         | Total Bill Amount                                                   | 5000<br /><br />Normal Amount &#xD;<br />Only |
| `resultCd`       | N        | 4          | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) of Inquiry Status       | 0000                                          |
| `resultMsg`      | AN       | 255        | Result Message for the [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM)  | SUCCESS                                       |



## Sample JSON Inquiry Process NICEPAY to Merchant

***

:::CodeblockTabs
JSON Request

```json
{
    "customerId" : "891011101",
    "merchantToken" : "141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b",
    "prefix" :  "7015102",
    "bankCd" :  "CENA"
}
```

JSON Response

```json
{
    "resultCd" : "0000",
    "resultMsg" : "SUCCESS",
    "billingNm" : "John Doe",
    "goodsNm" : "Testing Buying",
    "referenceNo" : "ordNo20221130101148",
    "amt" : "5000"
}
```

Java Request

```java
//Inquiry To Merchant//
nicePay.setCustomerId("123456");
nicePay.setPrefix("000001");
nicePay.setBankCd("CENA");
nicePay.setMerchantToken(nicePay.makeToken(nicePay.getCustomerID());

//Request Inquiry//
nicePay.inquiry();

//Response Inquiry//
String resultCd = nicePay.get("resultCd");
String resultMsg = nicepay.get("resultMsg");
String billingNm = nicePay.get("billingNm");
String referenceNo = nicePay.get("referenceNo");
String goodsNm = nicePay.get("goodsNm");
String amt = nicePay.get("amt");

```
:::



# Payment Process NICEPAY to Merchant

***

*Payment Process NICEPAY to Merchant* adalah tahap untuk melanjutkan proses pembayaran yang dilakukan Pelanggan. Saat Bank melakukan *payment request* ke NICEPAY menggunakan nomor Virtual Account, NICEPAY akan memanggil *Merchant payment URL service* untuk proses pembayaran. Merchant menentukan *response payment&#x20;*&#x75;ntuk menerima atau menolak pembayaran dari Pelanggan.

| **API End Point** | https\:// \< Merchant URL for payment  >                  |
| ----------------- | --------------------------------------------------------- |
| **Method&#x20;**  | <font color="#3b9f0f">**POST (Body Raw JSON)**</font>**** |



## Payment Request Parameter&#x20;

***

Berikut ini adalah daftar parameter untuk melakukan *Payment Process NICEPAY to Merchant* dari transaksi yang dilakukan pada metode pembayaran Virtual Account *tipe NICEPAY Inquiry Virtual Account*. Parameter ini digunakan melalui platform pengujian API sebagai salah satu tahapan supaya sistem milik Merchant dapat terhubung dengan layanan dari NICEPAY. &#x20;

| **Parameter**   | **Tipe** | **Ukuran** | **Deskripsi**                                                   | **Contoh / Catatan**                                             |
| --------------- | -------- | ---------- | --------------------------------------------------------------- | ---------------------------------------------------------------- |
| `customerId`    | N        | 9          | Customer 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          | Virtual Account Prefix Number                                   | 7015102                                                          |
| `bankCd`        | AN       | 4          | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad)                        | CENA                                                             |
| `amt`           | N        | 12         | Total Bill Amount                                               | 10000                                                            |
| `tXid`          | AN       | 30         | Transaction ID from NICEPAY                                     | NORMALTEST02202211301010513135                                   |



## Payment Response Parameter&#x20;

***

Berikut adalah *response&#x20;*&#x70;arameter dari hasil *request&#x20;*&#x70;arameter untuk *Payment Process NICEPAY to Merchant*.&#x20;

| **Parameter**    | **Tipe** | **Ukuran** | **Deskripsi**                                                      | **Contoh / Catatan**          |
| ---------------- | -------- | ---------- | ------------------------------------------------------------------ | ----------------------------- |
| `billingNm`&#xD; | N        | 100        | Customer Name                                                      | John Doe                      |
| `goodsNm`        | AN       | 255        | Goods/Item Name                                                    | Testing Buying                |
| `referenceNo`    | N        | 7          | Reference Number for Payment                                       | ordNo2022113010114            |
| `amt`            | AN       | 4          | Total Bill Amount                                                  | Normal amount &#xD;<br />only |
| `resultCd`       |          | 4          | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) of Inquiry Status      | 0000                          |
| `resultMsg`      | AN       | 255        | Result Message for the [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | SUCCESS                       |



## Sample JSON Payment Process NICEPAY to Merchant

***

:::CodeblockTabs
JSON Request

```json
{
    "customerId" : "110000001",
    "merchantToken" : "141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b",
    "referenceNo" : "OrdNo202210102323223",
    "prefix" : "7015102",
    "bankCd" : "CENA",
    "amt" : "10000",
    "tXid" : "NORMALTEST02202211301010513135"
}
```

JSON Response

```json
{
    "resultCd" : "0000",
    "resultMsg" : "SUCCESS",
    "billingNm" : "John Doe",
    "goodsNm" : "Testing Buying",
    "referenceNo" : "ordNo20221130101148",
    "amt" : "10000"
}
```

Java Request

```java
{
	merchantToken=b360a7dfd4e004e63a161d7298a006ac7900add126b8e19375c4a594ab2e806e,
	vacctType=1,
	referenceNo=2211JD1X7TX5,
	prefix=70015267,
	proxyUrl=http://172.30.51.31:8080/nicepay_proxy/api/bulkPayment.do,
	customerId=60028392,
	bankCd=BMRI,
	tXid=OYINDON00402202211160002385044,
	amt=150000,
	targetUrl=https://payfeedback.oyindonesia.com/nicepay/va/bulk/payment
}
```
:::



# Reversal Process NICEPAY to Merchant

***

*Reversal Process NICEPAY to Merchant* adalah proses pengembalian dana yang terjadi akibat terjadi isu di dalam internal sistem Bank. Pada proses ini, NICEPAY akan melanjutkan informasi status yang didapat dari Bank kepada Merchant.

| **API End Point** | https\:// \< Merchant URL for reversal >                  |
| ----------------- | --------------------------------------------------------- |
| **Method&#x20;**  | <font color="#3b9f0f">**POST (Body Raw JSON)**</font>**** |



## Process Flow

![](https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/Szs-r5qOWImlRGewe9dRb_nicepay-archbee-payment-va-reversaldrawio-4.png "Proses Reversal VA ")



## Reversal Request Parameter&#x20;

***

Berikut ini adalah daftar parameter untuk melakukan *Reversal Process NICEPAY to Merchant* dari transaksi yang dilakukan pada metode pembayaran Virtual Account *tipe NICEPAY Inquiry Virtual Account*. Parameter ini digunakan melalui platform pengujian API sebagai salah satu tahapan supaya sistem milik Merchant dapat terhubung dengan layanan dari NICEPAY. &#x20;

| **Parameter**   | **Tipe** | **Ukuran** | **Deskripsi**                                                   | **Contoh / Catatan**                                             |
| --------------- | -------- | ---------- | --------------------------------------------------------------- | ---------------------------------------------------------------- |
| `customerId`    | N        | 9          | Customer 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          | Virtual Account Prefix Number                                   | 7015102                                                          |
| `bankCd`        | AN       | 4          | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad)                        | CENA                                                             |
| `amt`           | N        | 12         | Total Bill Amount                                               | 10000                                                            |
| `tXid`          | AN       | 30         | Transaction ID from NICEPAY                                     | NORMALTEST02202211301010513135                                   |



## Reversal Response Parameter&#x20;

***

Berikut adalah *response&#x20;*&#x70;arameter dari hasil *request&#x20;*&#x70;arameter untuk *Reversal Process NICEPAY to Merchant*.&#x20;

| **Parameter**    | **Tipe** | **Ukuran** | **Deskripsi**                                                              | **Contoh / Catatan**                                                       |
| ---------------- | -------- | ---------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| `billingNm`&#xD; | N        | 100        | Customer Name                                                              | John Doe<br /><br />Top-Up Amount &#xD;<br />Only&#xD;                     |
| `goodsNm`        | AN       | 100        | Goods/Item Name                                                            | Testing Reversal Transaction<br /><br />Top-Up Amount &#xD;<br />Only&#xD; |
| `referenceNo`    | N        | 40         | Reference Number for Payment                                               | OrdNo202210102323223                                                       |
| `amt`            | AN       | 12         | Total Bill Amount                                                          | 50000                                                                      |
| `resultCd`       |          | 34         | Result Code of Inquiry Status [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM)  | 0000                                                                       |
| `resultMsg`      |          | 255        | Result Message for the [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM)         | SUCCESS                                                                    |



## Sample JSON Reversal Process NICEPAY to Merchant

***

:::CodeblockTabs
JSON Request

```json
{
    "customerId" : "110000001",
    "merchantToken" : "141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b",
    "referenceNo" : "OrdNo202210102323223",
    "prefix" : "7015102",
    "bankCd" : "CENA",
    "amt" : "10000",
    "tXid" : "NORMALTEST02202211301010513135"
}
```

JSON Response

```json
{
    "resultCd" : "0000",
    "resultMsg" : "SUCCESS",
    "billingNm" : "John Doe",
    "referenceNo" : "OrdNo202210102323223",
    "goodsNm" : "Testing Reversal Transaction",
    "amt" : "50000"
}
```

Java Request

```java
//Reversal To Merchant//
nicePay.setCustomerId("123456");
nicePay.settXid("NORMALTEST02202211301010513135");
nicePay.setBankCd("CENA");
nicePay.setPrefix("7015102");
nicePay.setAmt("10000");
nicePay.setReferenceNo("OrdNo202210102323223");
nicePay.setMerchantToken(nicePay.makeToken(nicePay.getCustomerID());

//Request Reversal//
nicePay.reversal();

//Response Reversal//
String resultCd = nicePay.get("resultCd");
String resultMsg = nicePay.get("resultMsg");
String billingNm = nicePay.get("billingNm");
String goodsNm = nicePay.get("goodsNm");
String referenceNo = nicePay.get("referenceNo");
String amt = nicePay.get("amt");
```
:::



# See also

::::VerticalSplit
:::VerticalSplitItem
Kunjungi halaman [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3) untuk mengetahui API untuk memeriksa status inquiry khusus Checkout.
:::

:::VerticalSplitItem
Kunjungi halaman [Cancel - API Checkout](docId\:MMmlusWDkyUsJxF421yKn) untuk mengetahui API untuk membatalkan transaksi khusus Checkout.
:::
::::

::::VerticalSplit
:::VerticalSplitItem
Kunjungi halaman [Status Inquiry - API Virtual Account](docId\:hqHww3quoVreZVG1Zp5ds) untuk mengetahui API Virtual Account untuk memeriksa status inquiry pada API khusus Payment.
:::

:::VerticalSplitItem
Kunjungi halaman [Cancel - API Virtual Account](docId\:XnIHmWqi1kWBP9mYS4VQv) untuk mengetahui API Virtual Account untuk membatalkan transaksi pada API khusus Payment.
:::
::::