API 레퍼런스  >  은행 연동

카드 승인내역 조회

수집된 카드 승인내역을 조회합니다. 거래일 최신순(거래일, 거래시각 내림차순)으로 반환합니다.

과금 안내: 거래내역은 건당 과금됩니다. 응답 페이지에 담긴 거래 중 처음 조회되는 건만 과금하며, 이미 조회한 거래를 다시 조회하면 과금하지 않습니다.

선불 업체는 조회 시 선불 잔액에서 차감됩니다. 잔액이 이번 페이지 과금액보다 적으면 -20502 오류를 반환하며 데이터는 반환하지 않습니다. (limit을 줄여 조회하거나 잔액을 충전해 주세요.)

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

Request

Request 항목 명세 ›
No 변수명 타입 길이 필수 설명 비고
1 settingId Long Y 카드 설정 ID (Path). 카드 등록·목록 조회 응답의 settingId 1 이상의 숫자
2 page Integer N 조회할 페이지 번호 (Query) 1 이상, 기본값 1
3 limit Integer N 페이지당 건수 (Query) 1~100, 기본값 20
4 startDate String 10 N 거래일 조회 시작일 (Query) YYYY-MM-DD, 시작일 포함
5 endDate String 10 N 거래일 조회 종료일 (Query) YYYY-MM-DD, 종료일 포함. 시작일보다 빠를 수 없음
Request 샘플 ›
Request 샘플
GET https://api.sendbill.co.kr/api/v1/cards/12/transactions?page=1&limit=20&startDate=2026-10-01&endDate=2026-10-14

SBKEY: xxxxxxxxxxxxxxxxxxxxxxxxx
Accept-Charset: UTF-8

Response

Response 항목 명세 ›
NO 변수명 타입 설명
1 code Integer 처리 결과 코드. 성공 시 200, 실패 시 음수
2 data.totalCount Long 조회 조건에 맞는 전체 건수 (현재 페이지 건수 아님)
3 data.items Array 승인내역 목록
4 data.items[].transactionId Long 거래 ID
5 data.items[].settingId Long 카드 설정 ID
6 data.items[].txnDate String 거래일 (YYYY-MM-DD)
7 data.items[].txnTime String 거래시각
8 data.items[].cardName String 카드명
9 data.items[].merchantName String 가맹점명
10 data.items[].approvalNo String 승인번호
11 data.items[].txnType String 거래 구분
12 data.items[].txnAmount Number 거래금액
13 data.items[].paymentType String 결제 구분 (일시불/할부 등)
14 data.items[].installmentMonths Integer 할부 개월 수
15 data.items[].cancelYn String 취소 여부
16 data.items[].description String 비고
17 data.items[].cardTxnNo String 카드사 거래번호
18 data.items[].createdAt String 수집일시 (YYYY-MM-DD HH:MM:SS)
Response JSON 샘플 › 
{
    "code": 200,
    "data": {
        "totalCount": 42,
        "items": [
            {
                "transactionId": 501,
                "settingId": 12,
                "txnDate": "2026-10-14",
                "txnTime": "120501",
                "cardName": "신한 법인카드",
                "merchantName": "OO식당",
                "approvalNo": "30012345",
                "txnType": "승인",
                "txnAmount": 35000,
                "paymentType": "일시불",
                "installmentMonths": 0,
                "cancelYn": "N",
                "description": null,
                "cardTxnNo": "A20261014001",
                "createdAt": "2026-10-14 15:00:02"
            }
        ]
    }
}