본문으로 건너뛰기

예금주 성명 조회 연동하기

계좌번호·은행코드로 예금주명을 조회합니다.

1. Flow​

2. 설명 (Description)​

  • 가상계좌 환불 전·지급대행 서브몰 등록 등 계좌의 예금주명 검증에 활용합니다.
  • 23:30~00:30 은행 점검 시간대 요청 시 실패할 수 있습니다.
  • 서비스 이용은 영업담당자 협의 후 가능합니다.

3. 요청 (Request)​

3.1. HTTP Request​

  • Method: POST
  • URL: https://webapi.nicepay.co.kr/webapi/inquery/check_bank_account.jsp
  • Content-Type: application/x-www-form-urlencoded
  • Encoding: EUC-KR

3.2. 요청 파라미터​

필드명크기필수설명
MID10O가맹점 ID
BankCode3O은행코드
AccountNo20O계좌번호
EdiDate14O요청 전문 생성 일시(YYYYMMDDHHMISS)
SignData256O위변조 검증 데이터, 생성규칙: hex(sha256(MID + EdiDate + AccountNo + MerchantKey))
CharSet10인증 응답 인코딩 (euc-kr(default) / utf-8)
EdiType10응답전문 유형 (JSON(default) / KV) *KV:Key=value

4. 응답 (Response)​

PG사의 기능 추가 및 서비스 개선에 따라 응답 필드는 사전 고지 없이 추가될 수 있습니다.
가맹점에서는 아래 표에 기재되지 않은 응답 필드가 추가될 수 있음을 고려하여 연동해야 하며, 추가 필드로 인해 파싱 오류 또는 결과 처리 오류가 발생하지 않도록 구현해야 합니다.

필드명크기설명
ResultCode4결과코드 (0000: 성공, 그 외 실패)
ResultMsg100결과 메세지
AccountName20예금주 성명 (성공 시 응답)

5. 예시​

POST /webapi/inquery/check_bank_account.jsp HTTP/1.1
Host: webapi.nicepay.co.kr
Content-Type: application/x-www-form-urlencoded

MID=nictest00m&EdiDate=20260813112307&SignData=d2c5f1de5af9f89a02d21e5c4047859dea08ebcfe5fc894d419406566b9bc66e&AccountNo=123456789012&BankCode=004&CharSet=euc-kr
{
  "ResultCode": "0000",
  "ResultMsg": "정상",
  "AccountName": "홍길동"
}