개발자센터
V1
V2
릴리즈 노트 기술 블로그

결제 내역

결제가 이루어진 거래내역을 조회할 수 있는 메뉴입니다.

결제내역 체계

결제내역 화면에서는 결제가 이루어진 내역을 확인할 수 있는 화면입니다.

  • 결제가 시도된 날짜의 범위를 필터할 수 있는 캘린더 필터
  • 결제내역의 특정 데이터를 지정하여 혹은 미지정시 전체 데이터를 통합검색을 할수 있는 통합검색
  • 결제 상태, 수단, 대행사, 유형, 모드 를 지정하여 검색 할 수 있는 필터
  • 검색된 내역 결과를 상태별로 통계화 한 상태별 결제건
  • 결제 상태, 고객정보, 결제 수단, 결제 대행사, 결제 금액, 구분, 요청시각, 완료시각을 확인할 수 있는 결제내역 리스트 뷰
  • 해당 내역의 특정 결제건의 우측 코너를 클릭하여 MID, UID 복사 및 결제취소 기
  • 해당 내역의 특정 결제건을 클릭하여 확인할 수 있는 결제내역 상세정보
  • 해당 내역의 특정 결제건을 클릭하여 수행 할 수 있는 결제 취소 기능
  • 해당 내역의 특정 결제건을 클릭하여 수행 할 수 있는 웹훅 재전송 기능
  • 검색된 내역의 총 거래액 - 총 환불액의 계산을 통하여 통화별로 확인 할 수 있는 총 매출액 기능
  • 기본 결제내역 값들과 추가적으로 고객정보, 결제 대행사 정보, 카드결제 정보, 계좌결제 정보 를 선택하여 내역을 다운받을 수 있는 엑셀 다운로드 기능

위 기능들로 구성되어 있는 화면입니다.\

캘린더 필터

  • 결제 요청시각 기준으로 검색하고 싶은 결제 내역의 시작 날짜 및 시각과 끝 날짜 및 시각과 끝을 지정 합니다.

    • 결제 요청이란 고객사의 고객이 결제를 시도한 시점입니다.
    • 따라서 결제 환불 및 완료 시간 기준으로는 해당 날짜 기간안 이후로 벗어 날 수 있습니다.
  • 년, 월, 일, 시, 분 단위까지 지정하실 수 있습니다.

  • 편의를 위해 오늘, 어제, 과거 7일, 30일, 90일 버튼을 누르셔서 빠르게 세팅 하실 수 있습니다.

  • 캘린더 UI를 통해서가 아니라 직접 기간을 입력하셔서 사용하실 수 있습니다.

통합 검색

  • 결제내역의 특정값을 지정하시거나 모든 결제관련 값에 대해서 직접 입력하신 값을 검색하는 기능입니다.

  • 통합검색 필터는

    • 포트원 거래번호
    • 고객사 거래번호
    • 카드사 승인번호
    • 고객 이름
    • 고객 휴대폰번호
    • 고객 이메일
    • 결제대행사 승인번호
    • 카드번호
    • 상점아이디
    • 결제환경
    • 실시간 계좌 은행
    • 가상계좌 은행
    • 계좌번호
    • 입금자명
    • 현금영수증 발급번호
    • 고객 주소
    • 취소 사유
    • 결제환경 상세
    • 주문명

    으로 이루어져 있습니다.

  • 검색 로직은 like %value 입니다. 즉 값의 맨 앞에서부터 일치하는 값을 리턴합니다.

    • 추후에 주문명과 고객 주소는 like %value%로 업데이트 될 예정입니다.

필터

  • 결제상태, 결제수단, 결제대행사, 결제 유형, 결제 모드 를 필터하신뒤 결제 내역을 검색 하실수 있습니다.
    • 결제상태: 전체, 결제예정, 결제완료, 전체취소, 부분취소, 결제실패
    • 결제수단: 사용하시는 결제 수단 값
    • 결제 대행사: 사용하시는 결제 대행사 값
    • 결제유형: 전체, 정기결제, 일반결제
    • 결제모드: 전체, 실결제, 테스트 결제

상태별 결제 통계

  • 전체, 결제완료, 결제예정, 결제실패, 결제취소 로 이루어져있습니다. 검색된 전체 내역을 상태마다 분류하여 통계를 보여줍니다.
    • 결제 실패는 부분 취소와 전액 취소가 포함된 상태값입니다.

결제내역 리스트

  • 결제내역 리스트뷰는 캘린더 필터, 통합검색, 필터검색에 따라 검색된 결제 내역들을 보여줍니다.

  • 캘린더 필터, 통합검색, 필터검색을 설정하지 않은체 나오는 기본 내역은 현 일자부로 6개월치 전체 결제내역 데이터를 보여줍니다.

  • 보여지는 값들은 결제상태, 고객정보, 결제수단, 결제대행사, 결제금액, 구분, 요청시각, 승인시각 입니다.

    • 고객정보는 결제시 sdk에 입력하신 고객의 이름, 이메일, 전화번호 이며 해당 순서대로 값이 있는 순으로 보여집니다.

    • 구분은 일반결제, 정기결제, 테스트결제를 표기하며 일반결제는 빈값으로 표기됩니다.

  • 요청시각 및 승인시각은 내림차순으로 보여지며 요청시각 기준으로 보일지 승인시각 기준으로 보일지는 해당 값을 클릭하신뒤 선택하실 수 있습니다.

  • 결제내역 리스트의 특정 결제건의 우측 을 누르시면 고객사 거래번호(merchant_uid) 및 포트원 거래번호 (imp_uid) 를 복사하실 수 있고 결제완료, 부분취소 건에 한해서 결제취소를 하실 수 있습니다.

결제내역 상세정보

  • 결제내역 상세정보는 고객정보 섹션과 결제정보 섹션으로 나눠집니다.

  • 고객정보는 고객사가 sdk 로 전달하시는 결제하는 고객의 이름, 전화번호, 이메일, 주소 입니다.

  • 결제 정보는

    • 결제상태

    • 포트원 거래번호

    • 결제수단

      • 신용카드 일경우 매입사 및 마스킹된 카드번호가 보여집니다.
      • 가상계좌일 경우 계좌 은행, 예금주, 계좌번호, 입금시간이 보여집니다.
      • 계좌이체 일 경우 계좌 은행 이 보여집니다.
      • 휴대폰 소액 결제일 경우 통신사가 보여집니다.
    • 총결제금액

      • 총 결제금액은 주문금액 - 할인금액 입니다.
    • 주문금액

    • 공급가액(부가세)

    • 포인트 결제금액

      • 포인트 결제금액은 간편결제사 및 결제 대행사의 포인트를 지칭합니다.
    • 할인금액

      • 할인금액은 pg사 전문에서 내려주는 값입니다. pg사마다 유무가 다를 수 있는점 유의해 주시기 바랍니다.
    • 카드사 승인번호

    • 상점 아이디

    • 결제대행사

    • 결제대행사 승인번호

      • 결제대행사 승인번호란 결제대행사에서 부여하는 결제 id 입니다.
    • 결제환경

      • 결제환경이란 결제된 기기 및 웹/앱의 환경값을 파씽한 값입니다.

    이 있습니다.

결제 취소

  • 결제내역 상세 내에 결제 취소를 하실 수 있습니다. 해당 페이지는 결제 완료 및 부분취소 인 결제건에 대해서는 바로들어가실 수 있습니다.

  • 기본 세팅은 전액 환불로 되있으며 부분환불을 원하시는 경우는 환불 금액을 수정해주시거나 부분환불 클릭후 수정해주신뒤 하단의 결제취소 버튼을 누르면 됩니다.

  • 취소를 입력하시면 포트 데이터 및 pg사에게 취소 사유 값이 저장 및 전달됩니다.

  • 해당 취소건에 면세 공급가액이 포함되있을경우 해당되는 면세 공급가액 취소분을 입력하시면 됩니다.

  • 관리자 콘솔에서 취소를 하셨을시 고객사의 db에 상태 업데이트를 위해 웹훅 전송을 하게됩니다.

  • 가상계좌의 경우 환불계좌 정보를 추가 입력하실 수 있습니다.

    • 환불계좌 은행
    • 환불계좌 계좌번호
    • 환불계좌 예금주

웹훅 재발송