API 레퍼런스  >  은행 연동

계좌 수정

등록된 계좌 정보를 수정합니다. 보낸 항목만 변경하며 보내지 않은 항목은 기존 값을 유지합니다.

accountAlias, accountUsage는 null을 보내면 값을 지웁니다. 그 외 항목은 null이나 빈 값을 보낼 수 없습니다.

bankCode를 다른 은행으로 바꿀 때는 bankAuth를 함께 보내야 합니다. 인증 방식을 바꿀 때는 새 방식의 항목을 모두 보내야 합니다(웹 로그인: webId·webPassword, 본인확인: identityType·identityValue).

bankCode, accountType, accountNo, accountPassword, bankAuth 중 하나라도 변경하면 상태가 ADDED로 바뀌어 다시 수집합니다.

PATCH https://dev.sendbill.co.kr:444/api/v1/accounts/{settingId}

Request

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

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

Body
{
    "accountAlias": "운영자금(본점)",
    "bankAuth": {
        "webPassword": "newPassword1!"
    }
}

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
    }
}