헥토파이낸셜 개발자센터

Transaction History API

Retrieves a list of a member's transactions.

API Information

POST/v1/trade/list
Content-Typeapplication/json
테스트https://tb-mps-api.hectofinancial.co.kr/v1/trade/list
운영https://mps-api.hectofinancial.co.kr/v1/trade/list

Transaction Codes

CodeDescription
CUSpend
UCSpend void
MPMoney top-up
MCMoney top-up void
MWMoney withdrawal
WWPending withdrawal
MGMoney gift transfer
MRMoney received
PPPoints issuance
PCPoints issuance void

Request Parameters

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└custNoAN(20)Alphanumeric, up to 20 bytes*
Prepaid member number.
*Unique prepaid member number assigned by Hecto Financial.
└ciAN(255)Alphanumeric, up to 255 bytes*AES-256AES-256/ECB/PKCS5Padding + Base64
Member CI value.
*Customer's unique CI value. AES-256/ECB/PKCS5Padding encryption required.
└periodAN(6)Alphanumeric, up to 6 bytes
Inquiry year-month.
*YYYYMM format. Defaults to the current month.
└pageN(3)Numeric, up to 3 bytes
Page number.
*Defaults to 1.
└sizeN(3)Numeric, up to 3 bytes
Items per page.
*Defaults to 10.
└trdDivCdAN(128)Alphanumeric, up to 128 bytes
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
*Separate multiple transaction codes with a comma. Example: MG,MR,UC,PP
└trdNoAN(50)Alphanumeric, up to 50 bytes
Transaction approval number.
*Unique transaction number assigned by Hecto Financial.
└mTrdNoAN(50)Alphanumeric, up to 50 bytes
Merchant transaction reference number.
*Transaction reference number generated by the merchant (no Korean characters).
└showCnclYnAN(1)Alphanumeric, up to 1 bytes
Include void transactions flag.
Y: Include void transactions N: Exclude void transactions
*By default, void transactions are not included in the transaction history. Set to Y to include void transactions as separate entries. Note: this flag is ignored when trdDivCd is specified.
└blcDivCdAN(1)Alphanumeric, up to 1 bytes
Balance division code.
M: Money/Pending Money P: Points
*If omitted, all transactions are returned. M returns transactions where Money/Pending Money amount is greater than 0. P returns transactions where Points amount is greater than 0.
└cardTrdOnlyYnAN(1)Alphanumeric, up to 1 bytes
Card transaction only flag.
Y: Card transactions only N: All transactions
*When Y, only card transactions are returned. trdDivCd must be CU (Spend) or UC (Spend void).

Response Parameters

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└rsltCdAN(4)Alphanumeric, up to 4 bytes*0000
Result code.
0000: Success Other: Failure
└rsltMsgAN(255)Alphanumeric, up to 255 bytes*Success
Result message.

rsltObj (Response Object - LIST type)

└custNoAN(20)Alphanumeric, up to 20 bytes*2400001605
Prepaid member number.
└mTrdNoAN(50)Alphanumeric, up to 50 bytes*ORDER20240716
Merchant transaction reference number.
*No Korean characters.
└trdNoAN(50)Alphanumeric, up to 50 bytes*24071616270200002193
Transaction approval number.
*Unique transaction number assigned by Hecto Financial.
└chrgTrdNoAN(50)Alphanumeric, up to 50 bytes
Top-up transaction number
*Delivered when the transaction division code (trdDivCd) is a top-up (MP/PP).
└orgTrdNoAN(50)Alphanumeric, up to 50 bytes
Original transaction number
*Empty by default. Delivered when trdDivCd is a cancellation type (UC/MC/PC).
└orgTrdDtAN(8)Alphanumeric, up to 8 bytes
Original transaction date
*Empty by default. Delivered when trdDivCd is a cancellation type (UC/MC/PC).
└trdDtAN(8)Alphanumeric, up to 8 bytes*20240716
Transaction date.
*yyyyMMdd format.
└trdTmAN(6)Alphanumeric, up to 6 bytes*164101
Transaction time.
*HHmmss format.
└trdDivCdAN(2)Alphanumeric, up to 2 bytes*
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 bytes
Transaction division detail code.
*Merchant transaction division detail code (only pre-registered values are used).
└chrgMeanCdAN(2)Alphanumeric, up to 2 bytes*RA
Top-up method code.
*Applicable only to MP (Money top-up) and PP (Points issuance).
└trdSumryAN(100)Alphanumeric, up to 100 bytes987
Transaction summary.
*Issuance reason, issuance void reason, or withdrawal bank account number (last 3 digits).
└trdAmtN(7)Numeric, up to 7 bytes*2000
Transaction amount.
└mnyAmtN(7)Numeric, up to 7 bytes*1000
Money amount.
└pntAmtN(7)Numeric, up to 7 bytes*1000
Points amount.
└waitMnyAmtN(7)Numeric, up to 7 bytes*0
Pending Money amount.
└cnclTrdAmtN(7)Numeric, up to 7 bytes1000
Void amount.
*For CU/MP/PP transaction codes, the void amount for the original transaction.
└cnclMnyAmtN(7)Numeric, up to 7 bytes1000
Void Money amount.
*For CU/MP/PP transaction codes, the void Money amount for the original transaction.
└cnclPntAmtN(7)Numeric, up to 7 bytes0
Void Points amount.
*For CU/MP/PP transaction codes, the void Points amount for the original transaction.
└lastCnclDateN(14)Numeric, up to 14 bytes20240718190801
Last void date.
*For CU/MP/PP transaction codes, the date of the last void for the original transaction. YYYYMMDDHH24MISS format.
└stlMIdAN(20)Alphanumeric, up to 20 bytes
Settlement merchant ID.
*Merchant ID for settlement target.
└storCdAN(20)Alphanumeric, up to 20 bytesHF000001
Store code.
└storNmAN(128)Alphanumeric, up to 128 bytesHecto Financial
Store name.
└mResrvField1AN(255)Alphanumeric, up to 255 bytes
Merchant reserve field 1.
*Transmitted in plaintext. Do not include sensitive personal information.
└mResrvField2AN(255)Alphanumeric, up to 255 bytes
Merchant reserve field 2.
*Transmitted in plaintext. Do not include sensitive personal information.
└mResrvField3AN(255)Alphanumeric, up to 255 bytes
Merchant reserve field 3.
*Transmitted in plaintext. Do not include sensitive personal information.

Request Example

{
  "custNo": "2400001605",
  "ci": "AES-encrypted CI value",
  "period": "202407",
  "page": 1,
  "size": 10,
  "trdDivCd": "CU,MP"
}

Response Examples

Success

{
  "rsltCd": "0000",
  "rsltMsg": "Success",
  "rsltObj": [
    {
      "custNo": "2400001605",
      "mTrdNo": "ORDER20240716",
      "trdNo": "24071616270200002193",
      "trdDt": "20240716",
      "trdTm": "164101",
      "trdDivCd": "CU",
      "chrgMeanCd": "",
      "trdSumry": "",
      "trdAmt": "10000",
      "mnyAmt": "9000",
      "pntAmt": "1000",
      "waitMnyAmt": "0",
      "cnclTrdAmt": "0",
      "cnclMnyAmt": "0",
      "cnclPntAmt": "0",
      "storCd": "HF000001",
      "storNm": "Hecto Financial",
      "chrgTrdNo": "",
      "orgTrdNo": "",
      "orgTrdDt": ""
    },
    {
      "custNo": "2400001605",
      "mTrdNo": "ORDER20240715",
      "trdNo": "24071516270200002192",
      "trdDt": "20240715",
      "trdTm": "100000",
      "trdDivCd": "MP",
      "chrgMeanCd": "CA",
      "trdSumry": "충전",
      "trdAmt": "50000",
      "mnyAmt": "50000",
      "pntAmt": "0",
      "waitMnyAmt": "0",
      "chrgTrdNo": "",
      "orgTrdNo": "",
      "orgTrdDt": ""
    }
  ]
}

Failure

{
  "rsltCd": "A-009",
  "rsltMsg": "Yn parameter allows only Y or N."
}

Important Notes

  • By default, void transactions (Money top-up void, Points issuance void, Spend void) are not included in the transaction history. (Void amounts are visible on the original transaction entry.)
  • To include void transactions as separate entries, set showCnclYn to Y.
  • Note: if trdDivCd is specified in the request, the showCnclYn value is ignored.
💬

Need technical support?

무엇이든 물어보세요