체크아웃(Checkout) 서비스 가이드
콘솔에 설정된 프로필(결제수단별 PG사·채널 정보, 지원 국가, 승인 가능 통화 정보를 포함한 설정)을 기반으로,
고객사가 전달한 국가 코드와 결제 통화에 맞는 결제수단을 자동으로 선별하여 포트원 체크아웃 페이지에 노출하는 서비스입니다.
사용설명서
1.메뉴 위치
- 경로 : 홈 > 관리자콘솔 > 결제연동 탭 오른쪽에 신규 탭으로 '체크아웃' 메뉴가 생성됩니다.
2.프로필이란?
프로필은 결제수단별 PG사 및 채널 정보를 포함한 결제 설정 정보의 집합입니다.
각 프로필은 고유한 ID를 가지며, 해당 ID를 이용해 결제를 요청하면 프로필에 활성화된 결제수단에 연결된 PG사를 통해 결제가 진행됩니다.
또한 결제수단별로 PG사에 따라 지원하는 승인 가능 통화가 상이하므로, 결제 요청 시 전달된 파라미터(국가 코드, 통화 등)에 따라 이용 가능한 결제수단이 활성화되어 노출됩니다.
3.프로필 설정
- 기본 설정
프로필은 테스트용과 실연동용으로 구분되어 있습니다.
프로필에서 결제수단을 활성화하려면 먼저 결제 연동 > 연동정보 메뉴에서 채널을 추가해야 하며, 추가된 채널을 프로필에 연결하여 결제수단을 설정할 수 있습니다.
💡
유의사항
V2 해외결제 채널만 지원하며, 테스트 채널은 테스트 프로필에, 실연동 채널은 실연동 프로필에 설정할 수 있습니다.
이용 가능한 PG사는 다음과 같습니다.
- 페이팔(PayPal)
- 이지페이(KICC) 해외결제
- 엑심베이(Eximbay)
- 페이먼트월(Paymentwall)
- 헥토파이낸셜 해외결제
- KG이니시스 일본결제
2. 결제수단은 카드(신용카드/체크카드), 간편결제(e-Wallet), 기타 결제수단으로 구분됩니다. 결제수단 카테고리, 지원 국가, 사용 가능 통화, 지원 PG사를 기준으로 원하는 결제수단을 선택할 수 있으며, 상세 설정 모달에서 해당 결제수단에 연결할 PG사를 설정할 수 있습니다.
- 결제수단에 할당할 PG사를 설정하기 위해서는 먼저 활성화 버튼을 클릭하여 결제수단을 활성화합니다.
- 결제연동 메뉴에 설정된 PG사 중 해당 결제수단을 지원하는 PG사 리스트가 표시되며, 실제 이용할 PG사를 선택하고 해당 PG사에 설정한 채널을 선택합니다. 이때 채널명과 MID, 채널키를 확인하여 어떤 채널키로 결제가 진행되는지 확인할 수 있습니다.
- 원하는 PG사가 보이지 않는 경우 채널추가 버튼을 클릭하면 결제연동 메뉴로 이동하여 채널을 추가할 수 있습니다.
4.결제링크 생성
- Hosted Checkout
Hosted Checkout은 포트원이 생성하는 결제페이지로, 상품정보·구매자정보와 결제수단 약관을 표시하며 결제 이후 결제결과를 웹훅으로 전달합니다.
- 프로필을 설정한 이후에는 API↗ 를 이용하여 결제링크를 생성합니다. 결제링크 생성 시 전달된 프로필 아이디와 파라미터에 따라 포트원의 체크아웃 페이지는 결제수단을 활성화하여 표시합니다.
- 결제링크는 QR 형태로 고객사에서 변환하여 게시할 수 있으며, 문자·카카오톡을 통해 고객에게 전달할 수 있습니다.
💡
참고사항
USD를 파라미터로 전달했을 경우 USD로 결제할 수 있는 결제수단을 페이지에 표시하며, 결제 진행 시 프로필에 설정되어 있는 PG사로 결제가 진행됩니다. 따라서 결제수단별로 서로 다른 PG사를 설정할 수 있습니다.
2. 다이렉트 호출
Hosted Checkout을 호출하지 않고 특정 결제수단을 바로 호출하고자 하는 경우, 결제수단코드를 지정해서 호출합니다. 이 경우 결제링크 클릭 시 해당 결제수단 결제창으로 바로 연결됩니다.