계좌 예금주 실명 조회 API 연동 (에이픽API)
안녕하세요. 에이픽API 입니다.
에이픽 API 서비스 중 계좌 예금주(실명) 조회 기능을 소개해 드리겠습니다.
에이픽에서 서비스하는 계좌 예금주 조회 기능은 62개의 금융기관의 계좌에 대한 예금주(실명) 조회가 가능합니다.
지원되는 은행명 및 은행 코드는 아래와 같습니다.
|
은행코드
|
은행명
|
|
088
|
신한
|
|
035
|
제주
|
|
004
|
국민
|
|
003
|
기업
|
|
011
|
농협
|
|
002
|
산업
|
|
007
|
수협
|
|
048
|
신협
|
|
020
|
우리
|
|
081
|
하나
|
|
027
|
한국씨티
|
|
090
|
카카오뱅크
|
|
089
|
케이뱅크
|
|
092
|
토스뱅크
|
|
039
|
경남
|
|
034
|
광주
|
|
031
|
대구
|
|
032
|
부산
|
|
037
|
전북
|
|
045
|
새마을
|
|
071
|
우체국
|
|
050
|
저축은행
|
|
012
|
지역농.축협
|
|
055
|
도이치
|
|
063
|
중국
|
|
067
|
중국건설
|
|
062
|
중국공상
|
|
061
|
BNP파리바
|
|
060
|
BOA
|
|
054
|
HSBC
|
|
057
|
JP모간
|
|
023
|
SC
|
|
064
|
산림조합
|
|
278
|
신한투자증권
|
|
261
|
교보증권
|
|
227
|
다올투자증권
|
|
267
|
대신증권
|
|
287
|
메리츠증권
|
|
238
|
미래에셋증권
|
|
290
|
부국증권
|
|
240
|
삼성증권
|
|
221
|
상상인증권
|
|
291
|
신영증권
|
|
266
|
에스케이증권
|
|
209
|
유안타증권
|
|
280
|
유진투자증권
|
|
265
|
이베스트투자증권
|
|
288
|
카카오페이증권
|
|
292
|
케이프투자증권
|
|
264
|
키움증권
|
|
271
|
토스증권
|
|
294
|
한국포스증권
|
|
270
|
하나증권
|
|
262
|
하이투자증권
|
|
243
|
한국투자증권
|
|
269
|
한화투자증권
|
|
263
|
현대차증권
|
|
224
|
BNK투자증권
|
|
279
|
DB금융투자
|
|
225
|
IBK투자증권
|
|
218
|
KB증권
|
|
247
|
NH투자증권
|
로그인 페이지에서 "회원 가입하기" 버튼을 눌러줍니다.
이메일, 비밀번호, 이름, 전화번호를 입력한 후 약관에 동의하시고 "회원가입하기" 버튼을 눌러주세요.
다음 단계에서 입력한 이메일에 대한 인증을 수행해야되니 꼭 메일 수신이 가능한 이메일 주소를 사용해야 됩니다.
회원가입을 수행하면 다음과 같이 이메일 인증 페이지로 넘어갑니다.
다음과 같이 이메일이 수신됐습니다. "이메일 인증하기" 버튼을 눌러 인증을 수행해 주세요.
인증을 완료하면 1,000포인트를 가입 보너스로 제공해 줍니다.
에이픽 계좌 예금주 조회는 건당 40원으로 업계 최저가로 책정되어 있습니다. 보너스로 받은 포인트만 사용하여도 25건의 계좌 예금주 조회를 공짜로 사용할 수 있습니다.
다시 에이픽 홈페이지로 돌아와서 로그인을 수행해 줍니다.
상단 메뉴의 "마이페이지" -> "결제내역" 으로 가면 1,000 포인트를 받았음을 확인할 수 있습니다.
이제 API 연동을 위한 개발가이드를 확인해 보겠습니다.
상단 메뉴의 "개발가이드" -> "금융" -> "계좌 예금주 실명 조회" 메뉴를 클릭합니다.
계좌 예금주 조회 API 호출 가이드를 확인할 수 있습니다.
파라메터는 3개로 구성돼있습니다.
account_num : 예금주 명을 확인할 계좌번호
bank_code : 은행코드
bank_name : 은행명
은행코드와 은행명은 둘중 하나만 입력하면 됩니다.
은행코드와 은행명은 상단 표를 통해 확인 가능합니다.
위 양식에 따라 python을 사용하여 문자메시지를 발송해 보려 합니다.
제가 사용하는 파이썬 버전은 3.9버전이며 pip를 사용하여 requests 모듈을 먼저 설치해 줍니다.
pip install requests
API를 사용하기 위해서 인증키를 먼저 조회해야 합니다.
인증키는 "마이페이지" -> "API 정보" 메뉴로 이동하면 아래와 같이 확인할 수 있습니다.
인증키 정보는 API 서비스 이용시 내 계정을 인증하는 용도로 사용되므로 꼭 외부에 노출되지 않도록 주의하시기 바랍니다.
또한 보안성 강화를 위해 API를 호출할 "허용 IP 목록"을 미리 등록해 놓는것도 좋은 방법입니다.
제가 작성한 파이썬 코드는 다음과 같습니다.
import requests
url = "https://apick.app/rest/account_realname"
data = {"account_num": "47030xxxxxxxx", "bank_code": "004"}
headers = {"CL_AUTH_KEY": "222edb6defxxxxxxxxxxxxx"}
response = requests.post(url, data=data, headers=headers, verify=False)
print(response.text)
코드를 실행한 결과는 다음과 같습니다.
{
"data": {
"은행코드": "004",
"은행명": "국민",
"계좌번호": "47030xxxxxxxx",
"계좌실명": "김XX",
"success": 1
},
"api": {
"success": true,
"cost": 40,
"ms": 1222,
"pl_id": 10101471
}
}
정상적으로 호출됐습니다.
"계좌실명" 부분에 실제 계좌 예금주(소유주) 실명이 표시됩니다.
에이픽에서 서비스하는 계좌 1원인증 API 서비스와 함께 사용하면 고객 계좌의 예금주와 계좌 소유자가 일치하는지 확인할 수 있습니다.