PG사 연동하기 (토스페이먼츠 연동)

 PG는 'Payment Gateway'의 준말로 '결제를 위한 관문'이란 뜻입니다.

 

구매자는 온라인으로 물건을 구매할 때 카드, 가상계좌, 상품권 등 다양한 결제수단을 편리하게 사용할 수 있습니다. 하지만 온라인 상점 입장에서는 직접 여러 카드사, 은행 등 결제기관과 계약하고 결제 연동을 개발하려면 큰 비용과 시간이 듭니다.

 

이런 번거로움을 해결하기 위해 PG사는 상점이 여러 결제기관과 데이터를 안정적으로 주고받을 수 있는 시스템을 제공합니다. 우리가 보는 대부분의 온라인 상점은 이런 방식으로 PG를 통해 구매자에게 결제를 받습니다.

 

 

많이 사용되는 토스페이먼츠의 결제는 기본적으로 아래와 같은 과정으로 진행됩니다.

 

결제 흐름 요약

1️⃣ 결제 요청

구매자가 주문 정보와 금액을 확인하고 ‘결제하기’ 버튼을 클릭합니다.
클라이언트는 버튼 클릭 이벤트로 토스페이먼츠 SDK의 결제 요청 메서드를 호출해 결제창을 엽니다.
요청 시 주문번호, 성공 및 실패 URL을 정의합니다.

 

2️⃣ 구매자 정보 인증

구매자는 결제창에 카드 정보나 간편결제 앱을 통해 결제 정보를 입력합니다.
카드사는 입력된 정보를 검증해 구매자를 카드 소유자로 인증합니다.

 

3️⃣ 인증 결과 확인

인증이 성공하면 토스페이먼츠가 결제 키(paymentKey)를 발급합니다.
결제 키와 주문번호가 성공 URL로 전달되며, 이후 결제 승인 단계에서 사용합니다.

 

4️⃣ 결제 승인

서버는 성공 URL의 결제 정보를 검증하고 결제 승인 API를 호출합니다.
카드사는 결제 금액을 차감하고 최종 결과를 응답합니다.
이 시점부터 상품이나 서비스를 제공합니다.

 

 

결제 정보 검증

토스페이먼츠를 사용할 때 요청과 승인 과정 사이에서 결제 정보 검증을 구현하는 흐름은 아래와 같습니다.

 

 

아래의 토스페이먼츠 개발자센터의 샌드박스로 결제위젯을 테스트할 수 있습니다.

https://developers.tosspayments.com/sandbox

토스페이먼츠 개발자센터

 

 

또한, Github에 코드도 공개되어 있으니 쉽게 연결이 가능합니다 !

https://github.com/tosspayments/tosspayments-sample/

GitHub - tosspayments/tosspayments-sample: 토스페이먼츠 결제연동 샘플 프로젝트입니다.

 

토스페이먼츠 개발자센터에 로그인 하면 API 연동 키를 발급받을 수 있습니다. 

 

토스페이먼츠 SDK를 설치하면 결제 위젯을 사용할 수 있으며, API 키를 함께 연동하면 결제 완료 후의 로직까지 구현할 수 있습니다 !