API 레퍼런스  >  은행 연동

카드 등록

카드 승인내역 자동수집을 위해 카드와 카드사 인증 정보를 등록합니다. 등록 후 수집기가 수집 주기에 따라 승인내역을 수집합니다.

지원 카드사: SHINHAN_CARD, KB_CARD (웹 로그인 방식만 지원)

과금 안내: 승인내역 조회 시 건당 과금됩니다. 등록·수정·삭제·상태 조회는 과금하지 않습니다.

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

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

Request

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

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

Body
{
    "bankCode": "SHINHAN_CARD",
    "collectCycle": 1,
    "cardType": "1",
    "cardNo": "4111111111111111",
    "cardPassword": "1234",
    "cardAlias": "법인카드1",
    "cardUsage": "출장비",
    "cardAuth": {
        "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.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
    }
}