개발가이드

  • 개발가이드

계좌 예금주 실명 조회

해당 계좌의 예금주 실명을 확인합니다.

정보

Method
URL
POST
https://apick.app/rest/account_realname

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
account_num
String
O
계좌번호
bank_code
String
X
은행 코드
[은행코드 조회] API에서 조회 가능
bank_name
String
X
은행명
[은행코드 조회] API에서 조회된 이름으로 입력
은행 코드 또는 은행명 중 하나는 필수로 입력해야 됩니다. 조회하고자 하는 계좌의 은행이 점검시간일 경우 조회가 불가능합니다.

응답

Body
이름
타입
설명
data
Object
조회 데이터
은행코드
String
은행코드
은행명
String
은행명
계좌번호
String
계좌번호
계좌실명
String
계좌실명
error
String
오류메시지
success
Integer
과금 여부
0: 실패
1: 성공
3: 실패(timeout)
api
Object
API 호출 공통 데이터
success
Boolean
API 서버 정상 응답 여부
cost
Integer
API 호출 요금
ms
Integer
API 응답 시간
pl_id
Integer
API 결제 로그 ID

예시

요청 예시

curl -k -X POST "https://apick.app/rest/account_realname" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "account_num=00000123456789" \
-F "bank_name=국민"
응답 예시

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