계좌점유인증

계좌점유인증 업무

METHOD

POST

URI

/scrap/common/settlebank/accountOccupation

Request fields

필드명(영문) 필드명(한글) 암호화여부 양식 설명

OID

거래ID

CUSTID

고객ID

ACCTNO

계좌번호

BANKCODE

은행코드

002: 산업은행, 003: 기업은행, 004: 국민은행, 007: 수협은행/수협중앙회, 011: 농협은행, 012: 농협중앙회, 020: 우리은행, 023: SC제일은행, 027: 한국씨티은행, 031: 대구은행, 032: 부산은행, 034: 광주은행, 035: 제주은행, 037: 전북은행, 039: 경남은행, 045: 새마을금고중앙회, 048: 신협중앙회, 050: 상호저축은행, 054: HSBC은행, 055: 도이치은행, 057: 제이피모간체이스은행, 060: BOA은행, 062: 중국공상은행, 064: 산림조합중앙회, 071: 우체국, 081: KEB하나은행, 088: 신한은행, 089: K뱅크, 090: 카카오뱅크, 209: 유안타증권, 218: KB증권, 238: 미래에셋대우, 240: 삼성증권, 243: 한국투자증권, 247: NH투자증권, 261: 교보증권, 262: 하이투자증권, 263: 현대차투자증권, 264: 키움증권, 265: 이베스트투자증권, 266: SK증권, 267: 대신증권, 269: 한화투자증권, 270: 하나금융투자, 278: 신한금융투자, 279: 동부증권, 280: 유진투자증권, 287: 메리츠종합금융증권, 290: 부국증권, 291: 신영증권, 292: 케이프투자증권, 103: SBI저축은행

3자리 은행코드

AUTHTEXT

인증값

계좌적요에 기입되는 값

Response fields

필드명(영문) 필드명(한글) 암호화여부 양식 설명

data.MCHTTRDNO

상점 주문번호

data.OUTRSLTCD

거절코드

data.OUTRSLTMSG

결과메시지

data.OUTSTATCD

결과코드

0021: 성공, ST01: 존재하지 않는 계좌, ST03: 이중출금 발생, ST05: VAN 응답정보 없음, ST07: 통신장애, ST09: 유효하지 않는 요청전문, ST11: 은행점검 시간, ST13: ARS 인증 결과가 없음, ST15: 자동이체해지계좌, ST17: 주민번호 사업자번호 오류, ST19: 기타거래불가, ST21: 수취인 계좌 없음, ST23: 비실명 계좌, ST25: 이미 취소된 거래, ST27: ARS인증 실패, ST29: 계좌 등록 진행중, ST31: 이중송금 발생, ST33: 1회 한도초과, ST35: 사고계좌 입니다., ST37: 간편결제 취소, ST39: 환불중복 요청, ST41: 서비스용량초과, ST43: 이미 등록된 계좌입니다, ST50: 중복전문요청, ST52: 미등록 현금영수증 사용자, ST60: 거래실패, ST62: 일한도 금액초과, ST64: 일한도 건수초과, ST66: 비밀번호 등록 실패, ST68: 서비스 이용정지, ST02: 유효하지 않는 계좌, ST04: VAN 요청중 시스템 에러, ST06: 거래번호 정보가 없음, ST08: 이미 등록된 계좌, ST10: 내부 시스템 에러, ST12: 출금계좌 잔액부족, ST14: ARS 인증 요청 값이 상이함, ST16: 출금계좌거래제한, ST18: 계좌오류: (간편계좌등록불가), ST20: 계좌오류, ST22: 법적 제한 계좌, ST24: 예금주 불일치, ST26: 취소금액 오류, ST28: ARS수신불가, ST30: 환불 진행중, ST32: 납부자 성명조회 실패, ST34: 1일한도초과, ST36: 일정시간이 지나 연결이 끊어졌습니다, ST38: 요청 진행 중, ST40: 처리 중 요청이 있음, ST42: 시스템 BUSY, ST44: 거래 불가 은행, ST51: 이미 등록된 현금영수증 사용자, ST53: 이미 해지된 계좌, ST61: 1회한도 금액초과, ST63: 월한도 금액초과, ST65: 월한도 건수초과, ST67: 비밀번호 불일치, ST69: 정책상 해당 결제서비스를 이용할 수 없습니다. 다른 결제수단으로 이용 부탁드립니다.

결과에 따른 정의된 코드

data.TRDNO

거래번호

data.RESULT

성공/실패 여부

SUCCESS:성공, FAILURE:실패

errCode

errCode

정상일 때는 '0000', 오류일 경우 오류코드 반환

errMsg

errMsg

오류발생 시 오류메시지

result

result

SUCCESS/FAIL

HTTP request

POST /scrap/common/settlebank/accountOccupation HTTP/1.1
Host: datahub-dev.scraping.co.kr
Authorization: Token ******************************
Content-Length: 115
Content-Type: application/json;charset=UTF-8

{
  "OID" : null,
  "CUSTID" : "123321",
  "ACCTNO" : "110123123456",
  "BANKCODE" : "088",
  "AUTHTEXT" : "kwic"
}

HTTP response

HTTP/1.1 200 OK
Date: Mon, 13 Jul 2020 06:14:42 GMT
Content-Length: 281
Connection: keep-alive
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "TRDNO" : "STFP_FIRMM205148100200713151442M1770656",
    "MCHTTRDNO" : "",
    "OUTRSLTMSG" : "정상처리",
    "OUTRSLTCD" : "0000",
    "OUTSTATCD" : "0021",
    "RESULT" : "SUCCESS"
  }
}

Curl request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/common/settlebank/accountOccupation' -i -X POST \
    -H 'Authorization: Token ******************************' \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "OID" : null,
  "CUSTID" : "123321",
  "ACCTNO" : "110123123456",
  "BANKCODE" : "088",
  "AUTHTEXT" : "kwic"
}'