헥토파이낸셜 개발자센터

Transaction History Inquiry API

Requests transaction history for payments and refunds.

Retrieve transaction details (payment/refund) using the merchant's order date and order number.

API Information

POST/v1/api/pay/translist
Content-Typeapplication/json
테스트https://tbnpay.settlebank.co.kr/v1/api/pay/translist
운영https://npay.settlebank.co.kr/v1/api/pay/translist

Request Parameters

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)Alphanumeric, up to 50 bytes*
Message information code.
*Fixed value
└mchtIdAN(8)Alphanumeric, up to 8 bytes*
Unique Merchant ID assigned by Hecto Financial.
└pktDivCdAN(2)Alphanumeric, up to 2 bytes*
Transaction type.
RP: Payment RT: Cancellation
*Transaction type of the order number
└mchtTrdNoAN(100)Alphanumeric, up to 100 bytes*
Merchant order number.
*No Korean characters
└mchtTrdDtAN(8)Alphanumeric, up to 8 bytes*
Order date.
*yyyyMMdd
└reqDtAN(8)Alphanumeric, up to 8 bytes*
Request date.
*yyyyMMdd
└reqTmAN(6)Alphanumeric, up to 6 bytes*
Request time.
*HH24MISS
└pktHashAN(200)Alphanumeric, up to 200 bytes*SHA-256(실시간 생성)
SHA-256 hash value.
*Merchant ID + order number + order date + request date + request time + auth key

Request Hash Code

ItemCombined fields
pktHash valueMerchant ID + order number + order date + request date + request time + auth key

Response Parameters

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└outStatCdAN(4)Alphanumeric, up to 4 bytes*
Transaction status code (success/failure).
0021: Success 0031: Failure
└outRsltCdAN(4)Alphanumeric, up to 4 bytes*
Decline code.
*Refer to rejection code table
└outRsltMsgAN(100)Alphanumeric, up to 100 bytes*Processed successfully.
Result message.
*Error details are returned when an error occurs.
└dataCntN(4)Numeric, up to 4 bytes*10
Number of transactions.
*When transaction history exists
└trRecords<object>*
Transaction history.
└--recordOutRsltCdAN(4)Alphanumeric, up to 4 bytes*ST00
Transaction result code.
*Refer to rejection code table
└--recordOutRsltMsgAN(200)Alphanumeric, up to 200 bytes*Success
Transaction result message.
└--recordOutStatCdAN(4)Alphanumeric, up to 4 bytes*
Transaction status code.
0021: Success 0031: Failure
└--recordPktDivCdAN(2)Alphanumeric, up to 2 bytes*RP
Transaction type.
RP: Payment RT: Cancellation
└--recordMchtTrdNoAN(100)Alphanumeric, up to 100 bytes*OID203739450
Order number.
*No Korean characters
└--recordTrdNoAN(40)Alphanumeric, up to 40 bytesSTFP_FIRM123454667789
Hecto Financial transaction reference number.
└--recordTrdDtAN(8)Alphanumeric, up to 8 bytes*20210820
Transaction date.
*yyyymmdd
└--recordTrdAmtN(13)Numeric, up to 13 bytes*1000
Transaction amount.
*Amount to debit (transaction amount)
└--recordBankCdAN(3)Alphanumeric, up to 3 bytes*011
Debit bank code.
└--recordCustAcntNoAN(15)Alphanumeric, up to 15 bytes*831*******11
Debit bank account number.
*Account number is masked
└--recordSvcDivCdN(1)Numeric, up to 1 bytes
Service used for the transaction.
1: Firm banking 2: Open Banking

Request Example

{
  "hdInfo": "SPAY_LT00_1.0",
  "mchtId": "midtest",
  "pktDivCd": "RP",
  "mchtTrdNo": "OID201902210001",
  "mchtTrdDt": "20191231",
  "reqDt": "20191231",
  "reqTm": "120000",
  "pktHash": "hash value"
}

Response Example

{
  "outStatCd": "0021",
  "outRsltCd": "0000",
  "outRsltMsg": "Processed successfully.",
  "dataCnt": "1",
  "trRecords": [
    {
      "recordOutRsltCd": "ST00",
      "recordOutRsltMsg": "Success",
      "recordOutStatCd": "0021",
      "recordPktDivCd": "RP",
      "recordMchtTrdNo": "OID203739450",
      "recordTrdNo": "STFP_FIRM123454667789",
      "recordTrdDt": "20210820",
      "recordTrdAmt": "1000",
      "recordBankCd": "011",
      "recordCustAcntNo": "831*******11",
      "recordSvcDivCd": "2"
    }
  ]
}
💬

Need technical support?