API 문서
전체 API
서비스
계좌 등록 상태 조회동기
버전: v1
버전: v1
/api/v1/bankaccounts/ars/register/inquiry
요청 헤더
요청 파라미터
응답 헤더
X-KM-Correlation-Id
string
필수
길이 : 20
전문 추적을 위한 거래번호
- 형식 : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7자리, Hex String
X-KM-Crypto-Key-Id
string
옵션
길이 : 32
데이터암복호화 키 ID
- 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
- Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.
응답 파라미터
status
string
필수
최소 : 1 , 최대 : 20
계좌 등록 처리 상태
- ARS_AUTH_IN_PROGRESS : (진행중) ARS 인증이 진행 중인 상태
- ARS_AUTH_DONE : (진행중) ARS 인증 성공하여, 계좌를 출금 이체 등록 진행 중인 상태
- ARS_AUTH_FAILED : (실패) ARS 인증 실패하여 계좌 등록 실패 상태
- BANK_ACC_REG_FAILED : (실패) ARS 인증은 성공하였으나, 계좌를 출금 이체 실패 상태
- BANK_ACC_REGISTERED : (성공) ARS 인증이 성공하여, 계좌를 출금 이체 등록 완료 상태
응답 코드
Detailed classification and addition of error for unseccessful withfrawal
200
에러 코드
000_000
메시지
Success.
설명
등록 진행중이거나 정상 등록 처리 되었습니다.
400
에러 코드
002_019
메시지
Not found ars bank account register error.
설명
계좌 등록 처리번호가 존재 하지 않습니다.
400
에러 코드
002_014
메시지
Bank account register failed due to ARS auth failed.
설명
ARS 인증 실패로 인한 은행 계좌 등록 실패 입니다
400
에러 코드
002_015
메시지
Bank account register failed due to lifetime account.
설명
평생 계좌 입니다.
400
에러 코드
002_016
메시지
Invalid account.
설명
거래 제한 계좌 입니다.
400
에러 코드
002_017
메시지
Bank account owner's social no is not correct.
설명
계좌의 소유자 주민번호 정확하지 않습니다
400
에러 코드
002_018
메시지
Communication with PG error.
설명
PG 통신 에러 입니다.
400
에러 코드
002_043
메시지
Bank account problem.
설명
은행 계좌에 문제가 있음. 은행에 문의.
테스트 데이터
Request
Response
Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.