OpenAPI

HOME > OpenAPI > 계좌등록

계좌등록[POST 방식]

굿센 뱅크북서비스에 계좌를 등록합니다


1 요청URL
POST
    URL
  • https://api.goodapi.co.kr/api/RegisterAccount?sessionID=공개키
    • 샘플
  • https://api.goodapi.co.kr/api/RegisterAccount?sessionID=test
  • [application/x-www-form-urlencoded]
  • regdiv=1&bankcode=003&acctno=(계좌번호)&currcd=KRW&identityno=1178171379&acctpw=(계좌비밀번호)&accessid=(로그인ID)&accesspw=(로그인PW)&flaginout=(거래내역조회구분)&flagbalance=(잔액조회구분)&flagb2b=(수탁어음조회구분)&storepw=(비밀번호보관유무)&startdate=20200101
  • [application/xml]
  • <R> <regdiv>1</regdiv> <bankcode>003</bankcode> <acctno>(계좌번호)</acctno> <currcd>KRW</currcd> <identityno>1178171379</identityno> <acctpw>(계좌비밀번호)</acctpw> <accessid>(로그인ID)</accessid> <accesspw>(로그인PW)</accesspw> <flaginout>(거래내역조회구분)</flaginout> <flagbalance>(잔액조회구분)</flagbalance> <flagb2b>(수탁어음조회구분)</flagb2b> <storepw>(비밀번호보관유무)</storepw> <startdate>20200101</startdate> </R>
  • [application/json]
  • { "regdiv": "1", "bankcode": "003", "acctno": "(계좌번호)", "currcd": "KRW", "identityno": "1178171379", "acctpw": "(계좌비밀번호)", "accessid": "(로그인ID)", "accesspw": "(로그인PW)", "flaginout": "(거래내역조회구분)", "flagbalance": "(잔액조회구분)", "flagb2b": "(수탁어음조회구분)", "storepw": "(비밀번호보관유무)", "startdate": null }

    • 주의사항
  • filename, type, eCode, serviceKey, subFileName, wcfName 요청변수명은 사용이 불가하며,
  • path01 ~ path20은 Path에서 사용하지 않을 경우 사용가능.
  • 요청변수명 중복사용시 Query보다 Body가 우선함.

2 요청변수
구분 Parameter경로 변수명 유형 필수 변환 샘플값 설명
Path fileName 요청 업무 string true RegisterAccount
 RegisterAccount
추가/변경 가능
Query String returnType응답형식stringfalsexmlxml or json
HTTP Header의 Accept 사용 권장
eCode 법인코드 string false Dataservice 요청 처리하고자 하는 법인코드
sessionID 공개키 string true test 접근하려는 연계시스템 또는 사용자에 부여하는 Key값
subFileName 요청 업무(구분) string false 088 요청 업무 세부 구분 코드(예-은행코드)
Request Body
regdiv 등록구분 string false 1 1: 등록(DEFAULT) / 2: 변경 / 3: 해지
bankcode 은행코드 string true 003 금결원 표준은행코드를 입력
acctno 계좌번호 string true
currcd 통화코드 string false KRW
identityno 예금주정보 string true 1178171379 사업자번호 혹은 생년월일(YYYYMMDD)를 입력
acctpw 계좌비밀번호 string true
accessid 로그인ID string false
accesspw 로그인PW string false
flaginout 거래내역조회구분 string false N: 미사용 / B: 배치스케줄링 / R: 실시간조회
flagbalance 잔액조회구분 string false N: 미사용 / B: 전일잔액배치조회 / R: 실시간조회
flagb2b 수탁어음조회구분 string false N: 미사용 (서비스 제공예정)
storepw 비밀번호보관유무 string false N: 시스템 보관하지 않고 실시간요청 / Y: 시스템 보관하여 배치Job 실행
startdate 조회시작일자 date false 20200101 현재일로부터 1달 이내의 일자를 설정

3 출력결과필드
출력변수(Path) 유형 변환 샘플값 설명
R_CODE responseindex 0000 처리결과코드
R_MSG responseindex 정상 처리되었습니다 처리결과메세지

4 추가응답코드
  • 개발가이드 페이지의 기본응답코드외 해당 업무특성상 추가되는 응답코드
    • 응답코드 응답메세지 조치 방안

    5 Test API
    Header
    Key Value 비고
    Content-Type application/x-www-form-urlencoded application/xml
    application/json
    Accept application/xml
    application/json
    Authorization 토큰 인증용 헤더(Bearer + ' ' + 발급토큰)
    client_id 접속회원ID
    client_secret 접속비밀번호
    serviec_key 서비스Key
    user-tr-no 요청자 거래고유번호(요청자 생성)


  • [POST] https://api.goodapi.co.kr/api/RegisterAccount

    • Body
    Key Value 비고
    regdiv 1: 등록(DEFAULT) / 2: 변경 / 3: 해지
    bankcode 금결원 표준은행코드를 입력
    acctno 계좌번호
    currcd 통화코드
    identityno 사업자번호 혹은 생년월일(YYYYMMDD)를 입력
    acctpw 계좌비밀번호
    accessid 로그인ID
    accesspw 로그인PW
    flaginout N: 미사용 / B: 배치스케줄링 / R: 실시간조회
    flagbalance N: 미사용 / B: 전일잔액배치조회 / R: 실시간조회
    flagb2b N: 미사용 (서비스 제공예정)
    storepw N: 시스템 보관하지 않고 실시간요청 / Y: 시스템 보관하여 배치Job 실행
    startdate 현재일로부터 1달 이내의 일자를 설정


    Response