토스페이먼츠를 통해 결제했거나 결제 서비스를 운영하는 분들이 결제내역을 확인해야 하는 상황은 꽤 자주 생겨요. 구매자라면 결제가 제대로 이루어졌는지, 환불이 처리됐는지 확인해야 하고, 사업자라면 매출 내역과 정산을 관리해야 해요.
이 글에서는 토스페이먼츠 결제내역 조회 방법을 구매자(소비자)와 사업자(판매자) 두 가지 관점에서 모두 안내해드릴게요.
토스페이먼츠 결제내역 — 구매자 관점
토스 앱에서 결제내역 확인하기
토스페이먼츠로 결제한 구매자는 토스 앱을 통해 결제내역을 확인할 수 있어요. 다만, 토스페이먼츠는 B2B 결제 솔루션이기 때문에 구매자가 직접 접근하는 서비스가 아니에요. 구매자가 쇼핑몰에서 카드나 계좌이체로 결제했다면, 그 내역은 카드사 앱이나 은행 앱에서 확인하는 것이 일반적이에요.
토스페이(Toss Pay)로 결제한 경우
만약 토스페이(간편결제)를 이용해 결제했다면 토스 앱에서 확인할 수 있어요.
- 토스 앱 실행 후 하단 탭 ‘내 계좌·결제’ 선택
- ‘결제 내역’ 또는 ‘소비 내역’ 탭 선택
- 날짜 범위 또는 키워드로 검색
- 각 결제 건을 탭하면 상세 내역 확인 가능
토스 앱에서는 결제 상태(완료, 취소, 환불 처리 중)도 함께 확인할 수 있어요.
신용카드 또는 체크카드로 결제한 경우
토스페이먼츠는 결제 대행(PG) 서비스이기 때문에 신용카드로 결제했다면 최종 결제는 해당 카드사를 통해 이루어져요. 결제내역은 카드사 앱(삼성카드, 신한카드 등)에서 확인하거나, 토스 앱의 ‘카드 연결’ 기능으로 카드사 내역을 한 번에 볼 수 있어요.
토스페이먼츠 결제내역 — 사업자 관점
상점관리자에서 결제내역 조회하기
토스페이먼츠를 결제 솔루션으로 도입한 사업자는 상점관리자(대시보드)에서 모든 결제내역을 관리해요.
- 토스페이먼츠 홈페이지(tosspayments.com) 접속 후 로그인
- 상단 메뉴 ‘결제 내역’ 클릭
- 날짜 범위, 결제 상태, 결제 수단으로 필터링
- 결과 리스트에서 각 건 클릭 시 상세 정보 확인
결제내역 검색 기능 활용
상점관리자에서는 다양한 조건으로 결제내역을 검색할 수 있어요.
- 날짜 범위: 최대 6개월 단위 조회 가능
- 주문 번호(orderId): 특정 주문 건 즉시 검색
- 결제 상태: 완료(DONE), 취소(CANCELED), 부분취소(PARTIAL_CANCELED), 실패 등
- 결제 수단: 카드, 계좌이체, 가상계좌, 토스페이 등
- 금액 범위: 특정 금액 이상/이하 필터링
결제내역 상세 정보 이해하기
각 결제 건의 상세 화면에서는 다음 정보를 확인할 수 있어요.
- 결제키(paymentKey): 해당 결제 건의 고유 식별자
- 주문번호(orderId): 사업자가 지정한 주문 식별자
- 결제 금액: 총 결제 금액, 할인 금액, 실제 청구 금액
- 결제 수단: 카드사, 카드 번호 일부, 할부 여부
- 결제 시각: 결제 승인 시각
- 취소/환불 내역: 환불 처리 여부 및 금액
결제내역 엑셀 다운로드
엑셀 다운로드 방법
사업자는 결제내역을 엑셀(CSV) 파일로 내보내 매출 분석이나 세무 처리에 활용할 수 있어요. 결제 내역 화면 우측 상단 또는 하단에 있는 ‘엑셀 다운로드’ 또는 ‘CSV 내보내기’ 버튼을 클릭하면 현재 조회된 내역 전체가 다운로드돼요. 날짜 필터를 설정한 후 다운로드하면 원하는 기간의 내역만 받을 수 있어요.
다운로드 파일 활용 방법
다운로드된 CSV 파일은 엑셀이나 구글 시트에서 열 수 있어요. 결제 날짜, 금액, 수단, 상태 등이 컬럼으로 구분되어 있어요. 이 파일을 활용해 월별 매출 집계, 결제 수단별 분석, 취소율 계산 등을 쉽게 할 수 있어요. 세무 신고 시 자료로도 활용 가능해요.
API로 결제내역 조회하기
개발자용 결제 조회 API
개발자가 직접 시스템 연동을 통해 결제내역을 조회해야 하는 경우, 토스페이먼츠에서 제공하는 REST API를 이용할 수 있어요. 시크릿 키를 Authorization 헤더에 포함해 GET 요청을 보내면 결제 정보를 JSON 형식으로 받을 수 있어요. 주요 API 엔드포인트는 다음과 같아요.
- 결제 단건 조회:
GET /v1/payments/{paymentKey} - 주문번호로 결제 조회:
GET /v1/payments/orders/{orderId}
상세한 API 사용 방법은 토스페이먼츠 개발자 문서(docs.tosspayments.com)에서 확인할 수 있어요.
자동화된 내역 관리
API를 활용하면 결제 완료 시 자동으로 내부 ERP나 주문 관리 시스템에 결제 정보를 동기화할 수 있어요. 또한 웹훅을 함께 활용하면 실시간으로 결제 이벤트를 수신해 즉각적인 처리가 가능해요. 대규모 쇼핑몰이나 자동화된 운영이 필요한 서비스라면 API 연동이 필수예요.
환불 및 취소 내역 확인
취소/환불 내역 조회
결제 취소나 환불이 처리된 건도 상점관리자에서 확인할 수 있어요. 결제 내역 필터에서 상태를 ‘CANCELED’ 또는 ‘PARTIAL_CANCELED’로 선택하면 환불 처리된 내역만 모아볼 수 있어요. 각 취소 건의 상세 화면에서는 취소 사유, 취소 금액, 취소 처리 시각을 확인할 수 있어요.
환불 처리 상태 모니터링
고객이 환불을 요청했을 때 처리 상태를 확인하는 것도 중요해요. 취소 요청이 처리되면 즉시 상태가 업데이트되지만, 카드사 환불은 실제 고객 카드에 반영되기까지 1~5 영업일이 걸릴 수 있어요. 고객 문의 시 상점관리자에서 취소 처리 여부와 취소 시각을 확인해 정확한 안내를 해줄 수 있어요.
자주 묻는 질문
결제내역 조회 기간에 제한이 있나요?
상점관리자에서 한 번에 조회할 수 있는 기간은 최대 6개월이에요. 6개월 이상의 내역이 필요하다면 기간을 나눠 여러 번 조회하거나 엑셀 파일을 누적해서 관리해야 해요. API를 통해서는 더 긴 기간의 데이터를 조회하는 방법도 있으니 개발자 문서를 참고하세요.
결제내역이 상점관리자에 표시되지 않아요
결제가 정상적으로 처리됐는데 내역이 보이지 않는다면 몇 가지 확인이 필요해요. 조회 날짜 범위가 올바르게 설정됐는지, 결제 상태 필터가 적절히 설정됐는지 확인해요. 실시간 데이터가 반영되기까지 최대 몇 분이 소요될 수 있어요. 그래도 해결이 안 된다면 토스페이먼츠 고객센터에 문의해요.
마무리 — 토스페이먼츠 결제내역, 이렇게 관리해요
토스페이먼츠 결제내역은 구매자라면 토스 앱 또는 카드사 앱에서, 사업자라면 상점관리자 대시보드에서 쉽게 확인할 수 있어요. 사업자의 경우 날짜 범위와 결제 수단별 필터를 활용해 원하는 내역을 빠르게 찾을 수 있고, 엑셀 다운로드로 데이터를 관리할 수 있어요.
정기적으로 결제내역과 정산 내역을 확인하는 습관을 들이면 매출 관리와 고객 대응이 훨씬 수월해져요. 개발자라면 API를 활용해 결제 데이터를 자동화하는 것도 강력히 추천해요!