// schemas / CARD_APPROVAL
법인카드 승인내역
card.approvals.corp.v1
카드 단말 승인 시점 거래 (실시간 지출 모니터링)
이 데이터가 쓰이는 흐름
요청 파라미터
날짜 범위가 필요합니다. 최대 365일, chunk 90일 단위로 자동 분할됩니다.
| 필드 | 타입 | 표시명 | 필수 |
|---|---|---|---|
| dateRangeStart | date | 시작일 조회 시작일 (YYYY-MM-DD) | 예 |
| dateRangeEnd | date | 종료일 조회 종료일 (YYYY-MM-DD) | 예 |
| cardNumberMasked | array<string> | 카드번호(마스킹) 필터 (선택) 특정 카드만 조회 (배열 또는 단일 문자열). 생략 시 전 카드 승인내역을 반환 | 아니오 |
응답 필드
data-jobs/{id}/results 응답의 data[] 각 항목.
| 필드 | 타입 | 표시명 | 필수 |
|---|---|---|---|
| approvedAt | datetime | 승인시각 ISO 8601 with offset (예: 2026-04-21T14:30:00+09:00) | 예 |
| approvalNumber | string | 승인번호 카드 승인번호 | 예 |
| cardNumberMasked | string | 카드번호(마스킹) 마스킹된 카드번호. 발급사별 표기 (예: `9410-13**-****-1234`, `931051******2345`) | 예 |
| 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 | 예 |
| overseas | boolean | 해외거래여부 true=해외 / false=국내 | 예 |
| lifecycleStage | string | 승인 처리 단계 AUTHORIZED(승인) / CAPTURED(매입) / UNKNOWN. `status` 와 직교 — 같은 카드 거래의 승인 건과 매입 건을 구분. 해당 없거나 해석 불가면 UNKNOWN enum: AUTHORIZED, CAPTURED, UNKNOWN | 예 |
| 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 | 가맹점 업종 가맹점 업종 분류 (발급사 제공 시) | 아니오 |
| transactionIdentifier | string | 거래 식별자 같은 카드 거래의 승인 건과 매입 건을 잇는 식별자. 동일 거래면 동일값이며, 금액·가맹점명 차이는 반영하지 않음 | 예 |