네이버페이 결제 연동: 결제형·주문형 차이와 가맹 절차

안녕하세요. 사랑받는 IT 프로덕트의 첫걸음, 똑똑한개발자입니다.

네이버페이 결제형은 자사몰 주문서에 결제수단을 추가하는 방식이고, 주문형은 네이버페이 주문서를 이용하는 방식입니다. 주문과 배송을 어디에서 관리하는지에 따라 연동 범위가 달라집니다. 오늘은 두 유형의 차이와 결제형의 가입·개발 절차를 알아보겠습니다.

네이버페이 연동 전에 구분할 가맹 유형과 경로

네이버페이 결제 연동은 직접 가맹 계약을 맺고 심사와 연동 검수까지 통과해야 열리는 구조라 결제수단 하나 켜듯 끝나지 않습니다. 코드보다 먼저 정할 것은 가맹 유형, 연동 경로, 심사 일정입니다. 그중 가맹 유형이 나머지를 거의 정합니다.

네이버페이 결제형과 주문형, 주문서가 누구 것인지가 다릅니다

네이버페이 가맹 유형 안내 자료에서 두 유형을 가르는 기준은 주문서입니다. 결제형은 자사몰 주문서의 결제수단 목록에 네이버페이가 들어갑니다. 주문형은 상품 페이지의 구매 버튼을 누르면 네이버페이 주문서로 이동합니다.

회원 데이터와 쿠폰, 주문 관리를 자사몰에 두고 싶다면 답은 결제형입니다. 수수료는 두 유형 모두 매출 등급별로 다르니 가입 시점에 확인하세요.

결제형 가맹 신청과 연동 검수 절차

취급 상품과 운영 방식에 따른 가입 조건

가입 가능 여부는 사이트 운영기간, 취급 상품, 환불과 정산 방식 등에 따라 달라집니다. 기존 PG 계약으로 네이버페이를 사용 중이라면 직가맹 전환 조건도 사전 협의 항목입니다.

서류는 사업자 형태별로 준비합니다.

사업자 유형에 따라 사업자등록 관련 서류와 법인 확인 자료 등이 필요합니다. 서류 종류와 발급일 기준, 보증보험 조건은 가입 시 제공되는 안내에 맞춰 준비합니다.

서류 심사 뒤에 연동 검수가 남습니다.

서류 심사와 고객확인을 진행하며 보완 요청이 있으면 일정이 달라질 수 있습니다. 승인이 나면 개발과 자체 검수를 마친 뒤 체크리스트를 제출하고, 네이버페이가 결제 로직 취약성까지 검수해 최종 승인합니다.

네이버페이 결제형 연동 흐름, 결제창에서 승인 API까지

개발 문서는 네이버페이 개발자센터의 결제형 API 가이드에 있습니다. 인증에는 승인 후 받는 클라이언트 ID·시크릿·체인 ID를 쓰고 development 모드로 테스트합니다.

결제창은 네이버페이 SDK로 엽니다.

Naver.Pay.create로 만든 객체의 open을 결제 버튼에 연결해 금액, 상품명, returnUrl을 넘깁니다. SDK 스크립트는 내려받지 말고 네이버페이 주소에서 불러옵니다.

결제번호를 받으면 서버에서 승인합니다.

사용자 결제 인증이 끝나면 returnUrl로 resultCode=Success와 paymentId가 돌아옵니다. 서버는 이 번호로 /payments/v2.2/apply/payment 승인 API를 부릅니다. 타임아웃은 공식 문서 기준 60초로 잡고, 10분이 지나면 승인 시간 초과입니다.

금액 검증은 빼면 안 됩니다.

보안 가이드에 따라 결과를 안내하기 전 응답의 총 결제 금액이 주문 금액과 같은지 반드시 확인합니다.

PG 연동 전반은 앞서 발행한 토스페이먼츠 연동 방법 총정리 글에서 다뤘습니다.

카페24 같은 쇼핑몰 솔루션이나 PG를 쓴다면

쇼핑몰 솔루션은 그 업체에 먼저 묻습니다.

카페24처럼 호스팅사를 쓰는 몰은 가이드 안내대로 호스팅사에 연동을 요청합니다. 호스팅사마다 결제형 가입 가능 여부와 조건이 다르기 때문입니다.

PG 경유 시 지원 기능과 정산 방식

PG 결제창에서 이용할 경우 정산과 지원 기능은 계약한 PG의 조건을 따릅니다. 포인트 적립과 복합결제 등 필요한 기능을 직가맹과 동일하게 사용할 수 있는지는 해당 PG 안내에서 확인합니다.

세부 항목과 최신 적용 조건은 네이버페이 유형별 안내를 참고해 보세요.

구매 과정에 맞는 네이버페이를 준비한다면

결제 흐름을 하나씩 붙이다 보면 화면뿐 아니라 데이터와 운영 방식도 함께 살펴보게 됩니다. 지금 서비스에 필요한 범위부터 차근차근 정리해볼 수 있습니다.

똑똑한개발자는 UX/UI 디자인과 웹·앱 개발을 함께 진행합니다. 사용자가 이용하는 화면과 운영에 필요한 기능을 연결해 서비스를 만들어가는 과정을 돕습니다.

결제 흐름을 준비하면서 궁금한 점이 있다면 아래 똑똑한개발자 링크로 편하게 이야기 남겨주세요. 함께 살펴보겠습니다. 감사합니다. :)