QoinHub

Transaction History List

Terakhir diperbarui 27 Oktober 2026

Di halaman ini
Path/ordersnap/api/v1.0/transaction-history-list
HTTP MethodPOST
Versionv1.0
Service Code12
🔒

Khusus Akun Enterprise

Endpoint ini hanya dapat digunakan oleh merchant bertipe Enterprise. Untuk mengaktifkan status Enterprise, merchant wajib mengajukan permohonan (request) terlebih dahulu kepada tim QoinHub.

Request Header

Field NameField TypeMandatoryField Description
Content-TypeStringMMedia type of the resource, i.e. application/json
AuthorizationStringMRepresents access_token of a request; string starts with keyword “Bearer ” followed by access_token. Can get this token from Access Token B2B response. Read here
X-TIMESTAMPStringMClient’s current local time in ISO-8601 format
X-SIGNATUREStringMCreated using symmetric signature HMAC_SHA512 algorithm. Read here
X-PARTNER-IDStringMAPI Key / Client ID merchant (Web Merchant > Pengaturan > System Setting > tab Security Key)
X-EXTERNAL-IDStringMMerchant’s unique ID per transaction request
CHANNEL-IDStringOPJP’s channel id
Content-Typeapplication/json
AuthorizationBearer gp9HjjEj813Y9JGoqwOeOPWbnt4CupvIJbU1Mmu4a11MNDZ7Sg5u9a
X-TIMESTAMP2026-10-27T11:00:00+07:00
X-SIGNATUREqoda1fa417c72d6b91c257e01e54fac824
X-PARTNER-ID7fb118fb-2738-4886-9817-8a2c4de43001
X-EXTERNAL-ID41807553358950093184162180797837
CHANNEL-ID95221

Request Body

Field NameField TypeMandatoryField Description
fromDateTimeStringMTanggal dan waktu awal rentang pencarian transaksi.
Format: YYYY-MM-DDTHH:mm:ss+07:00 atau YYYY-MM-DD 15:04:05 atau YYYY-MM-DD
toDateTimeStringMTanggal dan waktu akhir rentang pencarian transaksi.
Format: YYYY-MM-DDTHH:mm:ss+07:00 atau YYYY-MM-DD 15:04:05 atau YYYY-MM-DD
partnerReferenceNoStringONomor referensi transaksi dari sistem partner/merchant
referenceNoStringONomor transaksi dari sistem QoinHub
pageSizeStringOJumlah baris data per halaman (default: 10)
pageNumberStringONomor halaman data (default: 1)
additionalInfoObjectOObjek data tambahan jika diperlukan
json
{
  "fromDateTime": "2026-10-01T00:00:00+07:00",
  "toDateTime": "2026-10-27T23:59:59+07:00",
  "partnerReferenceNo": "INV-20261027-001",
  "referenceNo": "TRX-001",
  "pageSize": "10",
  "pageNumber": "1",
  "additionalInfo": {}
}

Response Body

Field NameField TypeMandatoryField Description
responseCodeString(7)MKode status hasil transaksi (Contoh: 2001200)
responseMessageString(150)MDeskripsi hasil transaksi
referenceNoStringONomor transaksi dari sistem QoinHub (sesuai request)
partnerReferenceNoStringONomor referensi transaksi dari merchant (sesuai request)
detailDataArray of ObjectsMDaftar riwayat transaksi
detailData[].referenceNoStringMNomor transaksi dari sistem QoinHub
detailData[].partnerReferenceNoStringMNomor referensi transaksi dari sistem merchant
detailData[].amountObjectMTotal nominal transaksi
detailData[].amount.valueStringMNominal transaksi dengan format 2 digit desimal (Contoh: 50000.00)
detailData[].amount.currencyString(3)MKode mata uang sesuai ISO 4217 (IDR)
detailData[].feeAmountObjectMTotal biaya transaksi (fee, MDR fee, dll.)
detailData[].feeAmount.valueStringMNominal biaya dengan format 2 digit desimal (Contoh: 2250.00)
detailData[].feeAmount.currencyString(3)MKode mata uang sesuai ISO 4217 (IDR)
detailData[].dateTimeStringMWaktu pembuatan transaksi dalam format ISO-8601 (YYYY-MM-DDTHH:mm:ss+07:00)
detailData[].statusStringMStatus transaksi: SUCCESS, PENDING, FAILED
detailData[].typeStringMTipe transaksi (PAYMENT)
detailData[].additionalInfoObjectOInformasi detail tambahan transaksi
detailData[].additionalInfo.merchantNoStringOKode merchant
detailData[].additionalInfo.paymentStringOChannel pembayaran yang digunakan (Contoh: QRIS, bcava)
detailData[].additionalInfo.vaNoStringONomor VA / nomor pembayaran
detailData[].additionalInfo.payerNameStringONama pembayar
detailData[].additionalInfo.payerPhoneStringONomor telepon pembayar
detailData[].additionalInfo.payerEmailStringOEmail pembayar
detailData[].additionalInfo.lastUpdateStringOWaktu pembaruan status transaksi terakhir (ISO-8601)
detailData[].additionalInfo.expireStringOWaktu kedaluwarsa pembayaran (ISO-8601)
detailData[].additionalInfo.payCodeStringOKode bayar / auth code
detailData[].additionalInfo.rrnStringORetrieval Reference Number (RRN)
detailData[].additionalInfo.tipsAmountStringONominal tip transaksi (format 2 digit desimal)
detailData[].additionalInfo.issuerIdStringOID bank/issuer penyedia layanan
detailData[].additionalInfo.cpanStringOCustomer PAN (termasking/nomor kartu/akun)
additionalInfoObjectOObjek data tambahan tingkat root
json
{
  "responseCode": "2001200",
  "responseMessage": "Request has been processed successfully",
  "referenceNo": "TRX-001",
  "partnerReferenceNo": "INV-20261027-001",
  "detailData": [
    {
      "referenceNo": "TRX-001",
      "partnerReferenceNo": "INV-20261027-001",
      "amount": {
        "value": "50000.00",
        "currency": "IDR"
      },
      "feeAmount": {
        "value": "2250.00",
        "currency": "IDR"
      },
      "dateTime": "2026-10-27T10:15:30+07:00",
      "status": "SUCCESS",
      "type": "PAYMENT",
      "additionalInfo": {
        "merchantNo": "MC12345",
        "payment": "QRIS",
        "vaNo": "08123456789",
        "payerName": "Customer Name",
        "payerPhone": "081234567890",
        "payerEmail": "customer@example.com",
        "lastUpdate": "2026-10-27T10:16:00+07:00",
        "expire": "2026-10-27T10:45:30+07:00",
        "payCode": "PC001",
        "rrn": "RRN123456",
        "tipsAmount": "2000.00",
        "issuerId": "93600001",
        "cpan": "9360000112345678"
      }
    }
  ],
  "additionalInfo": {}
}

List Response Code

Response CodeHTTP StatusDescription
2001200200Request has been processed successfully
4001201400Invalid Field Format {field name}
4001202400Invalid Mandatory Field {field name}
4011200401Unauthorized. [Reason]
4011201401Invalid Token (B2B)
4091200409Conflict
5001201500Internal Server Error
SebelumnyaTransaction HistorySelanjutnyaTransaction History Detail