거래대사 건별 내역 조회
getReconciliationsByFilterRetrieve reconciliation records for sub-merchant transactions, filtering by date, status, payment method, and more to identify matched or unmatched settlements.
Instructions
특정 하위 상점(store)의 거래대사(정산/거래 대사) 건별 내역을 조회합니다.
각 건은 다음 상태 중 하나를 가집니다: MATCHED(대사 성공), NOT_MATCHED(대사 불일치), INCOMPARABLE(대사 불가), NOT_COLLECTED(PG 정보 미수집), POST_CORRECTION(후보정) (내부적으로 구분되는 역방향 대사 불가(backward incomparable)는 INCOMPARABLE 로 합쳐져 제공됩니다.)
대사 불일치 상세는 statuses=[NOT_MATCHED] 로 조회 후 각 건의 notMatchedReasons 를 확인합니다. 대사 불가 사유는 INCOMPARABLE 건의 incomparableReason 필드에서 확인합니다. 날짜는 반드시 YYYY-MM-DD 형식으로 입력하며, dateType 으로 정산일/결제일 기준을 선택합니다. 조회 기간 제약: from 은 최근 6개월 이내여야 하고, 한 번에 조회 가능한 구간은 최대 2주입니다. store 아이디는 list_stores 도구로 먼저 조회할 수 있습니다.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | 조회 종료일 (YYYY-MM-DD) | |
| from | Yes | 조회 시작일 (YYYY-MM-DD) | |
| after | No | 이전 페이지의 마지막 커서 (endCursor 값) | |
| first | No | 조회할 건 수 (최대 100) | |
| store | No | 조회할 하위 상점 아이디. 생략하면 고객사 내 모든 하위 상점을 조회합니다. | |
| pgTxId | No | PG사 거래 아이디 검색 | |
| dateType | No | from/to 로 제약할 기준 (정산일 / 결제일) | TRANSACTION |
| statuses | No | 포함할 대사 상태 목록. 불일치 건만 보려면 [NOT_MATCHED] 로 지정합니다. | |
| orderName | No | 주문명 검색 | |
| paymentId | No | 고객사 결제 아이디 검색 | |
| actionTypes | No | 포함할 결제 상태 목록 | |
| transactionId | No | 포트원 결제 아이디 검색 | |
| paymentMethodTypes | No | 포함할 결제 수단 목록 | |
| settlementCurrencies | No | 포함할 정산 통화 목록 (세 자리 통화 코드) | |
| transactionCurrencies | No | 포함할 결제 통화 목록 (세 자리 통화 코드) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | 조회된 거래대사 목록 | |
| endCursor | Yes | 다음 페이지 조회에 사용할 커서 (after 로 전달) | |
| hasNextPage | Yes | 다음 페이지 존재 여부 |