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

Code	Description
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

Request 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.

└periodAN(6)Alphanumeric, up to 6 bytesInquiry year-month.

Inquiry year-month.

*YYYYMM format. Defaults to the current month.

└pageN(3)Numeric, up to 3 bytesPage number.

Page number.

*Defaults to 1.

└sizeN(3)Numeric, up to 3 bytesItems per page.

Items per page.

*Defaults to 10.

└trdDivCdAN(128)Alphanumeric, up to 128 bytesTransaction 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

*Separate multiple transaction codes with a comma. Example: MG,MR,UC,PP

└trdNoAN(50)Alphanumeric, up to 50 bytesTransaction approval number.

Transaction approval number.

*Unique transaction number assigned by Hecto Financial.

└mTrdNoAN(50)Alphanumeric, up to 50 bytesMerchant transaction reference number.

Merchant transaction reference number.

*Transaction reference number generated by the merchant (no Korean characters).

└showCnclYnAN(1)Alphanumeric, up to 1 bytesInclude void transactions flag.

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 bytesBalance division code.

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 bytesCard transaction only flag.

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*Result code.0000

Result code.

0000: Success Other: Failure

└rsltMsgAN(255)Alphanumeric, up to 255 bytes*Result message.Success

Result message.

rsltObj (Response Object - LIST type)

└custNoAN(20)Alphanumeric, up to 20 bytes*Prepaid member number.2400001605

Prepaid member number.

└mTrdNoAN(50)Alphanumeric, up to 50 bytes*Merchant transaction reference number.ORDER20240716

Merchant transaction reference number.

*No Korean characters.

└trdNoAN(50)Alphanumeric, up to 50 bytes*Transaction approval number.24071616270200002193

Transaction approval number.

*Unique transaction number assigned by Hecto Financial.

└trdDtAN(8)Alphanumeric, up to 8 bytes*Transaction date.20240716

Transaction date.

*yyyyMMdd format.

└trdTmAN(6)Alphanumeric, up to 6 bytes*Transaction time.164101

Transaction time.

*HHmmss format.

└trdDivCdAN(2)Alphanumeric, up to 2 bytes*Transaction code.

Transaction code.

└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 bytes*Top-up method code.RA

Top-up method code.

*Applicable only to MP (Money top-up) and PP (Points issuance).

└trdSumryAN(100)Alphanumeric, up to 100 bytesTransaction summary.987

Transaction summary.

*Issuance reason, issuance void reason, or withdrawal bank account number (last 3 digits).

└trdAmtN(7)Numeric, up to 7 bytes*Transaction amount.2000

Transaction amount.

└mnyAmtN(7)Numeric, up to 7 bytes*Money amount.1000

Money amount.

└pntAmtN(7)Numeric, up to 7 bytes*Points amount.1000

Points amount.

└waitMnyAmtN(7)Numeric, up to 7 bytes*Pending Money amount.0

Pending Money amount.

└cnclTrdAmtN(7)Numeric, up to 7 bytesVoid amount.1000

Void amount.

*For CU/MP/PP transaction codes, the void amount for the original transaction.

└cnclMnyAmtN(7)Numeric, up to 7 bytesVoid Money amount.1000

Void 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.0

Void 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.20240718190801

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 bytesSettlement merchant ID.

Settlement merchant ID.

*Merchant ID for settlement target.

└storCdAN(20)Alphanumeric, up to 20 bytesStore code.HF000001

Store code.

└storNmAN(128)Alphanumeric, up to 128 bytesStore name.Hecto Financial

Store name.

└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",
  "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"
    },
    {
      "custNo": "2400001605",
      "mTrdNo": "ORDER20240715",
      "trdNo": "24071516270200002192",
      "trdDt": "20240715",
      "trdTm": "100000",
      "trdDivCd": "MP",
      "chrgMeanCd": "CA",
      "trdSumry": "충전",
      "trdAmt": "50000",
      "mnyAmt": "50000",
      "pntAmt": "0",
      "waitMnyAmt": "0"
    }
  ]
}

Failure

{
  "rsltCd": "1001",
  "rsltMsg": "Member information does not exist."
}

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?

Code Samples

HectoFinancial GitHub