PortOne MCP Server

--- title: PG 거래대사 가이드 description: >- PG 거래대사는 PG사와 간편결제사로부터 정산 받는 금액 및 상세내역을 포트원 콘솔에서 PG가 여러 개여도 한 번에 자동 대사된 데이터를 확인할 수 있는 통합 조회 서비스입니다. --- ## PG 거래대사 유의사항 - 포트원을 통해 연동된 아래 12개의 PG사 내역을 조회할 수 있습니다. - 지원 PG : **KCP, KG이니시스, 나이스정보통신, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠, 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜** - 고객사가 포트원을 통하지 않고 PG 직연동한 경우 지원 불가 - 9/26 이후 지원 예정 PG사 : KPN, KSNET - 고객사 주문번호를 정확하게 확인하기 위해서는 **실제 사용하시는 주문번호의 연동**이 필요합니다. - 네이버페이를 연동하실 경우 정산 API 키 등록이 필요합니다. ## 거래대사 및 정산/입금대사 소개 ### 1. 거래대사 - 포트원을 통해 발생한 고객사 주문 데이터와 PG사의 결제 데이터를 비교하여 신뢰도 높은 데이터를 제공합니다. - **주요 기능** - 일별로 고객사 거래 데이터와 PG 정산 데이터를 매칭합니다. - 여러 PG사와 결제수단을 한 번에 관리할 수 있습니다. - PG사 어드민에서 직접 취소한 거래 건도 확인하실 수 있습니다. ### 2. 정산/입금대사 - 입금된 정산금의 상세 내역을 확인할 수 있는 자료를 제공합니다. - **주요 기능** - 해당일의 PG 정산금 상세내역을 통해 입금 금액의 상세내역을 쉽게 확인할 수 있습니다. ### 3. 어떤 점이 좋나요? - 다양한 PG사와 결제수단, 통화를 통합하여 일관된 기준으로 거래 및 정산 데이터를 제공하므로, 매출 및 결제 내역의 일치성을 높여주고 매출 인식에 참조할 수 있습니다. - 거래대사를 통해 고객사 거래 데이터와 PG사의 데이터를 비교하고 정산이 확정된 정산금 데이터를 추가하므로, 데이터 오류를 최소화할 수 있습니다. ## 상세 기능 설명 ### 1. 거래내역 - 일 총거래건수와 거래금액, 총 거래 이상 건수, 거래이상금액을 확인 가능합니다. ### 2. 정산내역 - 일 정산금과 수수료를 확인 가능할 수 있습니다. ### 3. 거래건별조회 - 고객사 주문번호, PG 거래번호, 포트원 거래번호를 하나의 엑셀에서 볼 수 있습니다. - 결제수단별 상세내역을 확인할 수 있습니다. - 공급가액, 면세가액, 부가세, PG 정산 수수료, PG 정산 수수료 부가세 ## 메뉴별 기능 설명 ### 1. 거래 정산내역 거래일 기준 고객사 거래데이터, 혹은 정산일 기준 정산데이터를 확인할 수 있습니다. - **정산내역**에서는 정산일 기준으로 데이터가 조회됩니다. - **거래내역**에서는 거래일 기준으로 데이터가 조회되고 이는 PG사와 동일한 기준입니다. - 조회 기간으로 기본 조회 후, 조회기간 내 상점아이디와 PG 고객 식별아이디, 그리고 대사상태값으로 필터링 가능합니다. - 아무 것도 선택하지 않았을 경우 이번달 1일부터 어제까지의 기간이 선택됩니다. #### 1.1 거래 내역 (관련 이미지 첨부) **(1) 요약대시보드** - 설정한 조건으로 조회한 거래 결과의 요약을 확인할 수 있습니다. - 총 거래건수와 거래금액 : 설정한 조건으로 조회한 총 거래 건수와 거래 금액을 확인할 수 있습니다. - 총 거래 이상건수와 총 거래 이상 금액 : 설정한 조건으로 조회한 총 거래 이상 건수와 거래 이상 금액을 확인할 수 있습니다. - 통화를 선택하여 통화별로 확인하실 수 있으며 통화가 다른 경우 KRW 로 환산하지 않습니다. - 거래 이상 금액 : PG사 결제 금액과 고객사가 포트원에 연동한 주문금액을 비교했을 때 불일치하거나, PG사와 고객사 정보 어느 한 쪽이 없어서 비교할 수 없는 경우의 금액의 합계 **(2) 필터** - 대사상태, PG 고객식별아이디와 상점아이디로 필터링할 수 있습니다. (복수 선택 가능) - 필터 초기화 선택 시 조회기간과 필터가 모두 초기화됩니다. **(3) 표 설정** - 표시되는 항목을 선택하여 항목을 **커스터마이징** 할 수 있습니다. (관련 이미지 첨부) - 초기 설정값은 모두 선택사항으로 설정 화면에서 제외할 수 있습니다. - 초기화를 통해 초기 설정값으로 되돌아갈 수 있습니다. **(4) 엑셀 다운로드** - 조회 조건에 해당하는 **전체 데이터를 엑셀로 다운로드**할 수 있습니다. **(5) 테이블 조회** - 일별 합계 (해당 날짜에 대한 상점아이디, PG 고객 식별아이디의 전체 합계) - 합계 내 PG 고객 식별 아이디로 상세 조회 가능 - 개별 항목 - 거래내역 - 거래일, 대사상태(대사일치, 불일치, 불능, 수집이전거래건), 상점아이디, PG 고객 식별아이디&결제대행사, 거래건수, 거래금액, 취소건수, 취소금액, 거래 이상 건수, 거래 이상 금액 - 조회일자가 같고, 통화가 다를 경우 다음 열에 표시됩니다. - 참고 사항 - 수집이전 거래건 : 오래된 거래건이 늦게 정산되어, PG사에서 수집 가능한 거래정보가 없는 경우에 해당합니다. 정산정보 외에 일부 거래정보가 누락되어 있을 수 있습니다. #### 1.2 정산 내역 (관련 이미지 첨부) **(1) 요약대시보드** - 설정한 조건으로 조회한 거래 결과의 요약을 확인할 수 있습니다. - 총 정산과 정산금액 : 설정한 조건으로 조회한 총 정산 건수와 정산 금액을 확인할 수 있습니다. **(2) 필터** - PG 고객식별아이디와 상점아이디로 적용 가능 (복수 선택 가능) - 필터 초기화 선택 시 조회기간과 필터가 모두 초기화됩니다. **(3) 표 설정** - 표시되는 항목을 선택하여 항목을 **커스터마이징** 할 수 있습니다. (관련 이미지 첨부) - 초기 설정값은 모두 선택사항으로 설정 화면에서 제외할 수 있습니다. - 초기화를 통해 초기 설정값으로 되돌아갈 수 있습니다. **(4) 엑셀 다운로드** 조회 조건에 해당하는 **전체 데이터를 엑셀로 다운로드**할 수 있습니다. **(5) 테이블 조회** - 일별 합계 (해당 날짜에 대한 상점아이디, PG 고객 식별아이디의 전체 합계) - 선택하여 합계 내 PG 고객 식별 아이디로 상세 조회 가능 - 정산내역 - 정산일, 상점아이디, PG 고객식별아이디&결제대행사, 정산건수, 정산금액, 취소건수, 취소금액, 거래금액, PG 수수료, PG 수수료 부가세 - 조회일자가 같고, 통화가 다를 경우 다음 열에 표시됩니다. ### 2. 거래 건별조회 고객사 거래정산데이터 상세내역을 확인할 수 있습니다. - 조회 기간으로 기본 조회 후, 조회기간 내 상점아이디와 PG 고객 식별아이디, 대사상태, 거래상태(승인, 부분취소, 취소, 기타 취소)값으로 필터링 가능합니다. - 아무 것도 선택하지 않았을 경우 이번달 1일부터 어제까지의 기간이 선택됩니다. - 기타 취소는 식별할 수 없는 취소건(unclassified cancel) 에 해당합니다. (관련 이미지 첨부) **(1) 검색** - 설정한 조건에 해당하는 **조회 리스트**에서, 검색명과 정확히 일치하는 내역을 확인할 수 있습니다. - 주문명 검색 - PG 거래 번호 - 고객사 거래 번호 - 포트원 거래 번호 - 참고 사항 : 유사 검색 기능은 지원되지 않습니다. ex) “포트원”을 검색하기 위해 “포트”를 검색하여도 “포트원”이 조회되지 않습니다. **(2) 요약대시보드** - 설정한 조건으로 조회한 거래 결과의 요약을 확인할 수 있습니다. - 총 거래금액 : 설정한 조건으로 조회한 총 거래 금액을 확인할 수 있습니다. - 총 거래 이상 금액 : 설정한 조건으로 조회한 총 거래 이상 금액을 확인할 수 있습니다. - 거래이상금액 : PG사 결제 금액과 고객사가 포트원에 연동한 주문금액을 비교했을 때 불일치하거나, PG사와 고객사 정보 어느 한 쪽이 없어서 비교할 수 없는 경우의 금액의 합계 **(3) 조회기준일** - 거래일/정산일 을 선택할 수 있습니다. **(4) 필터** - 대사상태, 거래 구분, 거래 유형, PG 고객식별아이디와 상점아이디 적용 가능 (복수 선택 가능) - 필터 초기화 선택 시 조회기간과 필터가 모두 초기화됩니다. - 대사 상태 - “대사 불일치” 상태값의 종류 |사유 |설명 |비고 | |--------------------|---------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------| |결제 금액 불일치 |두 원장의 결제 금액이 불일치합니다. |금액 차이가 있으면 무조건 불일치로 표시 | |면세 금액 불일치 |두 원장의 면세금액이 불일치합니다. |금액 차이가 있으면 무조건 불일치로 표시 | |부가세 금액 불일치 |두 원장의 부가세 금액이 불일치합니다. |금액 차이가 있으면 무조건 불일치로 표시 | |에스크로 여부 불일치|두 원장에서 에스크로(안전결제)여부가 불일치합니다. |Y/N 다르면 불일치 표시 | |할부 개월 수 불일치 |두 원장의 카드 할부개월 수가 불일치합니다. |할부개월수 다르면 불일치 표시 | |결제일자 불일치 |두 원장의 결제일시가 불일치합니다. 시스템으로 인해 차이날 수 있는 근소한 차이의 경우는 일치로 처리합니다.|두 원장의 결제일시가 다른 일자에 일어나면 불일치 표시 (자정 기점으로 PG와 포트원간의 전송시간에 의해 거래일자가 변경되는 경우도 다른 일자일 경우 불일치 표시)| **(5) 표 설정** 표시되는 항목을 선택하여 항목을 **커스터마이징** 할 수 있습니다. (관련 이미지 첨부) - 초기 설정값은 모두 선택사항으로 설정 화면에서 제외할 수 있습니다. - 초기화를 통해 초기 설정값으로 되돌아갈 수 있습니다. **(6) 엑셀 다운로드** - 조회 조건에 해당하는 **전체 데이터를 엑셀로 다운로드**할 수 있습니다. **(7) 테이블 조회** - 조회조건 반영 - 거래정산내역에서 검색을 원하는 리스트를 선택하여 거래건별조회로 진입했을 경우 해당 조건으로 조회된 결과가 보여집니다. - 조회기준일, 조회기간, 필터가 반영됩니다. - 사이드바 메뉴에서 직접 선택하여 거래건별조회로 진입했을 경우 이번달 1일부터 어제까지의 모든 데이터가 조회됩니다. - 개별 항목 - 거래일, 대사상태(대사일치, 불일치, 불능, 수집이전거래건), 상점아이디, PG 고객 식별아이디&결제대행사, 고객사 결제번호(주문번호), PG 결제번호, 포트원 결제번호, 주문명, 거래유형, 거래금액, 공급가액, 면세가액, 부가세, PG수수료, PG수수료 부가세, 정산금액, 거래 이상 금액, 에스크로 **(8) 거래유형 상세정보** - 거래 유형에 마우스오버시 카드 형태로 상세 정보가 보여집니다. |거래유형 |상세내용 | |-----------|----------------------------------------------| |카드 |발급사, 매입사, 카드 승인번호, 카드 할부개월수| |상품권 |타입, 승인번호 | |계좌이체 |은행이름, 승인번호 | |가상계좌 |은행이름, 승인번호 | |간편결제 |간편결제사 이름 | |모바일 결제|통신사 | |기타 |기타 | ## 수식 설명 |금액 |공식 | |---------------------|------------------------------------------------------------------------------------------------------------------------------| |정산건수 |조회기간내 (승인 건수 - (취소) - (부분 취소)) + 기타정산건(수집이전거래건수; 승인과 취소, 부분 취소 데이터가 없는 정산 데이터)| |정산금액 |조회기간 내 (승인금액 - (취소 금액) - (부분 취소 금액) - (수수료) - 수수료 VAT) | |거래 건수 |조회기간 내 (승인) 건수 | |거래 금액 |조회기간 내 승인 금액 | |취소 건수 |조회기간내 (취소) + (부분취소) + (기타취소) 건수 | |취소 금액 |조회기간 내 (취소 금액) + (부분취소) + (기타취소) 금액 | |공급가액 |거래금액-(할인금액)-(면세가액)-(부가세) | |과세사업자 면세가액=0| | |부가세 |(거래금액-면세가액)/11 후 반올림 | |과세사업자 면세가액=0| | |거래 이상금액 |거래불일치 금액 절대값 + 거래대사 불능금액 | |PG 수수료 부가세 |PG사에서 값을 주지 않을 경우 PG수수료/10 후 반올림 | ## FAQ - 데이터는 전체 기간 조회 가능한가요? - 최대 3개월까지 조회가능합니다. - 여러 PG사의 데이터를 통합할 때, 각 PG사별 특성이나 차이점을 어떻게 반영하나요? - PG사 데이터를 모두 확인할 수 있는 통합 인터페이스를 만들었고, 공통으로 가져올 수 있는 값들을 기본값으로 반영하고, PG사에 따라 제공하는 값들은 있는 경우 제공하고 있습니다. - 거래대사 작업 후 불일치하는 데이터가 발견될 경우, 어떤 프로세스로 해결하나요? - 고객사가 인지할 수 있도록 어떤 건이 있는지, 총액은 얼마인지, 어디의 불일치인지 알려줍니다. 재무데이터를 임의로 수정하는 것은 서비스 제공사가 할 수 있는 일이 아닙니다. - 실시간 데이터 업데이트가 가능한가요? 아니면 일별 업데이트인가요? - 전날 기준 거래, 정산데이터를 가져와서 매일 업데이트합니다. - 복합 결제(예: 신용카드+포인트)의 경우, 데이터 처리는 어떻게 이루어지나요? - 별도로 구분되지 않고 간편결제로 표시됩니다. - 환불, 부분 취소 등의 예외 케이스는 어떻게 처리되나요? - 거래 상태값에 부분취소, 취소가 있습니다. - 다국어 및 다중 통화 지원 계획은 어떻게 되나요? - 데이터에 있으면 모든 통화를 보여줍니다. - 누락 시 대응 계획은 무엇인가요? - 데이터 수집시 PG사에 데이터가 없거나, 타임 아웃 등으로 누락이 일어나면 포트원에서 자동으로 파악이 가능하여 개발팀이 확인하고 다시 수집합니다.