헥토파이낸셜 개발자센터

Bank Maintenance Window Inquiry API

Checks whether each bank is under maintenance and the maintenance window for each operation type (payment, enrollment, termination, etc.).

API Information

POST/v1/api/bank/timecheck
Content-Typeapplication/json; charset=UTF-8
테스트https://tbnpay.settlebank.co.kr/v1/api/bank/timecheck
운영https://npay.settlebank.co.kr/v1/api/bank/timecheck

Request Parameters

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)Alphanumeric, up to 50 bytes*
Message information code.
*Fixed value
└pktDivCdAN(2)Alphanumeric, up to 2 bytes*
Operation type.
RE: Account enrollment DE: Account termination RP: Payment RT: Payment cancellation (refund) NA: Account holder inquiry (without date of birth) NN: Account holder inquiry (with date of birth) AA: Account ownership verification AR: Remittance
└mchtIdAN(8)Alphanumeric, up to 8 bytes*
Merchant ID.
└reqDtAN(8)Alphanumeric, up to 8 bytes*
Request date.
└reqTmAN(6)Alphanumeric, up to 6 bytes*
Request time.
└bankCdAN(3)Alphanumeric, up to 3 bytes*
Bank code.
└pktHashAN(200)Alphanumeric, up to 200 bytes*SHA-256(실시간 생성)
SHA-256 hash value.
NOTE

Signature composition

mchtId + reqDt + reqTm + bankCd + hashKey

Response Parameters

└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.
└bankCdAN(3)Alphanumeric, up to 3 bytes*004
Bank code.
💬

Need technical support?