헥토파이낸셜 개발자센터

Withdrawable Balance Inquiry API

Retrieves the withdrawable Money amount and the number of withdrawals made in the current month.

API Information

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

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*Success
Result message.

rsltObj (Response Object)

└custNoAN(20)Alphanumeric, up to 20 bytes*2400001605
Prepaid member number.
└wdMnyAmtAN(7)Alphanumeric, up to 7 bytes*500000
Withdrawable Money amount.
*Excludes pending Money balance.
└mwCountN(3)Numeric, up to 3 bytes*2
Number of withdrawals in the current month.

Request Example

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

Response Examples

Success

{
  "rsltCd": "0000",
  "rsltMsg": "Success",
  "rsltObj": {
    "custNo": "2400001605",
    "wdMnyAmt": "500000",
    "mwCount": "2"
  }
}

Failure

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

Important Notes

  • The withdrawable amount reflects the regular Money balance, excluding pending Money.
  • Check mwCount as monthly withdrawal limits may apply.
💬

Need technical support?