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-8테스트
https://tb-mps-api.hectofinancial.co.kr/v1/trade/detail/market운영
https://mps-api.hectofinancial.co.kr/v1/trade/detail/marketRequest Parameters
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└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
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└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.
Need technical support?
Code Samples
HectoFinancial GitHub