2026년 4월 22일 수요일

계좌 예금주 실명 조회 API · 1원 인증 없이 실시간 예금주 검증 · 호출당 60P | APICK 에이픽

APICK · SERVICE BROCHURE · 금융·계좌 인증

계좌 예금주 실명 조회 API

은행코드와 계좌번호로 예금주 실명을 실시간 조회해 송금·결제 검증에 활용하는 실명 인증 REST API. 1원 인증 없이 단 한 번의 호출로 본인 확인을 완료합니다.

💳 호출당 60P ⚡ 실시간 응답 🔐 단일 인증키 📡 REST 표준
About APICK

APICK 은 어떤 서비스인가요?

APICK(에이픽) 은 금융·사업자·부동산·신분증·OCR·이미지·문서까지 80여 종의 비즈니스 API 를 REST 표준으로 제공하는 호출당 과금 플랫폼 입니다. 단일 인증키 CL_AUTH_KEY 하나로 모든 API 를 사용할 수 있고, 월 최소 비용 없이 호출한 만큼만 과금되는 투명한 요금 정책이 특징입니다.

  • ✅ 단일 인증키 · 80+ REST API 통합 사용 — 한 번 가입하면 추가 계약 없이 바로 확장
  • ✅ 호출당 포인트 과금 · 월 최소 비용 없음 — 트래픽 규모와 무관하게 부담 없이 시작
  • ✅ 실시간 응답 · 호출 메타 자동 제공 — api.cost · api.ms · api.pl_id 자동 기록

APICK 회원가입 · 지금 시작하기 →

왜 APICK 인가 · 3가지 핵심 강점

01

정찰제 · 투명 가격

모든 API 가격이 정찰제로 공개되어 누구나 동일한 조건으로 이용합니다.

02

가입 즉시 전체 사용

회원가입 후 포인트 충전만으로 80여 종 API 를 즉시 호출할 수 있습니다.

03

5분 연동 · 무심사

별도 인증·심사·계약 없이 가입 후 5분 안에 모든 API 를 연동합니다.

주요 서비스 분야

01

금융·계좌 인증

계좌 실명 조회 · 은행코드 · 1원 인증 · 거래영업일

02

사업자·기업

사업자 정보 · 벤처기업 · 휴폐업 · 세무 상태

03

부동산·등기

건축물대장 · 인터넷등기소 · 토지대장 · 공시지가

04

개인·신분증 인증

주민번호 진위 · 신분증 OCR·진위 · 개인통관부호

05

이미지·영상·음성

얼굴 감지·블러 · 워터마크 · STT · TTS · 음성 변환

06

웹·문서·주소·검색

구글·유튜브 · URL 스크린샷 · PDF·DOCX 변환 · 도로명

이런 고민, 있으신가요?

사용자가 입력한 계좌가 본인 명의인지 확인할 방법이 필요합니다. 오입금·부정 계좌 등록·정산 오류는 서비스 신뢰도와 CS 비용을 함께 갉아먹지만, 1원 인증은 UX 를 떨어뜨리고 금융망 비용까지 추가로 발생합니다.

계좌 예금주 실명 조회 API 하나로 위 문제를 한 번의 호출 로 해결할 수 있습니다.

  • 계좌번호 + 은행 정보만으로 예금주 실명을 실시간 반환
  • 별도 1원 인증 없이 한 번의 API 호출로 본인 확인 완료
  • 가맹점·파트너 정산 계좌를 자동 검증해 CS 비용 절감
  • KYC / AML 워크플로우에 단일 호출로 삽입 가능

한눈에 보는 연동 사양

엔드포인트
/rest/account_realname
REST · POST 요청
호출 단가
60P
후불제 정책 별도 · 호출당
응답 시간
api.ms
응답 본문 api.ms 값으로 확인

핵심 특장점 · 빠른 도입 포인트

연동 담당자가 가장 먼저 확인하면 좋은 6가지 포인트입니다.

01

최소 입력 · 즉시 응답

필수 파라미터만 전달하면 평균 10초 이내, 최대 35초 응답으로 실시간 검증이 가능합니다.

02

표준 인증 방식

CL_AUTH_KEY (MD5 인증키) 를 헤더로 전달. 별도 OAuth 흐름 없이 즉시 호출 가능합니다.

03

호출 메타 자동 제공

응답에 api.cost · api.ms · api.pl_id 가 함께 반환되어 과금·성능·결제 로그를 즉시 추적할 수 있습니다.

04

투명한 과금

선불제 호출당 과금 · 후불제 정책 별도. 응답 본문 api.cost 로 실제 차감 포인트를 확인합니다.

05

단순 REST 인터페이스

표준 POST 요청 + FormData 형식으로 어떤 언어·프레임워크에서도 즉시 통합 가능합니다.

06

실패 응답 처리

data.success 값으로 판단: 0 실패 · 1 성공 · 3 타임아웃. 실패 응답은 정책에 따라 과금되지 않을 수 있습니다.

도입 효과

호출 메타 자동 제공 · 표준 REST 인터페이스 · 실시간 응답으로 기존 서비스 흐름에 즉시 편입됩니다.

✅ 호출 메타 자동 제공

api.cost / api.ms / api.pl_id 로 호출당 과금·성능·결제 로그를 즉시 추적합니다.

✅ 표준 REST 인터페이스

단순 POST + FormData 구조로 어떤 언어·프레임워크에서도 즉시 통합됩니다.

✅ 실시간 응답

평균 10초 이내 응답으로 사용자 흐름 중간에 자연스럽게 호출할 수 있습니다.

연동 사양 요약

MethodPOST
Endpointhttps://apick.app/rest/account_realname
HeaderCL_AUTH_KEY(인증키(MD5))
FormData값: account_num, bank_code, bank_name
Responsedata · api 객체
api 객체success · cost · ms · pl_id
success 값0 실패 · 1 성공 · 3 타임아웃
응답시간api.ms 값으로 확인 · 네트워크 상황에 따라 변동
과금 단위60P / 호출당

응답 본문 핵심 영역

응답은 data 객체와 호출 메타를 담은 api 객체로 구성되며, 호출당 차감 포인트는 api.cost 로 즉시 확인할 수 있습니다.

응답

기본 응답 필드

  • 은행코드
  • 은행명
결과

주요 결과 항목

  • 계좌번호
  • 계좌실명
메타

api 메타 정보

  • success
  • cost
  • ms
  • pl_id
상태

성공·실패 코드

  • error · 오류메시지
  • success · 과금 여부 (0 실패 · 1 성공 · 3 타임아웃)

요청 파라미터

이름 타입 필수 설명
account_numString필수계좌번호
bank_codeString선택은행 코드 ([은행코드 조회] API에서 조회 가능)
bank_nameString선택은행명 ([은행코드 조회] API에서 조회된 이름으로 입력)

요청 예시 · cURL

공식 가이드 기준 파라미터를 FormData 로 전달, 인증키는 헤더로 전달합니다.

curl -k -X POST "https://apick.app/rest/account_realname" \
  -H "CL_AUTH_KEY: $API_KEY" \
  -F "account_num=sample" \
  -F "bank_code=sample" \
  -F "bank_name=sample"

응답 예시 · JSON 샘플

표준 응답 구조 샘플입니다. 실제 필드·값은 호출 대상에 따라 달라질 수 있으며, 정확한 스펙은 공식 개발가이드를 기준으로 확인하세요.

{
  "data": {
    "은행코드": "004",
    "은행명": "국민",
    "계좌번호": "00000123456789",
    "계좌실명": "홍길동",
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 60,
    "ms": 841,
    "pl_id": 224
  }
}

응답 필드

경로 타입 설명
dataObject조회 데이터
data.은행코드String은행코드
data.은행명String은행명
data.계좌번호String계좌번호
data.계좌실명String계좌실명
data.errorString오류메시지
data.successInteger과금 여부 (0: 실패, 1: 성공, 3: 실패(timeout))
apiObjectAPI 호출 공통 데이터
api.successBooleanAPI 서버 정상 응답 여부
api.costIntegerAPI 호출 요금
api.msIntegerAPI 응답 시간
api.pl_idIntegerAPI 결제 로그 ID

추천 활용 시나리오

01

거래 송금 검증

송금 전 예금주 실명·계좌 유효성을 확인해 오송금·사기 송금 위험을 줄입니다.

02

정산 자동화

지급·환불 처리 직전 계좌 정보를 자동 검증해 정산 오류를 사전에 차단합니다.

03

회원 본인 인증

회원가입·결제 단계에서 1원 인증·계좌 검증으로 본인 확인 절차를 완료합니다.

04

재무 데이터 정합성

주기적으로 보유 계좌 정보를 검증해 데이터 노후화·오류를 방지합니다.

도입 체크리스트

Checklist

연동 작업 전 확인이 필요한 항목

APICK 회원가입 후 인증키(CL_AUTH_KEY) 발급
선불제 포인트 충전 또는 후불제 약정
호출 IP 화이트리스트 설정 검토
응답 객체 파싱 및 빈 값 처리 정책 수립
타임아웃(35초) 대응 로직 구현
api.cost 기반 과금 모니터링 구성

📄 계좌 예금주 실명 조회 API 가이드 PDF 다운로드

지금 바로 APICK 에 연동해보세요

회원가입 즉시 CL_AUTH_KEY 발급.
계좌 예금주 실명 조회 API 는 호출당 60P, 월 최소 비용 없이 호출한 만큼만 과금됩니다.

APICK 회원가입 · 지금 시작하기 → 공식 개발 가이드 보기

* 본 문서는 APICK 공식 스펙을 바탕으로 정리한 연동 참고 자료입니다. 최신·정확한 스펙은 공식 개발 가이드 를 기준으로 확인하세요.

#APICK #에이픽 #비즈니스API #호출당과금API #실명조회API #예금주조회API #계좌실명조회 #1원인증대체 #송금전본인확인 #오송금방지 #간편정산자동화 #KYC자동화 #핀테크솔루션 #RESTAPI연동 #월최소비용없는API

댓글 없음:

댓글 쓰기