API 레퍼런스  >  은행 연동

카드 수정

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

cardAlias, cardUsage는 null을 보내면 값을 지웁니다. 그 외 항목(cardType 포함)은 null이나 빈 값을 보낼 수 없습니다.

bankCode를 다른 카드사로 바꿀 때는 cardAuth를 함께 보내야 합니다.

bankCode, cardType, cardNo, cardPassword, cardAuth 중 하나라도 변경하면 상태가 ADDED로 바뀌어 다시 수집합니다.

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

Request

Request 항목 명세 ›
No 변수명 타입 길이 필수 설명 비고
1 settingId Long Y 카드 설정 ID (Path). 카드 등록·목록 조회 응답의 settingId 1 이상의 숫자
2 bankCode String 15 N 카드사 코드 SHINHAN_CARD, KB_CARD
3 collectCycle Integer N 수집 주기 (분 단위) 1~999 (1분 ~ 999분)
4 cardType String 1 N 카드 유형 업무 코드. 현재 API는 값별 코드 목록을 제한하지 않음 예: 1
5 cardNo String 16 N 카드번호 '-' 없이 숫자 16자리
6 cardPassword String 4 N 카드 비밀번호 숫자 4자리
7 cardAlias String 50 N 카드 별칭 null이면 삭제
8 cardUsage String 50 N 카드 용도 null이면 삭제
9 cardAuth Object N 카드사 인증 정보 변경할 항목만 입력
10 cardAuth.searchType Integer N 인증 방식. 1 = 웹 로그인(webId/webPassword) 카드는 1만 지원
11 cardAuth.webId String 30 N 카드사 홈페이지 아이디
12 cardAuth.webPassword String 30 N 카드사 홈페이지 비밀번호
Request 샘플 ›
Request 샘플
PATCH https://api.sendbill.co.kr/api/v1/cards/12

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

Body
{
    "cardUsage": "출장비·교통비",
    "cardAuth": {
        "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.cardType String 등록된 카드 유형 업무 코드. 없으면 null
7 data.cardNo String 마스킹된 카드번호
8 data.cardAuth Object 인증 정보. 비밀번호는 반환하지 않음
9 data.cardAuth.searchType Integer 인증 방식. 1 = 웹 로그인
10 data.cardAuth.webId String 마스킹된 카드사 홈페이지 아이디
11 data.cardAuth.identityType Integer 본인확인 유형. 카드는 항상 null
12 data.cardAlias String 카드 별칭. 없으면 null
13 data.cardUsage String 카드 용도. 없으면 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": 12,
        "bankCode": "SHINHAN_CARD",
        "collectCycle": 1,
        "cardType": "1",
        "cardNo": "411*********1111",
        "cardAuth": {
            "searchType": 1,
            "webId": "te*****r",
            "identityType": null
        },
        "cardAlias": "법인카드1",
        "cardUsage": "출장비",
        "createdAt": "2026-10-15 10:20:30",
        "updatedAt": null
    }
}