Transaction Detail API
Retrieves detailed information for a specific transaction.
API Information
POST/v1/trade/detail
Content-Type
application/json테스트
https://tb-mps-api.hectofinancial.co.kr/v1/trade/detail운영
https://mps-api.hectofinancial.co.kr/v1/trade/detailRequest 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. AES-256/ECB/PKCS5Padding encryption required.
└trdNoAN(50)Alphanumeric, up to 50 bytes*Transaction approval number.
Transaction approval number.
*Unique transaction number assigned by Hecto Financial.
└trdDtAN(8)Alphanumeric, up to 8 bytes*Transaction approval date.
Transaction approval date.
*yyyyMMdd format.
Response Parameters
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└rsltCdAN(4)Alphanumeric, up to 4 bytes*Result code.
0000Result code.
0000: Success Other: Failure└rsltMsgAN(255)Alphanumeric, up to 255 bytes*Result message.
SuccessResult message.
rsltObj (Response Object)
└custNoAN(20)Alphanumeric, up to 20 bytes*Prepaid member number.
2400001605Prepaid member number.
└mtrdNoAN(50)Alphanumeric, up to 50 bytes*Merchant transaction reference number.
ORDER20240716Merchant transaction reference number.
*No Korean characters.
└trdNoAN(50)Alphanumeric, up to 50 bytes*Transaction approval number.
24071616270200002193Transaction approval number.
*Unique transaction number assigned by Hecto Financial.
└orgTrdNoAN(50)Alphanumeric, up to 50 bytesOriginal transaction approval number.
ORDER20240715Original transaction approval number.
*Populated when an original transaction exists (transaction codes UC, MC, PC).
└reqDtAN(8)Alphanumeric, up to 8 bytesRequest date.
20240717Request date.
*Merchant request date. yyyyMMdd format.
└reqTmAN(6)Alphanumeric, up to 6 bytesRequest time.
190203Request time.
*Merchant request time. HHmmss format.
└trdDtAN(8)Alphanumeric, up to 8 bytes*Transaction date.
20240716Transaction date.
*yyyyMMdd format.
└trdTmAN(6)Alphanumeric, up to 6 bytes*Transaction time.
164101Transaction time.
*HHmmss format.
└trdDivCdAN(2)Alphanumeric, up to 2 bytes*Transaction code.
Transaction 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└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).
└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).
└trdSumryAN(100)Alphanumeric, up to 100 bytesTransaction summary.
987Transaction summary.
*Issuance reason, issuance void reason, or withdrawal bank account number (last 3 digits).
└trdAmtN(7)Numeric, up to 7 bytes*Transaction amount.
2000Transaction amount.
└mnyAmtN(7)Numeric, up to 7 bytes*Money amount.
1000Money amount.
└pntAmtN(7)Numeric, up to 7 bytes*Points amount.
1000Points amount.
└waitMnyAmtN(7)Numeric, up to 7 bytesPending Money amount.
0Pending Money amount.
└mnyBlcN(7)Numeric, up to 7 bytes*Money balance.
10000Money balance.
└pntBlcN(7)Numeric, up to 7 bytes*Points balance.
1000Points balance.
└waitMnyBlcN(7)Numeric, up to 7 bytes*Pending Money balance.
0Pending Money balance.
└mnyVldPdAN(8)Alphanumeric, up to 8 bytesMoney validity period.
20340722Money validity period.
*Applicable when transaction code is MP (Money top-up). yyyyMMdd format.
└pntVldPdAN(8)Alphanumeric, up to 8 bytesPoints validity period.
20340722Points validity period.
*Applicable when transaction code is PP (Points issuance). yyyyMMdd format.
└cnclYnAN(1)Alphanumeric, up to 1 bytesVoid flag.
Void flag.
Y: Voided N: Not voided*Applicable to CU (Spend), MP (Money top-up), and PP (Points issuance) transactions that have been voided.
└csrcIssReqYnAN(1)Alphanumeric, up to 1 bytesCash receipt request flag.
Cash receipt request flag.
Y: Requested N: Not requested*Applicable when transaction code is CU (Spend).
└csrcIssStatCdAN(1)Alphanumeric, up to 1 bytesCash receipt issuance status.
Cash receipt issuance status.
*Applicable when transaction code is CU (Spend).
└csrcAppNoAN(50)Alphanumeric, up to 50 bytesCash receipt approval number.
20240722100000Cash receipt approval number.
*Applicable when transaction code is CU (Spend).
└csrcApprDtmAN(14)Alphanumeric, up to 14 bytesCash receipt approval datetime.
Cash receipt approval datetime.
*Applicable when transaction code is CU (Spend). YYYYMMDDHHMMSS format.
└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).
└stlMIdAN(20)Alphanumeric, up to 20 bytesSettlement merchant ID.
Settlement merchant ID.
*Merchant ID for settlement target.
└storCdAN(20)Alphanumeric, up to 20 bytesStore code.
HF000001Store code.
└storNmAN(128)Alphanumeric, up to 128 bytesStore name.
Hecto FinancialStore name.
└cnclTrdAmtN(7)Numeric, up to 7 bytesVoid amount.
1000Void amount.
*For CU/MP/PP transaction codes, the void amount for the original transaction.
└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.
└cnclPntAmtN(7)Numeric, up to 7 bytesVoid Points amount.
0Void Points amount.
*For CU/MP/PP transaction codes, the void Points amount for the original transaction.
└lastCnclDateN(14)Numeric, up to 14 bytesLast void date.
20240718190801Last void date.
*For CU/MP/PP transaction codes, the date of the last void for the original transaction. YYYYMMDDHH24MISS format.
└mResrvField1AN(255)Alphanumeric, up to 255 bytesMerchant reserve field 1.
Merchant reserve field 1.
*Transmitted in plaintext. Do not include sensitive personal information.
└mResrvField2AN(255)Alphanumeric, up to 255 bytesMerchant reserve field 2.
Merchant reserve field 2.
*Transmitted in plaintext. Do not include sensitive personal information.
└mResrvField3AN(255)Alphanumeric, up to 255 bytesMerchant reserve field 3.
Merchant reserve field 3.
*Transmitted in plaintext. Do not include sensitive personal information.
Request Example
{
"custNo": "2400001605",
"ci": "AES-encrypted CI value",
"trdNo": "24071616270200002193",
"trdDt": "20240716"
}
Response Examples
Success (Spend Transaction)
{
"rsltCd": "0000",
"rsltMsg": "Success",
"rsltObj": {
"custNo": "2400001605",
"mtrdNo": "ORDER20240716",
"trdNo": "24071616270200002193",
"reqDt": "20240716",
"reqTm": "164100",
"trdDt": "20240716",
"trdTm": "164101",
"trdDivCd": "CU",
"trdSumry": "",
"trdAmt": "10000",
"mnyAmt": "9000",
"pntAmt": "1000",
"waitMnyAmt": "0",
"mnyBlc": "11000",
"pntBlc": "0",
"waitMnyBlc": "0",
"cnclYn": "N",
"csrcIssReqYn": "Y",
"csrcIssStatCd": "Y",
"csrcAppNo": "20240716164102",
"csrcApprDtm": "20240716164102",
"storCd": "HF000001",
"storNm": "Hecto Financial",
"cnclTrdAmt": "0",
"cnclMnyAmt": "0",
"cnclPntAmt": "0"
}
}
Success (Withdrawal Transaction)
{
"rsltCd": "0000",
"rsltMsg": "Success",
"rsltObj": {
"custNo": "2400001605",
"mtrdNo": "ORDER20240717",
"trdNo": "24071716270200002194",
"trdDt": "20240717",
"trdTm": "100000",
"trdDivCd": "MW",
"trdSumry": "987",
"trdAmt": "50000",
"mnyAmt": "50000",
"pntAmt": "0",
"mnyBlc": "0",
"pntBlc": "0",
"waitMnyBlc": "0",
"status": "1"
}
}
Failure
{
"rsltCd": "1001",
"rsltMsg": "Transaction information does not exist."
}
Need technical support?
Code Samples
HectoFinancial GitHub