Account Ownership Verification Bank Maintenance Inquiry API

Checks whether a bank is under maintenance for account ownership verification operations.


API Information

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

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*
Processing type.
*Fixed value (AA: Account ownership verification)
mchtIdAN(8)Alphanumeric, up to 8 bytes*
Merchant ID.
reqDtAN(8)Alphanumeric, up to 8 bytes*
Request date (yyyyMMdd).
reqTmAN(6)Alphanumeric, up to 6 bytes*
Request time (HH24MISS).
bankCdAN(3)Alphanumeric, up to 3 bytes*
Bank code (3 digits).
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*Success
Result message.
bankCdAN(3)Alphanumeric, up to 3 bytes*004
Bank code.
bankChkYnAN(1)Alphanumeric, up to 1 bytes*N
Bank maintenance status.
Y: Under maintenance N: Normal
stDtmAN(14)Alphanumeric, up to 14 bytes20210830000000
Maintenance start date and time (yyyyMMddhhmmss).
edDtmAN(14)Alphanumeric, up to 14 bytes20210830001000
Maintenance end date and time (yyyyMMddhhmmss).
💬

Need technical support?