Konaplate logo

API 문서

전체 API

서비스


계좌 예금주 실명 검증동기

버전: v1


버전: v1

POST

/api/v1/bankaccounts/user/valid

회원의 이름과 입력 계좌 예금주명의 동일 여부를 확인 합니다. * 계좌 등록 회원이 카드에 잔액을 충전하기 위해서는 출금 계좌를 등록해야 합니다. 이를 위해서 다음의 2단계를 진행하게 됩니다. 1. 계좌 예금주 실명 검증 2. ARS 인증 계좌가 등록되며 계좌를 통해 선불 카드를 충전할 수 있습니다.

요청 헤더


X-KM-User-AspId

string

필수

길이 : 15

ASP ID

  • 서비스 사업자에게 부여한 ID입니다.
  • ID는 계약 시 제공됩니다.

X-KM-Correlation-Id

string

필수

길이 : 20

전문 추적을 위한 거래번호

  • 형식 : yyMMddHHmiSS-xxxxxxx
  • xxxxxxx : 7자리, Hex String

X-KM-Access-Key

string

조건부

길이 : 40

프로젝트에서 생성된 Access Key

  • Callback API 인 경우는 제외합니다.

X-KM-Crypto-Key-Id

string

옵션

길이 : 32

데이터암복호화 키 ID

  • 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
  • 데이터 암호화 요청 시 필수 입력값입니다. (Data Encryption = Y)

X-KM-Tran-Token

string

필수

길이 : 66

공통 Header 정보 - X-KM-Tran-Token

X-KM-Tran-Time

string

필수

길이 : 14

클라이언트 요청 시간

  • 형식 : YYYYMMDDHHMMSS

X-KM-Time-Zone

string

필수

길이 : 3

시간대 정보 (UTC, KST, ...)

요청 파라미터

암호화 처리|
더 자세한 정보는
가이드라인
을 참조하세요.

bankAccount

string

필수

최소 : 1 , 최대 : 20

은행 계좌번호

bankCode

string

필수

길이 : 3

은행코드

Bank name Code   Bank name Code
신한은행 088   KB국민은행 004
우리은행 020   하나은행 081
IBK기업은행 003   산업은행 002
NH농협은행 011   지역농축협 012
SC은행 023   카카오뱅크 090
우체국 071   새마을금고 045
수협은행 007   신협 048
부산은행 032   경남은행 039
광주은행 034   전북은행 037
제주은행 035   대구은행 031
산림조합 064   케이뱅크 089
저축은행 050   토스뱅크 092
씨티은행 027   삼성증권 240
한화투자 269   신한투자 278
교보증권 261      



 

birthDate

string

필수

길이 : 6

회원 생년월일

- 형식 : yyyyMMdd

userId

number

필수

최소 : 1 , 최대 : 9999999999999999999

회원 ID

- 회원가입 시 부여되는 회원의 고유 ID입니다.

userName

string

필수

최소 : 1 , 최대 : 100

회원 이름

응답 헤더


X-KM-Correlation-Id

string

필수

길이 : 20

전문 추적을 위한 거래번호

  • 형식 : yyMMddHHmiSS-xxxxxxx
  • xxxxxxx : 7자리, Hex String

X-KM-Crypto-Key-Id

string

옵션

길이 : 32

데이터암복호화 키 ID

  • 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
  • Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.

응답 코드

Detailed classification and addition of error for unseccessful withfrawal


200

에러 코드

000_000

메시지

Success

설명

성공


400

에러 코드

002_001

메시지

Bank account is length over limit or including not-number digit.

설명

계좌의 길이가 잘못되었거나 숫자가 아닌 값을 포함하고 있습니다.


400

에러 코드

002_002

메시지

No response name check api.

설명

PG사와 통신 오류가 발생하여 계좌의 예금주 실명 조회 실패 했습니다.


400

에러 코드

002_003

메시지

Names are not matched.

설명

계좌의 예금주 실명과 회원의 실명이 다릅니다.


400

에러 코드

002_004

메시지

Bank is not valid to check account info.

설명

은행 업무 개시 전으로 계좌 정보 수신 불가능 합니다.


400

에러 코드

002_005

메시지

User info not found.

설명

입력한 회원 정보(생년월일)로 은행 계좌 정보를 찾을 수 없습니다.


400

에러 코드

002_006

메시지

Bank is not valid.

설명

은행의 서비스 가능 시간이 아님에 따라(시스템 점검/야간 지연 등) 계좌 정보 확인 불가능 합니다.


400

에러 코드

002_007

메시지

Bank account is not found.

설명

입력한 계좌 번호로 은행 계좌를 찾을 수 없습니다.


400

에러 코드

002_008

메시지

Bank account's status is not valid.

설명

거래 불가 상태의 계좌입니다.


400

에러 코드

002_009

메시지

Bank account is not valid for holder's name check.

설명

입력한 계좌는 실명 확인 용도로 사용할 수 없습니다.

전체 보기

테스트 데이터

200 - 성공 테스트


200 - 성공 테스트
400 - 계좌의 길이가 잘못되었거나 숫자가 아닌 값을 포함하고 있습니다.
400 - PG사와 통신 오류가 발생하여 계좌의 예금주 실명 조회 실패 했습니다.
400 - 계좌의 예금주 실명과 회원의 실명이 다릅니다.
400 - 은행 업무 개시 전으로 계좌 정보 수신 불가능 합니다.
400 - 입력한 회원 정보(생년월일)로 은행 계좌 정보를 찾을 수 없습니다.
400 - 은행의 서비스 가능 시간이 아님에 따라(시스템 점검/야간 지연 등) 계좌 정보 확인 불가능 합니다.
400 - 입력한 계좌 번호로 은행 계좌를 찾을 수 없습니다.
400 - 거래 불가 상태의 계좌입니다.
400 - 입력한 계좌는 실명 확인 용도로 사용할 수 없습니다.
400 - 은행 업무 개시 전으로 계좌 정보 수신 불가능 합니다.
400 - 시스템 처리 지연으로 인한 오류입니다.
400 - 미참가 기관일 경우 발생합니다.
Loading ...

Request

Loading...

Response

Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.


회원 가입회원 정보 조회회원 비밀번호 재설정 및 변경회원 정보 변경회원 탈퇴회원 로그인 ID 확인휴면 회원 해제약관 목록 조회약관 동의 및 철회CI 값으로 회원 정보 조회회원 로그인 ID 중복 확인회원 비밀번호 검증회원 인증 정보 조회금융사 목록 조회계좌 예금주 실명 검증ARS 인증 전 인증코드 생성PG를 통한 은행 계좌 등록계좌 등록 상태 조회기명화 및 한도상향(개인)회원 등록 계좌 조회회원 계좌 정보 조회자동충전 계좌 등록회원 계좌 삭제일회용 토큰 발급계좌 충전계좌 충전취소충전 및 충전취소 결과 확인거래내역 확인선불카드 발급 및 배송 신청카드 신청 취소선불카드 재발급(교체발급)만료 예정 선불카드 재발급 갱신카드 배송 상태 조회실물카드와 연결 가능한 모바일카드 신청 정보 조회실물카드 등록보유카드 조회미등록 카드 조회카드 상태 변경카드 폐기기명화 및 한도상향(개인)기명화 및 한도상향(법인)법인 기명화 여부 조회소득공제 신청카드 소득공제 신청 여부 조회카드 매핑 회원 조회카드 상품ID로 상품 정보 조회주카드 설정카드에 연결된 가상계좌 조회회원 가입회원 정보 조회회원 비밀번호 재설정 및 변경회원 정보 변경회원 탈퇴회원 로그인 ID 확인휴면 회원 해제약관 목록 조회약관 동의 및 철회CI 값으로 회원 정보 조회회원 로그인 ID 중복 확인회원 비밀번호 검증회원 인증 정보 조회금융사 목록 조회계좌 예금주 실명 검증ARS 인증 전 인증코드 생성PG를 통한 은행 계좌 등록계좌 등록 상태 조회기명화 및 한도상향(개인)회원 등록 계좌 조회회원 계좌 정보 조회자동충전 계좌 등록회원 계좌 삭제