// schemas / CARD_APPROVAL
법인카드 승인내역
card.approvals.corp.v1
카드 단말 승인 시점 거래 (실시간 지출 모니터링)
요청 파라미터
날짜 범위 필수 — 최대 365일, chunk 90일 단위로 자동 분할.
| 필드 | 타입 | 표시명 | 필수 |
|---|---|---|---|
| dateRangeStart | date | 시작일 조회 시작일 (YYYY-MM-DD) | 예 |
| dateRangeEnd | date | 종료일 조회 종료일 (YYYY-MM-DD) | 예 |
| cardNumberMasked | string | 카드번호(마스킹) 필터 (선택) 보유카드 조회 응답의 cardNumberMasked 값. 생략 시 전 카드 조회 | 아니오 |
응답 필드
data-jobs/{id}/results 응답의 data[] 각 항목.
| 필드 | 타입 | 표시명 | 필수 |
|---|---|---|---|
| approvedAt | datetime | 승인시각 ISO 8601 with offset (예: 2026-04-21T14:30:00+09:00) | 예 |
| approvalNumber | string | 승인번호 카드 승인번호 | 예 |
| cardNumberMasked | string | 카드번호(마스킹) 발급사 마스킹 표기 그대로. 풀 PAN 발급사는 headless 가 앞 6 + 뒤 4 만 노출 | 예 |
| merchantName | string | 가맹점명 거래 가맹점 상호 | 예 |
| settledAmount | number | 정산금액 카드 청구·정산 기준 금액. 항상 양수. 취소건도 양수이며 성격은 `status` 로 구분 (해외건 소수 가능) | 예 |
| settledCurrencyCode | string | 정산통화 ISO 4217 3자. 원화 청구건 `KRW`, 발급사 원화 미제공 해외건은 발급사 통화코드, 미상은 `XXX` | 예 |
| paymentMethod | string | 결제방법 SINGLE_PAYMENT(일시불) / INSTALLMENT(할부) / CHECK(체크) / OTHER enum: SINGLE_PAYMENT, INSTALLMENT, CHECK, OTHER | 예 |
| status | string | 승인상태 APPROVED / CANCELLED / PARTIALLY_CANCELLED / DECLINED / UNKNOWN. 취소건은 원 승인건과 같은 승인번호로 별도 행으로 올 수 있음 enum: APPROVED, CANCELLED, PARTIALLY_CANCELLED, DECLINED, UNKNOWN | 예 |
| isOverseas | boolean | 해외거래여부 true=해외 / false=국내 | 예 |
| originalAmount | number | 원거래 외화금액 해외 원거래의 외화 원금. 국내·원화 해외결제(DCC)·발급사 미제공 시 null | 아니오 |
| originalCurrencyCode | string | 원거래 외화통화 ISO 4217 3자. 외화 원금의 통화. 원금 부재 시 null | 아니오 |
| installmentMonths | integer | 할부개월 할부 결제의 개월 수. 일시불/체크 등은 null | 아니오 |
| taxAmount | number | 부가세 거래에 포함된 부가가치세액 (발급사 제공 시) | 아니오 |
| merchantBusinessIdentifier | string | 가맹점 사업자등록번호 하이픈·공백 제거된 숫자만 (발급사 제공 시) | 아니오 |
| merchantAddress | string | 가맹점 주소 가맹점 사업장 주소 (발급사 제공 시) | 아니오 |
| merchantContactNumber | string | 가맹점 전화번호 가맹점 연락처 (발급사 제공 시) | 아니오 |
| merchantRepresentativeName | string | 가맹점 대표자명 가맹점 대표자명 (발급사 제공 시) | 아니오 |
| merchantBusinessType | string | 가맹점 업종 가맹점 업종 분류 (발급사 제공 시) | 아니오 |