Fail Transaction API
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.
Fail Transaction API
API End Point | |
|---|---|
Request Method application/json | POST |
Description | Untuk memeriksa laporan Fail Transaction dengan API NICEPAY |
Header | Content-Type: application/json |
Request Format | application/json |
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 | 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 | 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 | 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 | 01 | |
TRANS_AMT Required | NUMBER | 19,2 | Amount Transaksi | 1000 |
BANK_CD Optional | VARCHAR2 | 4 | CENA | |
CUSTOMER_NO Required | VARCHAR2 | 40 | 79150000********8310 | |
TAIL Required | Object | - | - | "TAIL": { ... } |
CODE Required | NUMBER | 4 | 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
{
"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
}
}