---
title: Transaction History API
slug: nicepay-api-laporan-bisnis-transaction-history-api
description: Informasi tentang API Transaction History dari API Laporan Bisnis yang terdapat pada sistem NICEPAY
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/yHexzN7oNuKR05-Su7doQ_nicepay-docs-logo.png
icon: {"faIcon":"fa-solid fa-circle-up"}
docTags: 
createdAt: 2022-11-18T05:12:37.000Z
---

# Tentang Transaction History API

***

Transaction History API digunakan untuk rekonsiliasi status dan *amount* transaksi dengan NICEPAY. Dengan API ini, Merchant akan mendapatkan daftar data transaksi hingga 5.000 data per *request* sesuai dari tanggal yang diminta.

:::Iframe{iframeHeight="0" code="Merchant harus menghubungi <a style=&#x22;color:blue;text-decoration-line:underline&#x22; href=&#x22;mailto:cs@nicepay.co.id&#x22;>NICEPAY Customer Service</a> dengan mengirimkan IP Merchant untuk proses Whitelist pada NICEPAY terlebih dahulu dan melakukan pengajuan kredensial API untuk menggunakan Transaction History API."}

:::



# Transaction History API

***

| **API End Point**        | [](https://bo.nicepay.co.id/transdt.do)            |
| ------------------------ | -------------------------------------------------- |
| **Request Method&#x20;** | <font color="#3b9f0f">**POST**</font>****          |
| **Description**          | To check transaction history with NICEPAY via API  |
| **Header**               | `Content-Type: application/json`                   |
| **Request Format**       | `application/json`                                 |

:::hint{type="info"}
Nilai transaksi yang tersedia dalam laporan ini menggunakan mata uang Rupiah.
:::

## Request Parameter

| **Parameter**                                        | **Tipe** | **Ukuran** | **Deskripsi**                                                                                                                                                        | **Contoh / Catatan**  |
| ---------------------------------------------------- | -------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- |
| `mid`<br /><font color="#2166ae">Required</font>     | VARCHAR2 | 10         | iMid Merchant                                                                                                                                                        | IONPAYTEST            |
| `passwd`<br /><font color="#2166ae">Required</font>  | VARCHAR2 | 100        | *Password* setelah proses Whitelist IP telah berhasil di-*register* di sisi NICEPAY <br />(Mohon untuk menghubungi **tim NICEPAY Customer Service** untuk asistensi) | 123456                |
| `transdt`<br /><font color="#2166ae">Required</font> | VARCHAR2 | 8          | Tanggal data transaksi yang mau dilihat<br />Format: `YYYYMMDD`                                                                                                      | 20200101              |
| `startno`<br /><font color="#2166ae">Required</font> | NUMBER   | 10         | Awal dari data transaksi yang hendak dilihat                                                                                                                         | 1<br />Default: 1     |
| `endno`<br /><font color="#2166ae">Required</font>   | NUMBER   | 10         | Akhir dari data transaksi yang mau dilihat maksimal 5000                                                                                                             | 100<br />Default: 100 |

## Response Parameter

| **Parameter**                                              | **Tipe** | **Ukuran** | **Deskripsi**                                                                | **Contoh / Catatan**           |
| ---------------------------------------------------------- | -------- | ---------- | ---------------------------------------------------------------------------- | ------------------------------ |
| `HEADER`<br /><font color="#2166ae">Required</font>        | Object   | -          | -                                                                            | `"HEADER": {...}`              |
| `CODE`<br /><font color="#2166ae">Required</font>          | NUMBER   | 4          | Code Response                                                                | 00                             |
| `MID`<br /><font color="#2166ae">Required</font>           | VARCHAR2 | 10         | iMid Merchant                                                                | IONPAYTEST                     |
| `TRANS_DT`<br /><font color="#2166ae">Required</font>      | VARCHAR2 | 8          | Tanggal data transaksi yang di-*request*<br />Format: `YYYYMMDD`             | 20200101                       |
| `DATA`<br /><font color="#2166ae">Required</font>          | Object   | -          | -                                                                            | `"DATA": [  { ... } ]`         |
| `CODE`<br /><font color="#2166ae">Required</font>          | NUMBER   | 4          | Code Response                                                                | 10                             |
| `TXID`<br /><font color="#2166ae">Required</font>          | VARCHAR2 | 30         | ID Transaksi                                                                 | IONPAYTEST01202001010010379759 |
| `ORDER_NO`<br /><font color="#2166ae">Required</font>      | NUMBER   | 10         | Nomor Referensi Merchant                                                     | 99999                          |
| `TRANS_STATUS`<br /><font color="#2166ae">Required</font>  | NUMBER   | 2          | Status Transaksi: [Transaction Status Code](docId\:CrGE1s9poBnuAdENJUkb8)    | 0                              |
| `TRANS_DT`<br /><font color="#2166ae">Required</font>      | VARCHAR2 | 8          | Tanggal data transaksi yang di-*request*<br />Format : `YYYYMMDD`            | 20200101                       |
| `TRANS_TM`<br /><font color="#2166ae">Required</font>      | VARCHAR2 | 8          | Waktu jam dari data transaksi yang direquest<br />Format:<br />`HHmmss`      | 001037                         |
| `CANCEL_DT`<br /><font color="#2166ae">Required</font>     | VARCHAR2 | 8          | Tanggal pembatalan transaksi <br />Format: `YYYYMMDD`                        | -                              |
| `CANCEL_TM`<br /><font color="#2166ae">Required</font>     | VARCHAR2 | 8          | Waktu pembatalan transaksi <br />Format: `HHmmss`                            | -                              |
| `PAY_METHOD`<br /><font color="#2166ae">Required</font>    | VARCHAR2 | 2          | Payment Method                                                               | 01                             |
| `TRANS_AMT`<br /><font color="#2166ae">Required</font>     | NUMBER   | 19,2       | Amount Transaksi                                                             | 10000                          |
| `CUSTOMER_NO`<br /><font color="#2166ae">Required</font>   | VARCHAR2 | 40         | Customer Account Transaction Number                                          | 123412\*\*12341234             |
| `SETTLMNT_DT`<br /><font color="#2166ae">Required</font>   | VARCHAR2 | 8          | Tanggal Settlement apabila sudah tersedia akan muncul                        | -                              |
| `TAIL`<br /><font color="#2166ae">Required</font>          | Object   | -          | -                                                                            | `"TAIL": { ... }`              |
| `CODE`<br /><font color="#2166ae">Required</font>          | NUMBER   | 4          | Code Response                                                                | 99                             |
| `MID`<br /><font color="#2166ae">Required</font>           | VARCHAR2 | 10         | iMid Merchant                                                                | IONPAYTEST                     |
| `TRANS_DT`<br /><font color="#2166ae">Required</font>      | VARCHAR2 | 8          | Tanggal data transaksi yang di-*request*<br />Format: `YYYYMMDD`             | 20200101                       |
| `APP_TRANS_CNT`<br /><font color="#2166ae">Required</font> | NUMBER   | 10         | Jumlah total volume transaksi                                                | 6                              |
| `APP_TRANS_AMT`<br /><font color="#2166ae">Required</font> | NUMBER   | 19,2       | Jumlah total amount transaksi                                                | 290087                         |
| `CC_TRANS_CNT`<br /><font color="#2166ae">Required</font>  | NUMBER   | 10         | Jumlah total volume transaksi refund                                         | 0                              |
| `CC_TRANS_AMT`<br /><font color="#2166ae">Required</font>  | NUMBER   | 19,2       | Jumlah total amount transaksi refund                                         | 0                              |

## Sample Parameter

:::CodeblockTabs
Request

```json
{
    "mid":"IONPAYTEST",
    "passwd":"123456",
    "transdt":"20200101",
    "startno":"1",
    "endno":"5000"
}
```

Response

```json
{
  "HEADER": {
    "CODE": "00",
    "MID": "IONPAYTEST",
    "TRANS_DT": "20200101"
  },
  "DATA": [
    {
      "CODE": "10",
      "TXID": "IONPAYTEST01202001010010379759",
      "ORDER_NO": "99999",
      "TRANS_STATUS": "0",
      "TRANS_DT": "20200101",
      "TRANS_TM": "001037",
      "CANCEL_DT": "-",
      "CANCEL_TM": "-",
      "PAY_METHOD": "01",
      "TRANS_AMT": 10000,
      "CUSTOMER_NO": "123412******12341234",
      "SETTLMNT_DT": "-"
    },
    {
      "CODE": "10",
      "TXID": "IONPAYTEST01202001010015131172",
      "ORDER_NO": "99999",
      "TRANS_STATUS": "0",
      "TRANS_DT": "20200101",
      "TRANS_TM": "001513",
      "CANCEL_DT": "-",
      "CANCEL_TM": "-",
      "PAY_METHOD": "01",
      "TRANS_AMT": 10000,
      "CUSTOMER_NO": "123412******12341234",
      "SETTLMNT_DT": "-"
    },
    {
      "CODE": "10",
      "TXID": "IONPAYTEST01202001010950206003",
      "ORDER_NO": "T2148P7ZU8GXADB",
      "TRANS_STATUS": "0",
      "TRANS_DT": "20200101",
      "TRANS_TM": "095019",
      "CANCEL_DT": "-",
      "CANCEL_TM": "-",
      "PAY_METHOD": "01",
      "TRANS_AMT": 65018,
      "CUSTOMER_NO": "111133******5555",
      "SETTLMNT_DT": "-"
    },
    {
      "CODE": "10",
      "TXID": "IONPAYTEST01202001010950256020",
      "ORDER_NO": "T210LX4NZ3F7N35",
      "TRANS_STATUS": "0",
      "TRANS_DT": "20200101",
      "TRANS_TM": "095025",
      "CANCEL_DT": "-",
      "CANCEL_TM": "-",
      "PAY_METHOD": "01",
      "TRANS_AMT": 29018,
      "CUSTOMER_NO": "111112******12222111",
      "SETTLMNT_DT": "-"
    },
    {
      "CODE": "10",
      "TXID": "IONPAYTEST05202001011020342509",
      "ORDER_NO": "T21FZF8IBZAE1OM",
      "TRANS_STATUS": "0",
      "TRANS_DT": "20200101",
      "TRANS_TM": "102034",
      "CANCEL_DT": "-",
      "CANCEL_theTM": "-",
      "PAY_METHOD": "05",
      "TRANS_AMT": 29018,
      "CUSTOMER_NO": "-",
      "SETTLMNT_DT": "-"
    },
    {
      "CODE": "10",
      "TXID": "IONPAYTEST02202001011041357152",
      "ORDER_NO": "T21VQB05AP8KS7O",
      "TRANS_STATUS": "0",
      "TRANS_DT": "20200101",
      "TRANS_TM": "104306",
      "CANCEL_DT": "-",
      "CANCEL_TM": "-",
      "PAY_METHOD": "02",
      "TRANS_AMT": 147033,
      "CUSTOMER_NO": "70014000091041357152",
      "SETTLMNT_DT": "-"
    }
  ],
  "TAIL": {
    "CODE": "99",
    "MID": "IONPAYTEST",
    "TRANS_DT": "20200101",
    "APP_TRANS_CNT": 6,
    "APP_TRANS_AMT": 290087,
    "CC_TRANS_CNT": 0,
    "CC_TRANS_AMT": 0
  }
}
```
:::