---
releasedAt: 2025-05-14T00:00:00.000Z
writtenAt: 2025-05-14T00:00:00.000Z
---

안녕하세요 파트너 정산 자동화팀입니다.

**고객사의 가상계좌 입출금 내역을 실시간으로 확인**할 수 있는 **‘이체내역 조회’ 페이지**를 새롭게 제공합니다.

해당 기능을 통해 고객사는 가상계좌를 통한 입금, 출금(지급/송금) 거래에 대한 **투명한 증빙 및 내부 회계 관리**가 가능해집니다.

## 📄 가상계좌 이체내역 조회

### 가상계좌 이체내역 실시간 확인

- **입출금 내역(원장) 제공**: 고객이 보유한 가상계좌를 기준으로 입금 및 출금(지급/송금) 이력을 확인할 수 있습니다.

- **검색 필터 제공**
  - 1차 필터: 이체 일시 / 이체 ID
  - 2차 필터: 입금자명, 예금주, 이체 구분 (입금/출금)

- **정렬 및 페이지네이션**: 이체 일시 기준 최신순/오래된순 정렬 가능, 페이지 단위 탐색 지원

### 진입 경로 및 화면

Step 1. 진입 경로: 정산 내역 관리 > 이체내역

(관련 이미지 첨부)

Step 2. 가상계좌 이체 내역 페이지 진입

(관련 이미지 첨부)

### 제공 컬럼 정보

|항목              |설명                      |
|------------------|--------------------------|
|이체 일시         |거래 발생 일시            |
|이체 ID           |이체 요청 식별자          |
|구분              |입금 / 출금 구분          |
|입금자명          |(입금 시) 입금자의 명의   |
|예금주            |(출금 시) 수취 계좌 예금주|
|이체 계좌 은행    |(출금 시) 수취 계좌 은행명|
|이체 계좌 번호    |(출금 시) 수취 계좌 번호  |
|이체 금액         |거래 금액                 |
|출금 후 잔액      |출금 시 계좌 잔액         |
|보내는이 통장 메모|출금 시 발신자 메모       |
|받는이 통장 메모  |출금 시 수신자 메모       |

### 이체내역 엑셀 다운로드 지원

- 조회된 내역을 **엑셀 파일로 다운로드**하여 내부 회계 및 기록 보관에 활용할 수 있습니다.

### 접근 제약 사항

- **가상계좌가 할당되지 않은 고객사**는 해당 메뉴를 확인할 수 없습니다.
- 현재 제공되는 내역은 **이체가 성공한 내역만** 조회 가능하며, 실패/취소 상태는 표시되지 않습니다.

---

## ⚠️ API 변경 안내

### 주문/주문취소 정산 건 생성 시 “정산일” 지정이 지원

정산 주기로 표현할 수 없는 불규칙적인 정산 일정을 활용하시고 계신 경우, 주문/주문취소 정산 건 생성 시 `settlementDate` 를 지정하셔서 계약 내 정산 주기 정책과 무관하게 해당 일을 정산 일로 활용합니다.

(관련 이미지 첨부)

### 이체내역 API 응답 스키마 업데이트 안내

> 해당 API은 아직 Stable 상태가 아니므로 추가 업데이트 시 호환성이 유지되지 않을 수 있습니다.

이체 내역 조회 페이지 릴리즈에 맞춰 함께 이체 내역 다건 조회 API도 개편되었습니다.

이체내역은 출금(`WITHDRAWAL`), 입금(`DEPOSIT`) 두가지 유형으로 나뉘며 서로 다른 데이터를 확인하실 수 있습니다.

상세한 내용은 개발자 센터를 확인해주세요 🙂