---
title: Fail Transaction API
slug: nicepay-api-laporan-bisnis-fail-transaction-api
description: Informasi tentang API Fail Transaction dari API Laporan Bisnis yang terdapat pada sistem NICEPAY
image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/fpNLZdW7eRfiL_Vs_eYPc_nicepay-docs-logo.png
icon: {"faIcon":"fa-solid fa-circle-arrow-up"}
docTags:
createdAt: 2026-07-31T09:12:35.469Z
---
# Tentang Fail Transaction API
Fail Transaction API dapat digunakan Merchant untuk melakukan rekonsiliasi laporan transaksi yang gagal dalam sistem NICEPAY. Dengan API ini, Merchant dapat memperoleh daftar transaksi gagal hingga 5.000 data *per request*, sesuai dengan tanggal yang diminta.
:::Iframe{iframeHeight="0" code="Merchant harus menghubungi NICEPAY Customer Service dengan mengirimkan IP Merchant untuk proses Whitelist pada NICEPAY terlebih dahulu dan melakukan pengajuan kredensial API untuk menggunakan Fail Transaction API."}
:::
# Fail Transaction API
| **API End Point** | [`bo.nicepay.co.id/failReport.do`](https://bo.nicepay.co.id/failReport.do) |
| ---------------------------------------------- | ---------------------------------------------------------------------------- |
| **Request Method **application/json | ******POST** |
| **Description** | Untuk memeriksa laporan Fail Transaction dengan API NICEPAY |
| **Header** | `Content-Type: application/json` |
| **Request Format** | `application/json` |
:::hint{type="info"}
Nilai nominal transaksi yang tersedia dalam laporan ini menggunakan mata uang Rupiah.
:::
## Request Parameter
| **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** |
| ------------------------------------------------------ | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- |
| `mid`
Required | VARCHAR2 | 10 | iMid Merchant | IONPAYTEST |
| `passwd`
Required | VARCHAR2 | 100 | *Password* setelah proses Whitelist IP telah berhasil di-*register & approved* di sisi NICEPAY.
(Mohon untuk menghubungi **tim NICEPAY Customer Service** untuk asistensi). | 123456 |
| `date`
Required | VARCHAR2 | 8 | Tanggal data transaksi yang mau dilihat
Format: `YYYYMMDD` | 20260727 |
| `paymethod`
Required | VARCHAR2 | 2 | [Payment Method](docId\:CrGE1s9poBnuAdENJUkb8) | 00 |
| `startno`
Required | NUMBER | 10 | Nomor urut awal datatransaksi yang ingin ditampilkan (baris awal dari rentang data yang diminta). | 1
Default: 1 |
| `endno`
Required | NUMBER | 10 | Nomor urut akhir data transaksi yang ingin ditampilkan (baris akhir dari rentang data yang diminta).
**Notes**: Maksimal rentang data antara
`startno`
dan
`endno`
adalah 5.000 data. | 100
Default: 100 |
## Response Parameter
| **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** |
| ----------------------------------------------------------- | -------- | ---------- | -------------------------------------------------------------------------- | --------------------------------------- |
| `HEADER`
Required | Object | - | - | `"HEADER": { ... } ` |
| `CODE`
Required | NUMBER | 4 | [Header Code Response](docId\:CrGE1s9poBnuAdENJUkb8) | 00 |
| `MID`
Required | VARCHAR2 | 10 | iMid Merchant | IONPAYTEST |
| `TRANS_DT`
Required | VARCHAR2 | 8 | Tanggal data transaksi yang di-*request*
Format: `YYYYMMDD` | 20260727 |
| `DATA`
Required | Object | - | - | `"DATA": [ { ... } ] ` |
| `CODE`
Required | NUMBER | 2 | [Data Code Response](docId\:CrGE1s9poBnuAdENJUkb8) | 10 |
| `TXID`
Required | VARCHAR2 | 30 | ID Transaksi | IONPAYTEST01202607272022549895 |
| `ORDER_NO`
Required | VARCHAR2 | 8 | Nomor Referensi Merchant | 99999 |
| `RESULT_CD`
Required | N | 4 | Result Code | 9151 |
| `RESULT_MSG`
Required | AN | 255 | Result Message | cardBin Information exist in blackList. |
| `TRANS_DT`
Required | VARCHAR2 | 8 | Tanggal data transaksi yang di-*request*
Format : `YYYYMMDD` | 20260727 |
| `TRANS_TM`
Required | VARCHAR2 | 8 | Waktu jam dari data transaksi yang di-*request*
Format:
`HHmmss` | 202321 |
| `BILLING_NM`
Required | A | 100 | Buyer Name | John Doe |
| `PAY_METHOD`
Required | VARCHAR2 | 2 | [Payment Method](docId\:CrGE1s9poBnuAdENJUkb8) | 01 |
| `TRANS_AMT`
Required | NUMBER | 19,2 | Amount Transaksi | 1000 |
| `BANK_CD`
Optional | VARCHAR2 | 4 | [Bank Code](docId\:CrGE1s9poBnuAdENJUkb8) | CENA |
| `CUSTOMER_NO`
Required | VARCHAR2 | 40 | [Customer Account Transaction Number](docId\:CrGE1s9poBnuAdENJUkb8)
| 79150000\*\*\*\*\*\*\*\*8310 |
| `TAIL`
Required | Object | - | - | `"TAIL": { ... }` |
| `CODE`
Required | NUMBER | 4 | [Tail Code Response](docId\:CrGE1s9poBnuAdENJUkb8) | 99 |
| `MID`
Required | VARCHAR2 | 10 | iMid Merchant | IONPAYTEST |
| `TRANS_DT`
Required | VARCHAR2 | 8 | Tanggal data transaksi yang di-*request*
Format : `YYYYMMDD` | 20260727 |
| `FAIL_TRANS_CNT`
Required | NUMBER | 10 | Jumlah total volume transaksi yang gagal | 5 |
| `FAIL_TRANS_AMT`
Required | NUMBER | 19,2 | Jumlah total amount transaksi yang gagal | 14000 |
## Sample Parameter
:::CodeblockTabs
Request Parameter
```json
{
"mid": "IONPAYTEST",
"passwd": "gpAFym0vGYmGIcPz5dVDyoKprI+Uul4miEH7LLiJiLUWfESSk1egsFhb82DHyRZhHwbqaFjij9hhUfBSUgm4Yg==",
"date": "20260727",
"paymethod": "00",
"startno": 1,
"endno": 1000
}
```
Response Parameter
```json
{
"HEADER": {
"CODE": "00",
"MID": "IONPAYTEST",
"TRANS_DT": "20260727"
},
"DATA": [
{
"CODE": "10",
"TXID": "IONPAYTEST01202607272022549895",
"ORDER_NO": "T212F0I7HJUODYN",
"RESULT_CD": "9151",
"RESULT_MSG": "cardBin Information exist in blackList.",
"TRANS_DT": "20260727",
"TRANS_TM": "202321",
"BILLING_NM": "John Doe",
"PAY_METHOD": "01",
"TRANS_AMT": 15725,
"CUSTOMER_NO": "45353524********3322"
},
{
"CODE": "10",
"TXID": "IONPAYTEST01202607271029583585",
"ORDER_NO": "P21KKCBYWK87667",
"RESULT_CD": "-",
"RESULT_MSG": "Server is busy. Please kindly try again in few minutes.",
"TRANS_DT": "20260727",
"TRANS_TM": "103102",
"BILLING_NM": "John Doe",
"PAY_METHOD": "01",
"TRANS_AMT": 83670,
"BANK_CD": "CENA",
"CUSTOMER_NO": "34353453********3445"
},
{
"CODE": "10",
"TXID": "IONPAYTEST01202607271029583585",
"ORDER_NO": "P21KKCBYWK87667",
"RESULT_CD": "9151",
"RESULT_MSG": "cardBin Information exist in blackList.",
"TRANS_DT": "20260727",
"TRANS_TM": "103023",
"BILLING_NM": "John Doe",
"PAY_METHOD": "01",
"TRANS_AMT": 83670,
"CUSTOMER_NO": "45353453********3453"
}
],
"TAIL": {
"CODE": "99",
"MID": "IONPAYTEST",
"TRANS_DT": "20260727",
"FAIL_TRANS_CNT": 3,
"FAIL_TRANS_AMT": 183065
}
}
```
:::