헥토파이낸셜 개발자센터

Detailed Balance Inquiry API

Retrieves a member's Money and Points balance broken down by balance division code.

API Information

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

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, then Base64 encoding required.

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(200)Alphanumeric, up to 200 bytes*Success
Result message.

rsltObj (Response Object)

└custNoAN(20)Alphanumeric, up to 20 bytes*2400001605
Prepaid member number.
└custDivCdAN(1)Alphanumeric, up to 1 bytes*
Customer division code.
0: Anonymous 1: Named
└chrgblAmtN(7)Numeric, up to 7 bytes*500000
Available top-up amount.
*Maximum additional Money that can be topped up at the time of inquiry.
└mnyBlcN(7)Numeric, up to 7 bytes*1500000
Money balance.
└pntBlcN(7)Numeric, up to 7 bytes*1000
Points balance.
└waitMnyBlcN(7)Numeric, up to 7 bytes*0
Pending Money balance.
*Money in pending state generated due to a spend void.

data (Detailed Balance Object)

└PList[]*
Points detailed breakdown.
*List of Points details by balance division code.
└MList[]*
Money detailed breakdown.
*List of Money details by balance division code.

Request Example

{
  "custNo": "2400001605",
  "ci": "AES-encrypted CI value"
}

Response Examples

Success

{
  "rsltCd": "0000",
  "rsltMsg": "Success",
  "rsltObj": {
    "custNo": "2400001605",
    "custDivCd": "0",
    "chrgblAmt": "500000",
    "mnyBlc": "1500000",
    "pntBlc": "500",
    "waitMnyBlc": "0",
    "data": {
      "P": [
        {
          "blcDivCd": "CP", // Merchant-issued Points
          "blcAmt": "500",
          "expDt": "20340716"
        }
      ],
      "M": [
        {
          "blcDivCd": "CA", // Credit card
          "blcAmt": "100000",
          "expDt": "20340716"
        },
        {
          "blcDivCd": "EZ", // My account
          "blcAmt": "500000",
          "expDt": "20350716"
        }
      ]
    }
  }
}

Failure

{
  "rsltCd": "C-015",
  "rsltMsg": "CI value does not match."
}

Important Notes

  • Unlike the standard Balance Inquiry API, this API returns a breakdown by balance division code.
  • Each detail item includes the balance division code, amount, and expiry date.
💬

Need technical support?