Transaction Detail by Merchant Reference API
Retrieves transaction details using the merchant transaction reference number (mTrdNo).
API Information
POST/v1/trade/detail/market
Content-Type
application/json;charset=UTF-8Sandbox
https://tb-mps-api.hectofinancial.co.kr/v1/trade/detail/marketProduction
https://mps-api.hectofinancial.co.kr/v1/trade/detail/marketRequest Parameters
Type Notation
NNumericAAlphabeticHKoreanANAlphanumericAHNAlphanumeric + Koreane.g. AN(10) = alphanumeric, up to 10 bytes
└custNoAN(20)Alphanumeric, up to 20 bytes*Prepaid member number.
Prepaid member number.
*Unique prepaid member number assigned by Hecto Financial.
└ciAN(255)Alphanumeric, up to 255 bytes*
AES-256AES-256/ECB/PKCS5Padding + Base64Member CI value.Member CI value.
*Customer's unique CI value.
└mTrdNoAN(50)Alphanumeric, up to 50 bytes*Merchant transaction reference number.
Merchant transaction reference number.
*Transaction reference number generated by the merchant.
└periodAN(6)Alphanumeric, up to 6 bytes*Inquiry year-month.
Inquiry year-month.
*yyyyMM format.
Response Parameters
Type Notation
NNumericAAlphabeticHKoreanANAlphanumericAHNAlphanumeric + Koreane.g. AN(10) = alphanumeric, up to 10 bytes
└rsltCdAN(4)Alphanumeric, up to 4 bytes*Result code.
0000Result code.
0000: Success└rsltMsgAN(255)Alphanumeric, up to 255 bytes*Result message.
SuccessResult message.
└rsltObj.custNoAN(20)Alphanumeric, up to 20 bytes*Prepaid member number.
20240000Prepaid member number.
*Unique prepaid member number assigned by Hecto Financial.
└rsltObj.mTrdNoAN(50)Alphanumeric, up to 50 bytes*Merchant transaction reference number.
ORDER20240716Merchant transaction reference number.
*Transaction reference number generated by the merchant. No Korean characters.
└rsltObj.trdNoAN(50)Alphanumeric, up to 50 bytes*Transaction approval number.
24071616270200002193Transaction approval number.
*Unique transaction number assigned by Hecto Financial.
└rsltObj.chrgTrdNoAN(50)Alphanumeric, up to 50 bytesTop-up transaction number
Top-up transaction number
*Delivered when the transaction division code (trdDivCd) is a top-up (MP/PP).
└rsltObj.orgTrdNoAN(50)Alphanumeric, up to 50 bytesOriginal transaction number
ORDER20240715Original transaction number
*Empty by default. Delivered when trdDivCd is a cancellation type (UC/MC/PC).
└rsltObj.orgTrdDtAN(8)Alphanumeric, up to 8 bytesOriginal transaction date
Original transaction date
*Empty by default. Delivered when trdDivCd is a cancellation type (UC/MC/PC).
└rsltObj.reqDtAN(8)Alphanumeric, up to 8 bytesRequest date.
20240717Request date.
*Merchant request date. yyyyMMdd format.
└rsltObj.reqTmAN(6)Alphanumeric, up to 6 bytesRequest time.
190203Request time.
*Merchant request time. HHmmss format.
└rsltObj.trdDtAN(8)Alphanumeric, up to 8 bytes*Transaction date.
YYYYMMDDTransaction date.
*If a void was successful, this is the void transaction date.
└rsltObj.trdTmAN(6)Alphanumeric, up to 6 bytes*Transaction time.
HHMMSSTransaction time.
*If a void was successful, this is the void transaction time.
└rsltObj.trdDivCdAN(2)Alphanumeric, up to 2 bytes*Transaction code.
CUTransaction code.
CU: Spend UC: Spend void MP: Money top-up MC: Money top-up void MW: Money withdrawal WW: Pending withdrawal MG: Money gift transfer MR: Money received PP: Points issuance PC: Points issuance void└rsltObj.trdDivDtlCdAN(12)Alphanumeric, up to 12 bytesTransaction division detail code.
Transaction division detail code.
*Merchant transaction division detail code (only pre-registered values are used).
└rsltObj.chrgMeanCdAN(2)Alphanumeric, up to 2 bytesTop-up method code.
RATop-up method code.
*Applicable only to MP (Money top-up) and PP (Points issuance).
└rsltObj.trdSumryAN(100)Alphanumeric, up to 100 bytesTransaction summary.
987Transaction summary.
*Issuance reason, issuance void reason, or withdrawal bank account number (last 3 digits).
└rsltObj.trdAmtN(7)Numeric, up to 7 bytes*Transaction amount.
2000Transaction amount.
└rsltObj.mnyAmtN(7)Numeric, up to 7 bytes*Money amount.
1000Money amount.
└rsltObj.pntAmtN(7)Numeric, up to 7 bytes*Points amount.
1000Points amount.
└rsltObj.waitMnyAmtN(7)Numeric, up to 7 bytesPending Money amount.
1000Pending Money amount.
└rsltObj.mnyBlcN(7)Numeric, up to 7 bytes*Money balance.
1000Money balance.
└rsltObj.pntBlcN(7)Numeric, up to 7 bytes*Points balance.
1000Points balance.
└rsltObj.waitMnyBlcN(7)Numeric, up to 7 bytes*Pending Money balance.
1000Pending Money balance.
└rsltObj.mnyVldPdAN(8)Alphanumeric, up to 8 bytesMoney validity period.
20240722Money validity period.
*Applicable when transaction code is MP (Money top-up).
└rsltObj.pntVldPdAN(8)Alphanumeric, up to 8 bytesPoints validity period.
20240722Points validity period.
*Applicable when transaction code is PP (Points issuance).
└rsltObj.cnclYnAN(1)Alphanumeric, up to 1 bytesVoid flag.
NVoid flag.
*Applicable to CU (Spend), MP (Money top-up), and PP (Points issuance) transactions that have been voided.
└rsltObj.csrcIssReqYnAN(1)Alphanumeric, up to 1 bytesCash receipt request flag.
YCash receipt request flag.
*Applicable when transaction code is CU (Spend).
└rsltObj.csrcIssStatCdAN(1)Alphanumeric, up to 1 bytesCash receipt issuance status.
YCash receipt issuance status.
*Applicable when transaction code is CU (Spend).
└rsltObj.csrcAppNoAN(50)Alphanumeric, up to 50 bytesCash receipt approval number.
20240722100000Cash receipt approval number.
*Applicable when transaction code is CU (Spend).
└rsltObj.csrcApprDtmAN(14)Alphanumeric, up to 14 bytesCash receipt approval datetime.
Cash receipt approval datetime.
*Applicable when transaction code is CU (Spend). YYYYMMDDHHMMSS format.
└rsltObj.statusAN(1)Alphanumeric, up to 1 bytesTransaction status.
Transaction status.
0: Processing 1: Completed*Check withdrawal status for transaction codes MW (Money withdrawal), WW (Pending withdrawal), TW (Termination withdrawal).
└rsltObj.stlMIdAN(20)Alphanumeric, up to 20 bytesSettlement merchant ID.
Settlement merchant ID.
*Merchant ID for settlement target.
└rsltObj.storCdAN(20)Alphanumeric, up to 20 bytesStore code.
HF000001Store code.
└rsltObj.storNmAN(128)Alphanumeric, up to 128 bytesStore name.
Hecto FinancialStore name.
└rsltObj.cnclTrdAmtN(7)Numeric, up to 7 bytesVoid amount.
1000Void amount.
*For CU/MP/PP transaction codes, the void amount for the original transaction.
└rsltObj.cnclMnyAmtN(7)Numeric, up to 7 bytesVoid Money amount.
1000Void Money amount.
*For CU/MP/PP transaction codes, the void Money amount for the original transaction.
└rsltObj.cnclPntAmtN(7)Numeric, up to 7 bytesVoid Points amount.
1000Void Points amount.
*For CU/MP/PP transaction codes, the void Points amount for the original transaction.
└rsltObj.lastCnclDateN(14)Numeric, up to 14 bytesLast void date.
YYYYMMDDHH24MISSLast void date.
*For CU/MP/PP transaction codes, the date of the last void for the original transaction.
└rsltObj.mResrvField1AN(255)Alphanumeric, up to 255 bytesMerchant reserve field 1.
Merchant reserve field 1.
*Transmitted in plaintext. Do not include sensitive personal information.
└rsltObj.mResrvField2AN(255)Alphanumeric, up to 255 bytesMerchant reserve field 2.
Merchant reserve field 2.
*Transmitted in plaintext. Do not include sensitive personal information.
└rsltObj.mResrvField3AN(255)Alphanumeric, up to 255 bytesMerchant reserve field 3.
Merchant reserve field 3.
*Transmitted in plaintext. Do not include sensitive personal information.
Important Notes
NOTE
Response Data Format
rsltObj is a response object of LIST (array) type. Since multiple transaction records may match the criteria, each transaction is returned as an element of the array.
