거래대사 건별 내역 조회
getReconciliationsByFilterRetrieve reconciliation records filtered by date, status, and transaction details to identify matched, unmatched, or incomparable transactions between merchant and PG records.
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 | 다음 페이지 존재 여부 |