Search
K
⌨️

페이먼트월 설정

페이먼트월 설정 방법을 확인합니다.
Deprecated
이 문서는 더 이상 관리되지 않습니다.
PortOne 개발자센터를 이용해주세요.

위젯(결제창)결제

페이먼트월 위젯(widget) 결제란?
페이먼트월은 해외 PG사로 국내 결제 방식과 결제환경이 상이 합니다. 인증결제가 일반적인 국내환경과 달리 해외 결제는 비 인증결제가 일반적이며 비 인증 결제를 페이먼트월 결제 창에서 결제가 진행되며 해당 결제창을 위젯(widget)이라고 지칭합니다.
테스트 결제
실 결제
테스트 환경 구성방법
  1. 1.
    포트원 관리자 콘솔결제 연동 -> 테스트 연동 관리 -> 페이먼트월 -> 페이먼트월 선택 -> 추가
  2. 2.
    자동으로 기입된 MID 확인후 저장 선택
포트원 관리자 콘솔→ 결제 연동 -> 테스트 연동 관리 -> 페이먼트월 -> 페이먼트월 선택 -> 추가
자동으로 기입된 MID 확인후 저장 선택
  • 페이먼트월 테스트 결제는 실 카드 번호로 테스트가 진행되어야 하며 실제 결제가 발생되기 때문에 반드시 테스트 이후에는 취소처리를 진행해 주셔야 합니다.
  • 국가별 결제수단의 정책에 따라 취소(환불)이 불가한 국가/결제수단이 있을 수 있습니다.
실 환경 구성방법
  1. 1.
    결제연동 -> 실 연동 관리 선택
  2. 2.
    페이먼트월 -> 페이먼트월 선택 -> 추가 선택
  3. 3.
    페이먼트월 계약 후 발급받은 정보를 기재 후 저장합니다.
테스트모드 OFF 처리 이후 페이먼트월 검수가 완료되면 실 계정이 발급되며 해당 계정 정보를 입력합니다.
결제연동 -> 실 연동 관리 선택
페이먼트월 -> 페이먼트월 선택 -> 추가 선택
페이먼트월 계약 후 발급받은 정보를 기재 후 저장
페이먼트월 가입시에는 반드시 포트원 전용 가입링크를 통해 가입진행이 되어야 합니다.
페이먼트월 결제 연동시 유의사항
페이먼트월을 통한 모든 결제요청에 대한 결과 응답은 반드시 포트원 웹훅을 통해서 결과처리를 반드시 진행해야 합니다. 이는 페이먼트월 Transaction Flow 가 국내 PG사 상이하여 발생되는 부분입니다. 간략한 결제 흐름을 설명해 보면 페이먼트월로 요청하는 모든 거래에 대한 최종결과 응답은 핑백(웹훅)을 통해 포트원로 전송되며 해당 핑백이 전송되면 포트원은 가맹점에 웹훅을 통해 최종결과 데이타를 내려드리는 구조입니다.
취소요청도 국내 PG사 취소Flow 와 상이한 구조를 가지고 있으며 이는 페이먼트월이 가지고 있는 독특한 취소 처리 로직으로 발생되는 부분입니다. 해당 부분은 당사를 통하지 않고 페이먼트월을 직접 연동하시는 경우에도 동일한 취소처리 구조를 가지게 됩니다. 페이먼트월 취소 Flow 는 국내 PG사와 다르게 바로 취소요청에 대한 결과를 받아보지 못하고 최초 취소요청이 되면 취소 Ticket 이 따지고 해당 티켓을 보고 페이먼트월 측에서 하나씩 취소처리하고 해당 결과를 핑백을 통해 포트원로 전송하면 그후 당사에서 가맹점으로 웹훅을 통해 전송해 드리고 있습니다.
만약 포트원을 통하지 않고 페이먼트월을 직접 연동하시는 경우에도 페이먼트월에 취소티켓요청 이후 페이먼트월에서 취소를 최종 처리하면 결과를 핑백(웹훅)으로 가맹점에 내리면 가맹점은 해당 핑백을 가지고 최종 취소완료처리를 해주셔야 합니다. 결국 페이먼트월 취소요청시 당사에서 내려드리는 웹훅을 수신 받기 전까지는 "취소처리 대기" 인 상태 표현값을 내부 결제내역 DB에 가지고 계셨다가 최종 웹훅이 오면 그때 최종 취소결과 상태 처리를 완료해주시는 방법으로 로직 처리 해주셔야 합니다.

API 결제

키인결제
정기결제
서비스 준비중
서비스 준비중