API 레퍼런스  >  은행 연동

카드 상세 조회

등록된 카드 한 건의 상세 정보를 조회합니다.

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

Request

Request 항목 명세 ›
No 변수명 타입 길이 필수 설명 비고
1 settingId Long Y 카드 설정 ID (Path). 카드 등록·목록 조회 응답의 settingId 1 이상의 숫자
Request 샘플 ›
Request 샘플
GET https://api.sendbill.co.kr/api/v1/cards/12

SBKEY: xxxxxxxxxxxxxxxxxxxxxxxxx
Accept-Charset: UTF-8

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