---
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`) 두가지 유형으로 나뉘며 서로 다른 데이터를 확인하실 수 있습니다.
상세한 내용은 개발자 센터를 확인해주세요 🙂
