API 문서

전체 API

서비스


PG를 통한 은행 계좌 등록비동기

버전: v1


버전: v1

POST

/api/v1/bankaccounts/ars/register

PG를 통해 회원의 계좌를 등록 처리합니다. 계좌를 등록하거나 이미 등록된 계좌를 신규 계좌로 변경을 처리 합니다. ARS 인증 회원이 ARS 의 안내에 따라 모바일 화면에 나타난 인증 코드를 정확히 입력하는지 검증한다. ARS 인증의 음성 파일은 녹취되며, 출금이체 동의 자료로 사용된다 계좌 등록 회원이 카드에 잔액을 충전하기 위해서는 출금 계좌를 등록해야 합니다. 이를 위해서 다음의 2단계를 진행하게 됩니다. 1. 계좌 예금주 실명 검증 2. ARS 인증 계좌가 등록되며 계좌를 통해 선불 카드를 충전할 수 있습니다. PG는 ARS 인증코드를 회원으로부터 입력 받아 인증코드를 검증(ARS 인증) 후, 응답코드를 코어시스템에 전달하고, 계좌 등록 정보를 PG에 요청합니다. ARS 인증이 유효할 경우 응답("000") 후, 회원의 휴대 전화번호로 ARS 인증 전화 호출 및 출금이체 계좌 등록을 진행합니다.(비동기)

응답 헤더


X-KM-Correlation-Id

string

필수

길이 : 20

전문 추적을 위한 거래번호

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

X-KM-Crypto-Key-Id

string

옵션

길이 : 32

데이터암복호화 키 ID

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

응답 파라미터


bankAccRegNo

string

필수

최소 : 1 , 최대 : 22

계좌 등록 처리번호

ARS 전화 인증 후, 계좌 등록 여부를 확인하기 위한 입력 값으로 사용됩니다.

응답 코드

Detailed classification and addition of error for unseccessful withfrawal


200

에러 코드

000_000

메시지

Success.

설명

회원의 ARS 인증 후, 은행 계좌 등록이 정상 처리되었습니다.


400

에러 코드

002_013

메시지

Ars auth and bank account register is still in progress.

설명

등록 과정이 진행 중입니다. ARS 인증 및 계좌 등록 과정이 진행 중인 상태에서 같은 회원 ID로 중복 요청할 경우 발생됩니다. ARS 인증 후, 동일 회원의 계좌 등록 과정은 동시에 2개 이상 진행될 수 없습니다.

테스트 데이터

200 - 성공 테스트


200 - 성공 테스트
200 - 성공 테스트 - OPTIONAL parameter 없이 요청
400 - 동일 회원 ID로 등록 과정이 진행 중입니다.
Loading ...

Request

Loading...

Response

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


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