헥토파이낸셜 개발자센터

Transaction History API

Returns the complete transaction history for a specific order, including all payment and cancellation records.

Test Credentials

API Information

POST/v3/APITrInfo.do
Content-Typeapplication/json; charset=UTF-8
테스트https://tbezauthapi.settlebank.co.kr/v3/APITrInfo.do
운영https://ezauthapi.settlebank.co.kr:8081/v3/APITrInfo.do

Request Parameters

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)Alphanumeric, up to 50 bytes*
Message type code.
*Fixed value
└apiVerAN(4)Alphanumeric, up to 4 bytes*
API version.
*Fixed value
└mercntIdAN(8)Alphanumeric, up to 8 bytes*
Unique merchant identifier assigned by Hecto Financial.
└trDayN(8)Numeric, up to 8 bytes*
Transaction date from the original order (yyyyMMdd).
└ordNoAN(100)Alphanumeric, up to 100 bytes*
Order number to query.
└reqDayN(8)Numeric, up to 8 bytes*
Inquiry request date (yyyyMMdd).
└reqTimeN(6)Numeric, up to 6 bytes*
Inquiry request time (HH24MISS).
└signatureAN(200)Alphanumeric, up to 200 bytes*SHA-256(실시간 생성)
SHA-256 hash value for tamper protection.
NOTE

Signature Composition

mercntId + ordNo + trDay + reqDay + reqTime + hashKey

Response Parameters

└resultCdN(1)Numeric, up to 1 bytes*0
Result code.
0: Success -1: Failure
└errCdAN(5)Alphanumeric, up to 5 bytes*0000
Error code. See error code reference.
└resultMsgAN(200)Alphanumeric, up to 200 bytes*Success
Human-readable result message.
└trCntN(4)Numeric, up to 4 bytes*1
Number of transaction records returned.
└trListObject List*[{"trStatus": "0021", ...}]
Array of transaction records.

trList Object Fields

└trStatusAN(4)Alphanumeric, up to 4 bytes*0021
Transaction status code.
0021 / 3010 / 0: Success 0031: Failure 0011: Withdrawal in progress 0051: Refund in progress
└errCdAN(5)Alphanumeric, up to 5 bytes*
Error code for failed transactions.
└trTypeAN(2)Alphanumeric, up to 2 bytes*RP
Transaction type.
RP: Payment RT: Cancellation
└trDayN(8)Numeric, up to 8 bytes*20190221
Transaction date (yyyyMMdd).
└trTimeN(6)Numeric, up to 6 bytes*142120
Transaction time (HH24MISS).
└bankCdN(3)Numeric, up to 3 bytes*001
Bank code of the debited account.
└trPriceN(13)Numeric, up to 13 bytes*1000
Transaction amount.
└discntPriceN(13)Numeric, up to 13 bytes*0
Promotional discount amount applied.
└payPriceN(13)Numeric, up to 13 bytes*10000
Final settlement amount.
└criPriceN(13)Numeric, up to 13 bytes*13000
Cash receipt issuance amount.
└criTaxVatPriceN(13)Numeric, up to 13 bytes*11000
Cash receipt taxable amount (inclusive of VAT).
└criDutyFreePriceN(13)Numeric, up to 13 bytes*2000
Cash receipt tax-exempt amount.
└ordNoAN(100)Alphanumeric, up to 100 bytes*OID201902210001
Order number.
└trNoAN(50)Alphanumeric, up to 50 bytes*STFP_PNPTms00001t00220922182409M1962430
Hecto Financial transaction reference number.
└custParam1AN(128)Alphanumeric, up to 128 bytes
Merchant-defined data field 1.
└custParam2AN(128)Alphanumeric, up to 128 bytes
Merchant-defined data field 2.
└custParam3AN(128)Alphanumeric, up to 128 bytes
Merchant-defined data field 3.
└custParam4AN(128)Alphanumeric, up to 128 bytes
Merchant-defined data field 4.
💬

Need technical support?