---
title: Inquiry - DANA Recurring API
slug: nicepay-api-non-snap-inquiry-dana-recurring-e-wallet-advance-api
description: Informasi tentang API Non-SNAP Advance API - E-Wallet DANA Recurring Inquiry yang terdapat pada sistem NICEPAY
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/60UxEn0tbKBT2xb51-wAu_nicepay-docs-logo.png
icon: {"faIcon":"fa-solid fa-recycle"}
docTags: 
createdAt: 2024-05-06T03:34:54.045Z
---

# Tentang Inquiry - DANA Recurring API

***

Integrasi API Inquiry pada proses DANA Recurring E-Wallet diperlukan supaya Merchant dapat memeriksa status yang berlangsung pada proses transaksi yang dilakukan oleh Pelanggan, baik status *success*, *fail*, dan lainnya. Sehingga, sistem dapat memiliki laporan mengenai informasi tersebut.



# Inquiry - DANA Recurring API

***

| **API Endpoint**   | `/nicepay/direct/v2/inquiry`                                                                                                                                                                   |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Request Method** | ****<font color="#3b9f0f">**POST ,**</font>**&#x20;JSON**                                                                                                                                      |
| **Description**    | Merchant can check order status using Inquiry API.&#xD;<br />If Merchant receive notification, NICEPAY strongly recommend that the Merchant check the transaction again using the Inquiry API. |
| **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`)                                                                                                                                   |



## Request Parameter Inquiry - DANA Recurring API

***

Berikut ini adalah daftar parameter untuk melakukan *request&#x20;*&#x73;tatus inquiry pada proses transaksi DANA Recurring E-Wallet.&#x20;

| **Parameter**                                              | **Tipe** | **Ukuran** | **Deskripsi**         | **Contoh / Catatan**                                             |
| ---------------------------------------------------------- | -------- | ---------- | --------------------- | ---------------------------------------------------------------- |
| `timeStamp`<br /><font color="#2166ae">Required</font>     | N        | 14         | API Request Date      | 20170708123456                                                   |
| `tXid`<br /><font color="#2166ae">Required</font>          | AN       | 30         | Transaction ID        | IONPAYTEST05202108231310459282                                   |
| `iMid`<br /><font color="#2166ae">Required</font>          | AN       | 10         | Merchant ID           | IONPAYTEST                                                       |
| `referenceNo`<br /><font color="#2166ae">Required</font>   | ANS      | 40         | Merchant Order Number | OrdNo20217131024122                                              |
| `amt`<br /><font color="#2166ae">Required</font>           | N        | 12         | Transaction Amount    | 100                                                              |
| `merchantToken`<br /><font color="#2166ae">Required</font> | AN       | 255        | Merchant Token        | be5ac4d19e833d3488dfa48bf388d7510100c2fbc215c9b19c1ae644fd861919 |



## Response Parameter Inquiry - DANA Recurring API

***

Berikut ini adalah daftar *response* dari status inquiry pada proses transaksi E-Wallet DANA Recurring.&#x20;

| **Parameter** | **Tipe** | **Ukuran** | **Deskripsi**                                        | **Contoh / Catatan**                                                                                                                                                 |
| ------------- | -------- | ---------- | ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `resultCd`    | N        | 4          | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM)          | 0000                                                                                                                                                                 |
| `resultMsg`   | AN       | 255        | Result Message                                       | SUCCESS                                                                                                                                                              |
| `tXid`        | AN       | 30         | Transaction ID (Key from NICEPAY)                    | IONPAYTEST05202108231310459282                                                                                                                                       |
| `iMid`        | AN       | 10         | Merchant ID                                          | IONPAYTEST                                                                                                                                                           |
| `referenceNo` | ANS      | 40         | Merchant Order Number (Key from Merchant)            | OrdNo20217131024122                                                                                                                                                  |
| `payMethod`   | N        | 2          | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok)  | `05`: E-Wallet                                                                                                                                                       |
| `amt`         | N        | 12         | Payment Amount                                       | 100                                                                                                                                                                  |
| `cancelAmt`   | N        | 12         | Cancel Amount                                        | 100                                                                                                                                                                  |
| `reqDt`       | N        | 8          | Transaction Request Date (`YYYYMMDD`)                | 20160301                                                                                                                                                             |
| `reqTm`       | N        | 6          | Transaction Request Time (`YYYYMMDD`)                | 135959                                                                                                                                                               |
| `transDt`     | N        | 8          | Transaction Date (`YYYYMMDD`)                        | 20160303                                                                                                                                                             |
| `transTm`     | N        | 6          | Transaction Time (`YYYYMMDD`)                        | 135959                                                                                                                                                               |
| `mitraCd`     | A        | 4          | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8)           | DANA                                                                                                                                                                 |
| `currency`    | AN       | 3          | Currency                                             | IDR                                                                                                                                                                  |
| `goodsNm`     | AN       | 100        | Goods Name                                           | Merchant Goods 1                                                                                                                                                     |
| `billingNm`   | AN       | 30         | Buyer Name                                           | Buyer Name                                                                                                                                                           |
| `payValidDt`  | N        | 8          | CVS Expiry Date (`YYYYMMDD`)                         | 20170313                                                                                                                                                             |
| `payValidTm`  | N        | 6          | CVS Expiry Time (`YYYYMMDD`)                         | 135959                                                                                                                                                               |
| `status`      | N        | 1          | Transaction Status                                   | `0`: Paid<br />`1`: Void<br />`2`: Refund<br />`3`: Unpaid<br />`4`: Expired (VA, CVS, ClickPay-Cancel)<br />`5`: Preauthed<br />`8`: Fail<br />`9`: Init (Reversal) |



## Sample Parameter Inquiry - DANA Recurring API

***

:::CodeblockTabs
Sample Request

```json
{
    "timeStamp": "20211015101074",
    "tXid": "IONPAYTEST05202108231310459282",
    "iMid": "IONPAYTEST",
    "referenceNo": "OrdNo20217131024122",
    "amt": "100",
    "merchantToken": "91a1abeb40603a1301d3dfba044d14d0d70b907d8f4e485bcf71394415c5feca"
}
```

Sample Response

```json
{
    "tXid": "IONPAYTEST05202108231310459282",
    "iMid": "IONPAYTEST",
    "currency": "IDR",
    "amt": "100",
    "instmntMon": null,
    "instmntType": "1",
    "referenceNo": "OrdNo20217131024122",
    "goodsNm": "Nicepay Subscription",
    "payMethod": "05",
    "billingNm": "HongGilDong",
    "reqDt": "20210823",
    "reqTm": "131045",
    "status": "0",
    "resultCd": "0000",
    "resultMsg": "paid",
    "cardNo": null,
    "preauthToken": null,
    "acquBankCd": null,
    "issuBankCd": null,
    "vacctValidDt": null,
    "vacctValidTm": null,
    "vacctNo": null,
    "bankCd": null,
    "payNo": null,
    "mitraCd": "DANA",
    "receiptCode": null,
    "cancelAmt": null,
    "transDt": "20210823",
    "transTm": "131250",
    "recurringToken": null,
    "ccTransType": null,
    "payValidDt": null,
    "payValidTm": null,
    "mRefNo": null,
    "acquStatus": null,
    "cardExpYymm": null,
    "acquBankNm": null,
    "issuBankNm": null,
    "depositDt": null,
    "depositTm": null,
    "paymentExpDt": null,
    "paymentExpTm": null,
    "paymentTrxSn": null,
    "cancelTrxSn": null,
    "userId": null,
    "shopId": null
}
```
:::

