개발자센터

페이먼트월 설정

페이먼트월 PG설정 방법을 확인합니다.

위젯(결제창)결제

페이먼트월 위젯(widget) 결제란?

페이먼트월은 해외 PG사로 국내 결제 방식과 결제 환경이 상이 합니다. 인증 결제가 일반적인 국내 환경과 달리 해외 결제는 비인증 결제가 일반적이며 비인증 결제를 페이먼트월 결제 창에서 결제가 진행되며 해당 결제창을 위젯(widget)이라고 지칭합니다.

테스트 환경 구성 방법

  1. 포트원 관리자 콘솔 로그인
  2. 결제 연동 탭 클릭
  3. 결제 대행사 설정에 테스트 → 페이먼트월 → 페이먼트월 선택 후 오른쪽 + 추가 버튼 클릭
테스트 환경 설정 예시
테스트 환경 설정 예시
  1. 페이먼트월에서 발급받은 테스트용 프로젝트 정보를 기재 후 저장합니다.
테스트 환경 상세 설정 예시
테스트 환경 상세 설정 예시
  • 페이먼트월 테스트 결제는 실 카드 번호로 테스트가 진행되어야 하며 실제 결제가 발생되기 때문에 반드시 테스트 이후에는 취소 처리를 진행해 주셔야 합니다.
  • 국가별 결제수단의 정책에 따라 취소(환불)이 불가한 국가/결제수단이 있을 수 있습니다.

실 환경 구성 방법

  1. 포트원 관리자 콘솔 로그인
  2. 결제 연동 탭 클릭
  3. 결제 대행사 설정에 실연동 →페이먼트월 → 페이먼트월 선택 후 오른쪽 + 추가 버튼 클릭=
실 환경 설정 예시
실 환경 설정 예시
  1. 카드사 심사 완료 후 페이먼트월에서 받은 실 상점 정보 기재 후 저장
    • 테스트모드 OFF 처리 이후 페이먼트월 검수가 완료되면 실 계정이 발급되며 해당 계정 정보를 입력합니다.
실 환경 상세 설정 예시
실 환경 상세 설정 예시

페이먼트월 결제 연동시 유의사항

페이먼트월을 통한 모든 결제요청에 대한 결과 응답은 반드시 포트원 웹훅을 통해서 결과 처리를 반드시 진행해야 합니다. 이는 페이먼트월 Transaction Flow 가 국내 PG사 상이하여 발생하는 부분입니다. 간략하게 결제 흐름을 설명하자면 페이먼트월로 요청하는 모든 거래에 대한 최종 결과 응답은 핑백(웹훅)을 통해 포트원으로 전송되며, 해당 핑백이 전송된 후 포트원이 가맹점에 웹훅을 통해 최종결과 데이터를 전송하는 구조입니다.

취소 요청도 국내 PG사 취소Flow 와 상이한 구조를 가지고 있으며 이는 페이먼트월이 가지고 있는 독특한 취소 처리 로직으로 발생하는 부분입니다. 해당 부분은 당사를 통하지 않고 페이먼트월을 직접 연동하는 경우에도 동일한 취소처리 구조를 가지게 됩니다. 페이먼트월 취소 Flow는 국내 PG사와 다르게 취소 후 즉시 취소 요청에 대한 결과를 주지 않고, 취소 요청을 하면 취소 Ticket이 생성되고 해당 티켓을 보고 페이먼트월 측에서 수기로 취소 처리한 후 해당 결과를 핑백(웹훅)을 통해 포트원으로 전송하고, 그 후 당사에서 가맹점으로 웹훅을 통해 전송하느 구조입니다.

만약 포트원을 통하지 않고 페이먼트월을 직접 연동하시는 경우에도 페이먼트월에 취소 Ticket 요청 이후 페이먼트월에서 최종적으로 취소 처리하면 결과를 핑백(웹훅)으로 가맹점에 전송하고, 가맹점은 해당 핑백(웹훅)을 가지고 최종 취소 완료 처리를 해야 합니다.
결국 페이먼트월 취소 요청 시 당사에서 전송하는 핑백(웹훅)을 수신 받기 전까지는 ”취소 처리 대기” 인 상태 표현 값을 내부 결제 내역 DB에 저장했다가 최종 핑백(웹훅)이 오면 그때 최종 취소 결과 상태 처리를 완료하는 방법으로 로직을 처리해야 합니다.
결제/취소 결과가 반영이 되지 않는다면 Project 메뉴의 Project key settingPingback Signature version3으로 설정되어 있는지 확인해주세요.

페이먼트월 취소 유의사항

기본적으로 취소 대기 상태가 존재하지만 일부 결제수단(특히 페이팔)인 경우 취소 대기 상태 없이 바로 결제가 취소되는 결제수단도 존재합니다. 따라서 취소 대기상태 없이 바로 웹훅을 통해 cancelled 상태를 받아볼수도 있는점 유념해주세요

페이먼트월 가입 방법

페이먼트월 가입시에는 반드시 포트원 전용 가입링크를 통해 가입진행이 되어야 합니다.

위젯 버전 설정

현재 포트원은 pw_1t3_1 위젯 코드를 지원하고 있으며, pw_1 위젯을 이용하시려는 경우 버전이 1.2여야 정상적으로 작동합니다.

  1. 페이먼트월 콘솔 → My Projects에서 해당 프로젝트 선택 → Widgets
  2. Version 1.2 선택 후 저장(SAVE CHANGES)
My Projects → 프로젝트 선택 → Widgets 선택
My Projects → 프로젝트 선택 → Widgets 선택
좌측 상단 Version에서 1.2 선택 → SAVE CHANGES
좌측 상단 Version에서 1.2 선택 → SAVE CHANGES

API 결제

서비스 준비중

서비스 준비중