API 레퍼런스  >  은행 연동

계좌 등록

은행 계좌 거래내역 자동수집을 위해 계좌와 은행 인증 정보를 등록합니다. 등록 후 수집기가 수집 주기에 따라 거래내역을 수집합니다.

사용 안내: 은행연동은 사용 설정이 된 업체만 이용할 수 있으며, 설정되지 않은 업체는 모든 은행연동 API에서 -20407 오류를 반환합니다. 사용 신청은 고객센터로 문의해 주세요.

지원 은행: SHINHAN(웹 로그인), KB(웹 로그인 또는 본인확인), IBK(본인확인)

과금 안내: 은행연동은 거래내역 조회 시 건당 과금됩니다. 등록·수정·삭제·상태·잔고 조회는 과금하지 않습니다.

계좌번호·비밀번호·인증 정보는 암호화하여 저장하며, 응답에는 마스킹된 계좌번호와 아이디만 반환합니다.

POST https://dev.sendbill.co.kr:444/api/v1/accounts

Request

Request 항목 명세 ›
No 변수명 타입 길이 필수 설명 비고
1 bankCode String 15 Y 은행 코드 SHINHAN, KB, IBK
2 collectCycle Integer Y 수집 주기 (분 단위) 1~999 (1분 ~ 999분)
3 accountType Integer Y 계좌 유형. 1 = 개인, 2 = 법인
4 accountNo String 14 Y 계좌번호 '-' 없이 숫자 10~14자리
5 accountPassword String 4 Y 계좌 비밀번호 숫자 4자리
6 accountAlias String 50 N 계좌 별칭
7 accountUsage String 50 N 계좌 용도
8 bankAuth Object Y 은행 인증 정보
9 bankAuth.searchType Integer Y 인증 방식. 1 = 웹 로그인(webId/webPassword), 2 = 본인확인(identityType/identityValue) 신한(SHINHAN): 1 웹 로그인
국민(KB): 1 웹 로그인 또는 2 본인확인
기업(IBK): 2 본인확인
10 bankAuth.webId String 30 조건 인터넷뱅킹 아이디 searchType=1이면 필수
11 bankAuth.webPassword String 30 조건 인터넷뱅킹 비밀번호 searchType=1이면 필수
12 bankAuth.identityType Integer 조건 본인확인 유형. 1 = 사업자등록번호, 2 = 생년월일 searchType=2이면 필수
13 bankAuth.identityValue String 10 조건 본인확인 값. 사업자등록번호 10자리 또는 생년월일 6자리(YYMMDD) searchType=2이면 필수. '-' 없이 숫자만
Request 샘플 ›
Request 샘플
POST https://api.sendbill.co.kr/api/v1/accounts

SBKEY: xxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json;charset=UTF-8
Accept-Charset: UTF-8

Body
{
    "bankCode": "KB",
    "collectCycle": 1,
    "accountType": 2,
    "accountNo": "12345678901234",
    "accountPassword": "1234",
    "accountAlias": "운영자금",
    "accountUsage": "급여 지급",
    "bankAuth": {
        "searchType": 1,
        "webId": "testuser",
        "webPassword": "password1!"
    }
}

Response

Response 항목 명세 ›
NO 변수명 타입 설명
1 code Integer 처리 결과 코드. 성공 시 200, 실패 시 음수
2 data Object 계좌 정보
3 data.settingId Long 계좌 설정 ID
4 data.bankCode String 은행 코드
5 data.collectCycle Integer 수집 주기 (분 단위)
6 data.accountType Integer 계좌 유형. 1 = 개인, 2 = 법인
7 data.accountAlias String 계좌 별칭. 없으면 null
8 data.accountUsage String 계좌 용도. 없으면 null
9 data.accountNo String 마스킹된 계좌번호
10 data.bankAuth Object 인증 정보. 비밀번호·본인확인 값은 반환하지 않음
11 data.bankAuth.searchType Integer 인증 방식. 1 = 웹 로그인, 2 = 본인확인
12 data.bankAuth.webId String 마스킹된 인터넷뱅킹 아이디. 본인확인 방식이면 null
13 data.bankAuth.identityType Integer 본인확인 유형. 웹 로그인 방식이면 null
14 data.createdAt String 등록일시 (YYYY-MM-DD HH:MM:SS)
15 data.updatedAt String 수정일시 (YYYY-MM-DD HH:MM:SS). 수정 전이면 null
Response JSON 샘플 › 
{
    "code": 200,
    "data": {
        "settingId": 65,
        "bankCode": "KB",
        "collectCycle": 1,
        "accountType": 2,
        "accountAlias": "운영자금",
        "accountUsage": "급여 지급",
        "accountNo": "123*******1234",
        "bankAuth": {
            "searchType": 1,
            "webId": "te*****r",
            "identityType": null
        },
        "createdAt": "2026-10-15 10:20:30",
        "updatedAt": null
    }
}