쇼피파이
개발자센터-한국어
포트원에서 제공하는 쇼피파이 결제 플러그인을 통해 포트원은 모든 결제채널을 연결할 수 있습니다.
플러그인 설치 및 콘솔 설정만으로도 결제서비스를 도입하고 노출 결제수단을 손쉽게 제어할 수 있습니다.
플러그인 결제 Flow
ㆍ쇼피파이 스토어에 포트원 결제앱을 설치하고 포트원 콘솔의 쇼피파이 채널과 동기화를 진행합니다.
ㆍ포트원에서 제공하는 모든 PSP에 대해서 결제가 가능하지만 쇼피파이 플랫폼 특성에 맞는 결제수단을 선택합니다.
ㆍ글로벌 포트원은은 PortOne Korea Gateway 채널을 통해 코리아 포트원에서 제공하는 한국PG사도 연결하여 결제를 받을 수 있습니다.
ㆍ글로벌 포트원에 연결된 PSP만 이용할 경우에는 글로벌 포트원 계정만 생성해도 되지만 코리아 포트원에서 제공하는 PG를 이용하려면 코리아 포트원 계정생성이 필요합니다.
ㆍ글로벌 포트원에 연결된 PSP만 이용할 경우에는 글로벌 포트원 계정만 생성해도 되지만 코리아 포트원에서 제공하는 PG를 이용하려면 코리아 포트원 계정생성이 필요합니다.
쇼피파이 결제 플러그인을 이용하기 위해서는 이용문의를 확인 후 서비스 이용계약이 필요합니다.
쇼피파이 스토어에 포트원 결제앱 설치하기
ㆍ글로벌 포트원 콘솔 > Test Mode > Payment Channels > SHOPIFY 채널을 추가합니다.
ㆍAdd Keys를 클릭한 다음 주소입력란에 쇼피파이 도메인을 https://와 함께 입력합니다.
ㆍ도메인의 경우 서비스 도메인이 아닌 쇼피파이에서 할당한 내부 도메인을 입력합니다. (쇼피파이 설정 > 도메인 메뉴에서 확인가능)
ㆍAdd Keys를 클릭한 다음 주소입력란에 쇼피파이 도메인을 https://와 함께 입력합니다.
ㆍ도메인의 경우 서비스 도메인이 아닌 쇼피파이에서 할당한 내부 도메인을 입력합니다. (쇼피파이 설정 > 도메인 메뉴에서 확인가능)
ㆍ쇼피파이 설정 > 지급 > 결제 방법 추가를 클릭합니다.
ㆍ공급업체 선택 탭을 클릭한 후 PortOne을 검색하여 PortOne Payments 앱을 설치합니다.
ㆍ공급업체 선택 탭을 클릭한 후 PortOne을 검색하여 PortOne Payments 앱을 설치합니다.
ㆍ앱이 검색되지 않을 경우 앱 설치주소로 이동하여 수동설치를 진행합니다.
ㆍPortOne Payments를 선택 한 후 좌측상단의 기타작업 > 관리를 클릭하여 관리 화면으로 이동합니다.
ㆍ글로벌 포트원 콘솔 > Settings > API탭의 PortOne Key를 입력하고 Verify를 진행합니다.
ㆍ글로벌 포트원 콘솔 > Settings > API탭의 PortOne Key를 입력하고 Verify를 진행합니다.
ㆍ결제고객에게 표시할 결제가능수단을 제외하고 나머지는 OFF처리 하고 저장을 합니다.
ㆍ이 기능은 쇼피파이에서 제어하는 부분으로 전체선택(해제) 등의 기능을 지원하지 않습니다.
ㆍ이 기능은 쇼피파이에서 제어하는 부분으로 전체선택(해제) 등의 기능을 지원하지 않습니다.
결제채널 설정
ㆍ글로벌 포트원 콘솔 > Test Mode > Payment Channels > 이용하실 결제채널을 추가합니다.
ㆍ한국PG결제가 필요하다면 PortOne Korea Gateway 채널을 추가합니다.
ㆍ페이레터, 페이먼트월, 이니시스JP, 엑심베이의 paypay는 PortOne Korea Gateway 채널추가 없이 결제가 가능합니다.
ㆍ채널별 테스트 Credential은 영문문서를 참고하여 설정합니다.(채널선택 > Add Keys 클릭 후 정보입력)
ㆍ신용카드의 경우 이용하고자 하시는 채널의 결제수단을 활성활 할 때 default 체크박스를 체크해 주셔야 합니다.
ㆍ요청하는 결제통화를 PG사가 지원하지 않는다면 결제수단이 활성화 되지 않으니 계약 시 확인해 주세요.
ㆍ한국PG결제가 필요하다면 PortOne Korea Gateway 채널을 추가합니다.
ㆍ페이레터, 페이먼트월, 이니시스JP, 엑심베이의 paypay는 PortOne Korea Gateway 채널추가 없이 결제가 가능합니다.
ㆍ채널별 테스트 Credential은 영문문서를 참고하여 설정합니다.(채널선택 > Add Keys 클릭 후 정보입력)
ㆍ신용카드의 경우 이용하고자 하시는 채널의 결제수단을 활성활 할 때 default 체크박스를 체크해 주셔야 합니다.
ㆍ요청하는 결제통화를 PG사가 지원하지 않는다면 결제수단이 활성화 되지 않으니 계약 시 확인해 주세요.
ㆍ한국PG결제(이니시스,토스페이먼츠,네이버페이 등)가 필요하다면 PortOne Korea Gateway 채널을 추가합니다.
ㆍPortOne Korea Gateway 채널을 추가하셨다면 코리아 포트원 계정생성 및 채널설정이 필요합니다.
ㆍ글로벌 포트원 Test Mode에 코리아 포트원의 테스트 연동정보를 불러오도록 합니다.
ㆍ결제연동 > 식별코드ㆍAPI Keys에서 V1의 3가지 정보를 PortOne Korea Gateway 채널에 설정 후 Fetch MIDs를 진행하면 채널정보를 가져옵니다.
ㆍ글로벌 포트원 Test Mode에 코리아 포트원의 테스트 연동정보를 불러오도록 합니다.
ㆍ결제연동 > 식별코드ㆍAPI Keys에서 V1의 3가지 정보를 PortOne Korea Gateway 채널에 설정 후 Fetch MIDs를 진행하면 채널정보를 가져옵니다.
ㆍ채널정보를 가져온 이후 PG사별로 가져온 MID를 설정해 줍니다.
ㆍ결제를 이용할 결제수단을 ON처리합니다. 신용카드의 경우 결제가 되어야 할 PG사를 Default로 설정합니다.
ㆍ결제를 이용할 결제수단을 ON처리합니다. 신용카드의 경우 결제가 되어야 할 PG사를 Default로 설정합니다.
ㆍ쇼피파이 스토어의 테스트 주문을 통해 PortOne Payments앱이 활성화 된 것을 확인 후 테스트 결제를 진행합니다.
ㆍ결제앱에 표시되는 결제사 이미지를 변경하고 싶다면 상단의 안내와 같이 설정 > 관리 화면에서 On/Off를 진행합니다.
ㆍ화면과 같이 텍스트로 표시되는 문구를 수정하고 싶다면 쇼피파이 테마 > "After clicking"으로 검색 후 checkout payment 영역의 내용을 원하는 문구로 수정합니다.
ㆍ결제앱에 표시되는 결제사 이미지를 변경하고 싶다면 상단의 안내와 같이 설정 > 관리 화면에서 On/Off를 진행합니다.
ㆍ화면과 같이 텍스트로 표시되는 문구를 수정하고 싶다면 쇼피파이 테마 > "After clicking"으로 검색 후 checkout payment 영역의 내용을 원하는 문구로 수정합니다.
ㆍ쇼피파이의 경우 상품명을 결제창으로 전달하지 않기 때문에 웹훅설정을 통해 상품명을 가져와야 합니다.
ㆍ한국PG의 경우 결제창에 상품명을 표시해야 하므로 Portone Korea Gateway를 추가하셨다면 웹훅을 설정해 주세요.
ㆍ가이드에 따라 웹훅 Sign 값을 생성하신 후 support@portone.io 로 쇼피파이 웹훅설정요청 메일을 전송해 주십시오.
ㆍ한국PG의 경우 결제창에 상품명을 표시해야 하므로 Portone Korea Gateway를 추가하셨다면 웹훅을 설정해 주세요.
ㆍ가이드에 따라 웹훅 Sign 값을 생성하신 후 support@portone.io 로 쇼피파이 웹훅설정요청 메일을 전송해 주십시오.
결제 라이브 전환
ㆍ테스트 결제가 완료되고 PSP로부터 심사가 완료되어 라이브 Credential을 발급받았다면 글로벌 포트원을 Live Mode로 전환하고 채널설정을 다시 진행합니다.
ㆍ쇼피파이 PortOne Payments 설정에서 테스트 모드를 OFF 처리하고 저장합니다.
ㆍ쇼피파이의 테스트 모드는 글로벌 포트원에 Test Mode의 채널을 참조하고 라이브 모든는 Live Mode의 채널을 참조하여 결제가 진행됩니다. ㆍ라이브결제를 진행하고 글로벌 포트원의 Live Mode의 Transaction과 PSP 대쉬보드에 결제내역이 잘 쌓이는지 확인합니다.
ㆍ쇼피파이 PortOne Payments 설정에서 테스트 모드를 OFF 처리하고 저장합니다.
ㆍ쇼피파이의 테스트 모드는 글로벌 포트원에 Test Mode의 채널을 참조하고 라이브 모든는 Live Mode의 채널을 참조하여 결제가 진행됩니다. ㆍ라이브결제를 진행하고 글로벌 포트원의 Live Mode의 Transaction과 PSP 대쉬보드에 결제내역이 잘 쌓이는지 확인합니다.