관리자콘솔

결제

1.결제내역 조회

• 결제 요청 시각 : 결제가 요청된 시각을 기준으로 조회합니다.
• 상태 승인 시각 : 결제상태가 업데이트된 최신 시각을 기준으로 조회합니다.
  (결제취소건의 경우 취소시각으로 적용됨)

• 전체 : 입력한 단어와 여러 결제 정보 필드 중 매칭되는 거래 건을 표시합니다. 여러 필드에서 일부 혹은 전부 일치하는 경우 검색 결과에 표시됩니다. 또한, 검색의 경우 단어의 앞에서부터 일치하는 경우에만 표시되며 중간만 일치하는 경우 원하는 검색 결과를 얻지 못할 수 있습니다.
• 포트원 거래번호 : 포트원 거래번호 (imp_uid) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 가맹점 거래번호 : 가맹점 거래번호 (merchant_uid) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 주문명 : 주문명 (name) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 카드사 승인번호 : 카드사 승인번호 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 고객 이름 : 고객 이름 (buyer_name) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 고객 휴대폰 번호 : 고객 휴대폰 번호 (buyer_tel) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 고객 이메일 : 고객 이메일 (buyer_email) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 고객 주소 : 고객 주소 (buyer_addr) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 고객 우편번호 : 고객 우편번호(buyer_postcode) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 결제대행사 승인번호 : 결제대행사(PG사) 승인번호 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 카드번호 : 카드번호 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다. 카드 번호의 경우 결제대행사에 따라 마스킹되는 부분이 다르므로, 앞에 6~8자리(BIN)번호 혹은 뒷 4자리로 검색하시길 권장드립니다.
• 상점아이디 : 결제대행사 상점아이디 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 결제환경 : 결제환경(PC/MOBILE/API) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다. 검색하는 경우 대문자로 검색해야 합니다.
• 실시간 계좌 은행 : 실시간 계좌이체 거래 건에 한하여 실시간 계좌 은행 데이터 중 입력한 택스트와 일치하는 데이터가 표시됩니다. (ex. 실시간 계좌이체 거래 건의 계좌은행이 토스뱅크인 경우 )
• 가상계좌 은행 : 가상계좌 거래 건에 한하여 가상계좌 은행 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 계좌번호 : 가상계좌 거래 건에 한하여 계좌번호 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 입금자명 : 가상계좌 거래 건에 한하여 입금자명 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 현금영수증 발급번호 : 실시간 계좌이체 또는 가상계좌 거래 시 현금영수증을 발급한 거래 건에 한하여 현금영수증 발급번호(국세청 승인번호) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 취소 사유 : 결제 취소 건에 한하여 취소 사유 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다. 포트원 어드민콘솔에서 취소한 경우 취소 사유는 관리자페이지취소로 일괄 입력됩니다.
• 카드사명 : 카드사명 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 할부개월수 : 카드 결제 시 할부가 적용된 거래 건에 한하여 할부개월수 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.

• 결제상태/결제수단/결제대행사/결제유형/결제모드로 구분된 필터로 검색조건을 제어할 수 있습니다.

• 전체 : 모든 결제상태의 거래를 조회합니다.
• 결제완료:조회하시는 시점에 결제상태가 완료(status: paid)된 건의 거래를 조회합니다. (결제취소건 미포함)
• 결제예정 : 조회하시는 시점에 결제상태가 예정(status: ready)된 건의 거래를 조회합니다.
  • 결제창을 띄운 직후 결제의 상태는 결제예정(ready)로 저장됩니다.
  • 결제가 최종적으로 완료되면서 승인되면 결제완료(paid)로 상태가 변경되어 저장되나, 결제도중 모종의 이유로 인하여 고객이 결제창을 이탈한 경우에는 처음 저장된 상태(ready) 그대로 남게 됩니다.
• 결제실패 : 조회하시는 시점에 결제상태가 실패(status: failed)된 건의 거래를 조회합니다.
• 결제취소 : 조회하시는 시점에 결제상태가 취소(status: cancelled)된 건의 거래를 조회합니다.
• 승인대기 : 조회하시는 시점에 결제상태가 승인대기(status: pending)된 건의 거래를 조회합니다.
  승인대기는 페이팔(SPB/RT)을 이용하실 경우에만 존재하는 결제상태로, 결제 및 환불 요청 완료 후 승인되기까지 결제상태를 의미합니다.

• 순 거래액 : (조회된 결제내역 기준) 총 결제완료액 - 결제취소액
• EXCEL 다운로드 : 조회된 내역을 excel 데이터로 다운로드 받을 수 있습니다.

• 조회결과 항목 확인하기
  • 결제상태 : 거래별로 해당되는 결제상태를 표기합니다. (결제상태는 ④번 항목을 자세히 참조해주세요.)
  • UID/MID
    • UID : 포트원의 주문번호. imp_숫자12자리 형태입니다.
      (정기결제는 imps_숫자12자리) 결제창이 호출되자마자 자동으로 생성/저장되는 번호.
  • 상품명 : 결제요청시 지정하신 상품명(name)
  • 고객정보 : 결제요청시 지정하신 고객명(buyer_name)
  • 결제수단 : 결제요청하신 결제수단
  • 결제대행사 : 결제요청하신 결제대행사(PG사)
  • 결제금액 : 총 결제금액
  • 구분 : 정기(정기결제 실 연동), 테스트 | 정기(정기결제 테스트), 테스트 | 일반(일반결제 테스트) 으로 구분됩니다.
  • 결제요청시각 / 상태승인시각 : 조회하신 기준시각 기준으로 적용된 시각. (검은바탕에는 일자가 표기됩니다)
  • 취소 : 거래 취소를 위한 버튼
  • ≡ : 거래 상세내역 조회를 위한 버튼

2. 빌링결제 내역조회

상세 내역 조회

조회 기준

• 상태별 최종 업데이트 일시(default) : 예약, 성공, 실패, 해지 상태 건에 대해 최종 업데이트 일시를 기준으로 조회합니다. (결제 예약건의 경우 예약 예정 시각을 기준으로 조회됩니다.)
• 빌링결제 등록 일시 : 예약결제의 경우 예약건이 등록된 일시를 기준으로, 빌링키 일회성 결제 건의 경우 결제를 시도한 일시를 기준으로 조회합니다.
• 오늘 : 오늘 00시 00분 00초부터 23시 59분 59초로 설정됩니다.
• 최근7일 : 오늘을 기준으로 D-7일로 설정됩니다.
• 이번 달 : 이번달 1일부터 말일까지로 설정됩니다.
• 올해 : 올해 1월 1일부터 12월 31일까지로 설정됩니다.

필터

결제대행사

• 전체 : 모든 결제대행사의 거래를 조회합니다.
• 결제대행사 필터는 하나의 결제대행사에 모든 pg_provider가 포함됩니다.
  • KG 이니시스 : inicis, html5_inicis, inicis_v2
  • 나이스페이먼츠 : nice, nice_v2
  • 페이팔 : paypal, paypal_v2
  • 스마트로 : smartro, smartro_v2
  • 토스페이 : tosspay, tosspay_v2
  • 토스페이먼츠 : uplus, tosspayments

내역검색

• 빌링결제 아이디 : 빌링결제 아이디(schedule_id) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 고객사 거래번호 : 고객사 거래번호(paymentId) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 포트원 빌링키 : 포트원 빌링키(billingKey) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 고객 식별 정보 : 고객식별정보 (customer.id) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 고객 이름: 고객 이름 (customer.name) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.
• 상품 이름 : 상품 이름 (orderName) 데이터 중 입력한 텍스트와 일치하는 데이터가 표시됩니다.

리커버리

상태별 상세조회

• 전체 : 모든 빌링 결제 상태의 거래를 조회합니다.
• 예약 : 예약 (status : Scheduled) 상태인 거래 건만 표시됩니다.
• 성공 : 결제 대기 (status : Pending) 및 결제 성공 (status : Succeeded) 상태인 거래 건만 표시됩니다.
• 실패 : 실패 (status : Failed) 상태인 거래 건만 표시됩니다.
• 해지 : 해지 (status : Revoked) 상태인 거래 건만 표시됩니다.

2-1. 빌링결제 캘린더

기준

• 페이지 최초 진입 시 해당 월을 기준으로 데이터가 표시되며, 월을 조정하여 해당 월의 빌링결제 데이터를 확인할 수 있습니다.
• 기본적으로 거래 금액을 기준으로 표시되며, 토글을 클릭하여 건수를 기준으로 데이터 확인이 가능합니다.
• 기본적으로 KRW를 기준으로 표시되며, 해외 통화 빌링 결제 거래건이 있는 경우 해당 통화를 선택할 수 있으며 각 통화별 빌링결제 데이터를 확인할 수 있습니다.
• 해당 월의 결제예약 / 결제성공 / 결제실패 / 예약해지 상태별로 거래 금액 혹은 건수 데이터를 확인할 수 있습니다.

3. 현금영수증 관리

• 포트원 거래분 : 포트원을 통해 결제된 거래에 대한 현금영수증 발행분을 의미합니다.
  • 발행 API : POST /receipts/{imp_uid}
• 고객사 자체 거래분 : 포트원을 통해 결제되지 않은 거래에 대한 현금영수증 발행분을 의미합니다.
  • 발행 API : POST /receipts/external/{merchant_uid}`(포트원을 통해 결제되지 않은 건이어도 위 API로 현금영수증 발행이 가능합니다)

• #포트원 거래고유번호(imp_uid) : 거래건별 포트원의 고유번호로 검색가능합니다.
• #고객사 주문번호(merchant_uid) : 거래건별 고객사에서 지정하신 고유번호로 검색가능합니다.
• #발급상태 : 전체, 발급, 취소 로 검색가능합니다.
• #검색기간(발급/취소일자) : 달력으로 검색기간 조정이 가능합니다.

• 발행PG사 : 발행된 PG사명
• 포트원 거래고유번호(imp_uid) : 거래건별 포트원의 고유번호
• 고객사 주문번호(merchant_uid) : 거래건별로 고객사에서 지정하신 고유번호
• 결제일자 : 거래가 승인된 결제일
• 현금영수증 발급번호 : 현금영수증 발급후 응답되는 발급번호
• 발급유형(type) : 소득공제용 혹은 지출증빙용
• 발급상태 : 발급여부 노출
• 발급일자 : 현금영수증 발급일자
• 발급취소일자 : (발급 취소된 경우) 취소일자
• 발급금액총계(부가세) : 총금액(부가세) 표기

4. 본인인증 조회

• 조회조건 : 조건없음, 포트원 거래고유번호, 고객사 주문번호
• 조회기간(본인인증 시도시각 기준) : 본인인증 시도시각 기준으로 조회기간/시각 설정가능
• 조회건수 : 100건, 500건, 1000건

• imp_uid : 본인인증 건별로 부여되는 고유 주문번호 (포트원에서 자동생성됩니다)
• merchant_uid : 본인인증 건별로 지정하시는 고객사의 고유 주문번호 (인증창 호출시 고객사에서 지정합니다)
• PG사/PG상점아이디 : 시도하신 PG사와 상점아이디
• PG사 거래번호 : 인증성공시 PG사에서 응답된 거래번호
• 이름/성별/생년월일/통신사,전화번호/인증여부/시도시각,인증시각
  • 인증성공시 인증자의 정보(다날 본인인증의 경우 별도 요청하지 않으신 경우 통신사,휴대폰번호 정보 확인이 불가합니다.

5. 네이버 상품구매평

• 네이버페이 상품구매평 : 구매자가 네이버페이에 남긴 구매평 확인가능
• 네이버페이 쇼핑문의내역 : 구매자가 네이버페이에 남긴 쇼핑문의내역 확인가능