PG 연동1-포트원 테스트 채널 생성_Spring 5기 본캠프_TIL(Today I Learned)

최종 프로젝트에 돌입하며 PG 연동을 통해 결제 기능을 구현하는 역할을 맡았습니다

PG결제 연동을 위해서는 주로 포트원을 사용하게 됩니다

여기서 PG와 포트원은 무엇일까요?

 

1. PG(Payment Gateway)란?

---

PG란 전자지급결제대행서비스로 온라인 상점에서 상품과 서비스 판매 시, 고객이 신용카드 및 다양한 결제수단을 이용하여 안전하게 결제할 수 있도록 지원하는 서비스입니다.

온라인 결제를 할 때 결제창을 보면 해당 가맹점이 이용하고 있는 결제대행사를 확인할 수 있습니다

주로 NHN KCP, 토스페이먼츠,  KG이니시스 등의 이름을 보셨을 겁니다

이 업체들을 결제 지불 대행 서비스를 진행하는 중개업체인 PG사라고 부릅니다

 

 

 

2. 포트원(PortOne)이란?

---

포트원은 PG사 결제모듈에 대한 연동 개발을 진행할 때, 다양한 개발환경에서 보다 쉽고 빠르게 개발할 수 있도록 제공되는 결제 플랫폼 혹은 결제 호스팅 서비스입니다

무료로 PG 결제를 연동해주는 서비스라고 보시면 됩니다

서비스를 통해 카카오페이나 네이버페이 등 다양한 결제 플랫폼을 프로젝트에 쉽게 연동할 수 있습니다

포트원의 경우 다양한 PG사를 통합해서 제공해주기 때문에 개발 효율이 높아 선택하게 되었습니다

 

위는 포트원의 결제 프로세스가 이루어지는 전반적인 흐름을 나타낸 그림입니다

 

3. 포트원 연동

---

3-1. 포트원 계정 생성

먼저 포트원 사이트에 들어가서 계정을 생성해야합니다

https://portone.io/korea/ko

포트원 | 온라인 비즈니스 성장을 돕는 기업

 

 

이렇게 아이디로 이메일을 입력하고 가입하기를 누르면 가입한 이메일로 인증 요청 메일이 발송됩니다

이메일 인증하기 버튼을 눌러서 포트원 회원가입을 완료합니다

 

3-2. 포트원 가맹점 키 가져오기

 

회원가입 후에는 위 사진처럼 1. 결제 연동 -> 2. 연동 정보에 들어가줍니다

테스트용 카카오페이 일반결제 채널 연동이 완료된 모습입니다

일반 결제용 대행사 종류가 많아 어떤 대행사를 이용할지 고민중이었는데 토스페이먼츠가 가장 개발자 친화적인 API 설계와 깔끔한 공식 문서 덕분에 연동 작업이 수월해서 선택하게 되었습니다

---

카카오페이와 다르게 토스페이먼츠는 시크릿 키와 클라이언트 키가 생성되었습니다

여기서 시크릿 키와 클라이언트 키는 무엇을 의미하는 걸까요?

 

4. 클라이언트 키와 시크릿 키

---

클라이언트 키와 시크릿 키는 세트로 묶여있습니다.

무조건 한 세트로 써야 하고 세트가 아닌 키를 사용하거나 테스트 또는 라이브 키를 섞어서 사용하게 되면 INVALID_API_KEY 오류가 발생하게 됩니다

 

여기서 각각의 키는 무엇을 의미하는 걸까요?

 

클라이언트 키는 결제위젯 SDK를 초기화할 때 사용합니다

 

시크릿 키는 토스페이먼츠 API를 호출할 때 사용합니다

ID와 비밀번호 대신 시크릿 키로 API 요청을 인증하게 됩니다

결제위젯 클라이언트 키로 생성한 결제를 승인, 취소, 조회하고 싶을 때 사용합니다

 

🗝️시크릿 키 사용법 

인증 및 기타 헤더 설정 | 토스페이먼츠 개발자센터

시크릿 키는 외부에 노출되면 안되기 때문에 깃허브와 클라이언트 코드 등 외부에 보이는 곳에 추가하면 안됩니다