굿센 뱅크북서비스 계좌의 등록상태를 조회합니다
1 요청URL
POST |
URL -
https://api.goodapi.co.kr/api/AccountRegStatus?type={xml or json}&sessionID=공개키
샘플
-
https://api.goodapi.co.kr/api/AccountRegStatus?type=xml&sessionID=test
- [application/x-www-form-urlencoded]
-
bankcode=003&acctno=(계좌번호)&currcd=KRW
- [application/xml]
-
<R><bankcode>003</bankcode><acctno>(계좌번호)</acctno><currcd>KRW</currcd></R>
- [application/json]
-
{"bankcode":"003","acctno":"(계좌번호)","currcd":"KRW"}
주의사항
- filename, type, eCode, sessionID, subFileName, wcfName 요청변수명은 사용이 불가하며,
- path01 ~ path20은 Path에서 사용하지 않을 경우 사용가능.
- 요청변수명 중복사용시 Query보다 Body가 우선함.
|
2 요청변수
구분 |
요청변수 |
변수명 |
유형 |
필수 |
샘플값 |
설명 |
Path |
fileName |
요청 업무 |
string |
true |
AccountRegStatus
|
AccountRegStatus
추가/변경 가능
|
Query |
type | 응답형식 | string | true | xml | xml or json |
eCode |
법인코드 |
string |
false |
Dataservice |
요청 처리하고자 하는 법인코드 |
sessionID |
공개키 |
string |
true |
test |
접근하려는 연계시스템 또는 사용자에 부여하는 Key값 |
subFileName |
요청 업무(구분) |
string |
false |
088 |
요청 업무 세부 구분 코드(예-은행코드) |
Body |
bankcode |
은행코드 |
string |
true |
003 |
금결원 표준은행코드를 입력 |
acctno |
계좌번호 |
string |
true |
|
|
currcd |
통화코드 |
string |
false |
KRW |
|
3 출력결과필드
출력변수 |
유형 |
샘플값 |
설명 |
R_CODE |
responseindex |
0000 |
처리결과코드 |
R_MSG |
responseindex |
정상 처리되었습니다 |
처리결과메세지 |
등록상태코드 |
responseindex |
2 |
[한글명필드 삭제예정. 동일 영문명필드사용권장] 등록상태코드(1:테스트/2:정상등록/3:등록오류) |
등록상태명 |
responseindex |
정상등록완료 |
[한글명필드 삭제예정. 동일 영문명필드사용권장] 등록상태명 |
등록요청일자 |
responseindex |
20200101 |
[한글명필드 삭제예정. 동일 영문명필드사용권장] 등록요청일자(YYYYMMDD) |
RegStatusCode |
responseindex |
2 |
등록상태코드(1:테스트/2:정상등록/3:등록오류) |
RegStatusMessage |
responseindex |
정상등록완료 |
등록상태명 |
RegDate |
responseindex |
20200101 |
등록요청일자(YYYYMMDD) |
4 추가응답코드
개발가이드 페이지의 기본응답코드외 해당 업무특성상 추가되는 응답코드
5 Test API
Header
|
Key |
Value |
비고 |
|
Content-Type
|
application/x-www-form-urlencoded
|
application/xml application/json
|
|
Authorization
|
|
토큰 인증용 헤더(Bearer + ' ' + 발급토큰)
|
|
client_id
|
|
접속회원ID
|
|
client_secret
|
|
접속비밀번호
|
|
session_id
|
|
Session ID
|
|
user-tr-no
|
|
요청자 거래고유번호(요청자 생성)
|
[POST]
https://api.goodapi.co.kr/api/AccountRegStatus?type=json&sessionID=test
Body
Response