모두
모두콘텐츠
쇼핑몰에 네이버페이를 붙이려다 보면 ‘개발자모드부터 켜야 하나?’ 하고 막히기 쉽습니다. 그런데 네이버페이 앱에 개발자모드라는 스위치가 따로 있는 건 아닙니다. 보통 이 말은 가맹점이 실제 돈이 오가지 않는 개발환경에서 결제 연동을 시험하는 과정을 가리킵니다. 구매자가 쓰는 네이버페이 설정이나 브라우저의 개발자 도구와도 다른 이야기예요.
먼저 결제형인지 주문형인지 확인하세요
네이버페이를 쇼핑몰에 붙이는 방식은 크게 두 가지입니다. 결제형은 내 쇼핑몰 주문서에서 여러 결제수단 중 네이버페이를 선택하게 하는 방식입니다. 주문형은 상품 페이지에 ‘네이버페이 구매하기’ 버튼을 두고, 네이버페이 주문서에서 주문을 진행하는 방식이고요.
예를 들어 자체 주문서에서 배송지와 쿠폰을 입력한 뒤 결제수단만 네이버페이로 바꾸고 싶다면 결제형에 가깝습니다. 상품 페이지에서 바로 구매 버튼을 누르게 하고 주문·배송·클레임까지 네이버페이 흐름으로 처리하려면 주문형을 확인해야 합니다. 두 방식은 테스트 절차와 확인할 항목이 다르니, 처음부터 구분해 두면 메뉴를 헤매는 시간이 줄어듭니다.
결제형 테스트는 어디서 시작할까요
네이버페이 개발자센터에 로그인한 뒤 ‘내 개발정보 → 결제형 → 결제 연동 체험하기’로 들어가면 결제 연동용 예제 코드를 볼 수 있습니다. 개발자센터의 결제형 안내에는 결제 버튼과 결제화면을 붙이는 자바스크립트 도구도 소개돼 있습니다. 직접 연동하는 쇼핑몰이라면 예제를 먼저 실행해 흐름을 익힌 다음, 자기 주문서에 맞춰 적용하는 편이 이해하기 쉽습니다.
테스트할 때는 개인 네이버 계정으로 개발환경 서비스 이용에 동의하고 결제수단을 등록합니다. 포인트가 필요하다면 같은 ‘결제 연동 체험하기’ 메뉴의 ‘테스트용 포인트 받기’를 이용할 수 있습니다. 개발환경에서는 결제를 끝까지 진행해도 실제 출금이 발생하지 않는다고 네이버페이 개발자센터가 안내합니다. 다만 계좌를 등록하는 과정에는 실제 은행 계좌가 필요할 수 있으니, 테스트 결제와 결제수단 등록을 같은 일로 생각하지 않는 게 좋습니다.
결제 버튼이 뜨는지만 보고 끝내면 아쉬워요. 주문서에서 금액을 넘긴 뒤 결제창이 열리는지, 사용자가 결제를 마쳤을 때 쇼핑몰 주문 상태가 제대로 바뀌는지까지 확인해야 합니다. 취소 기능도 만들었다면 개발환경에서는 결제취소 기능을 호출해 시험합니다. 실제 서비스의 네이버페이센터에서 하는 취소와 테스트 방법이 다릅니다.
주문형은 구매 버튼부터 주문 처리까지 봅니다
주문형을 준비한다면 일반 구매자가 접근하지 못하는 테스트 환경을 마련하는 것이 출발점입니다. 네이버페이 개발자센터의 주문형 안내에 따르면, 테스트 주문은 쇼핑몰이 주문 정보를 등록하고 네이버페이 주문서를 연 뒤 결제를 진행하는 순서로 생성됩니다. 버튼만 화면에 보인다고 주문 연동이 끝난 것은 아니라는 뜻입니다.
테스트 주문을 만든 뒤에는 주문이 조회되는지, 취소나 배송 상태 변경을 처리할 수 있는지도 살펴야 합니다. 주문형 샌드박스에서는 실제 결제와 정산이 일어나지 않습니다. 또 샌드박스용 네이버페이센터가 제공되지 않으므로 테스트 주문의 확인과 처리는 주문관리 기능을 호출해 진행합니다. 운영 중인 쇼핑몰이라면 검수가 끝나기 전에 일반 구매자에게 테스트 버튼이 보이지 않도록 하는 점도 중요합니다.
오류가 나면 인증 정보와 환경을 먼저 맞춰보세요
테스트 결제창에서 ‘유효하지 않은 가맹점’이라는 메시지가 나오면 코드를 전부 다시 쓰기 전에 인증 정보를 확인해 보세요. 네이버페이는 개발환경과 실제 서비스 환경의 인증 정보를 구분합니다. 개발자센터 ‘내 개발정보 → 결제형 → 내 인증값 확인하기’에서 현재 테스트하는 환경에 맞는 값을 확인할 수 있습니다. 운영용 값으로 개발 결제창을 호출하거나 반대로 연결하면 예상치 못한 오류가 납니다.
인증 정보는 결제 화면에 드러나지 않게 관리해야 합니다. 연동 개발과 자체 테스트가 끝난 뒤에도 바로 일반 고객에게 공개하는 흐름은 아닙니다. 네이버페이의 연동 절차에는 가맹점 검수가 포함돼 있고, 자체 개발 가맹점은 개발 체크리스트를 확인해 검수를 요청하게 됩니다. 쇼핑몰 제작 서비스를 쓰고 있다면 제공 업체의 네이버페이 설정 방식과 검수 절차도 함께 확인하는 편이 좋습니다.
‘네이버페이 개발자모드’를 찾고 있었다면 앱 안의 숨은 메뉴를 뒤지기보다, 내 쇼핑몰에 필요한 연동 방식부터 확인해 보세요. 테스트 결제 한 건이 화면 표시, 주문 상태, 취소 처리까지 자연스럽게 이어지는지 보는 것이 실제 운영을 준비하는 데 더 유용합니다.
