헥토파이낸셜 개발자센터

Withdrawal Limit Inquiry API

Queries the direct debit withdrawal limit for an Open Banking participating institution.

API Information

POST/v2/api/pay/wdLimit
Content-Typeapplication/json
테스트https://tbnpay.settlebank.co.kr/v2/api/pay/wdLimit
운영https://npay.settlebank.co.kr/v2/api/pay/wdLimit

Request Parameters

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)Alphanumeric, up to 50 bytes*
Message information code.
*Fixed value
└mchtIdAN(8)Alphanumeric, up to 8 bytes*
Unique Merchant ID assigned by Hecto Financial.
└reqDtAN(8)Alphanumeric, up to 8 bytes*
Request date (YYYYMMDD).
└reqTmAN(6)Alphanumeric, up to 6 bytes*
Request time (HH24MISS).
└pktHashAN(200)Alphanumeric, up to 200 bytes*SHA-256(실시간 생성)
SHA-256 hash value.
NOTE

Signature composition

Merchant ID + request date + request time + auth key

Response Parameters

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└outStatCdAN(4)Alphanumeric, up to 4 bytes*0021
Transaction status code.
0021: Success 0031: Failure
└outRsltCdAN(4)Alphanumeric, up to 4 bytes*0000
Decline code.
└outRsltMsgAN(300)Alphanumeric, up to 300 bytes*Processed successfully.
Result message.
└percWdLmtAmtAN(18)Alphanumeric, up to 18 bytes*AES-256AES-256/ECB/PKCS5Padding10000
Per-transaction withdrawal limit amount.
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
└dayWdLmtAmtAN(18)Alphanumeric, up to 18 bytes*AES-256AES-256/ECB/PKCS5Padding10000
Daily withdrawal limit amount.
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
└todayAcmWdAmtAN(18)Alphanumeric, up to 18 bytes*AES-256AES-256/ECB/PKCS5Padding10000
Today's cumulative withdrawal amount.
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
💬

Need technical support?