셀러 가이드 · 마켓 연동과 API 키

네이버 커머스API 신청 방법

네이버 커머스API는 커머스API센터에서 애플리케이션을 등록하는 방식이에요. 등록하면 클라이언트 ID와 클라이언트 시크릿 두 개가 나오고, 이 두 값으로 스마트스토어의 상품·주문·정산 데이터를 가져올 수 있습니다. 스마트스토어센터 안에서 키를 발급하는 게 아니라 별도 사이트에서 신청한다는 점이 쿠팡과 다른 부분이에요.

신청 순서

1. 커머스API센터에 접속해 판매자 계정으로 로그인합니다. 스마트스토어센터에 로그인하는 계정과 같아야 해요.
2. 애플리케이션 등록 메뉴로 들어갑니다.
3. 애플리케이션 이름과 용도를 입력합니다. 내부에서 알아볼 이름이면 됩니다.
4. 권한 범위를 고릅니다. 상품 조회, 주문 조회, 정산 조회처럼 항목별로 선택하는 구조예요.
5. 등록을 마치면 클라이언트 ID와 클라이언트 시크릿이 발급됩니다.
6. 연동할 스토어를 지정합니다. 계정에 스토어가 여러 개면 어느 스토어에 이 애플리케이션을 연결할지 골라야 해요.

메뉴 이름과 화면 구성은 개편될 수 있으니, 못 찾으면 커머스API센터의 안내 문서 기준으로 확인하세요.

권한 범위는 필요한 것만

권한을 넓게 잡으면 나중에 편할 것 같지만, 판매 데이터에 쓰기 권한까지 열어 두면 사고 범위도 같이 커집니다. 손익 계산이 목적이라면 조회 권한만으로 충분해요.

권한은 나중에 추가할 수 있으니 처음에는 좁게 시작하는 게 안전합니다.

발급값을 다룰 때

• 클라이언트 시크릿은 비밀번호와 같은 값이에요. 이 값 하나로 내 스토어 데이터를 읽을 수 있습니다.
• 메신저나 메일 본문, 공유 문서에 평문으로 두지 마세요.
• 연동 서비스에 넣기 전에 그 서비스가 키를 암호화해서 보관하는지, 어떤 조회에 쓰는지 확인하세요.
• 시크릿이 새어 나갔다고 판단되면 즉시 재발급하고, 기존 애플리케이션은 삭제합니다.

연동이 막히는 흔한 원인

• 스토어를 지정하지 않은 경우. 애플리케이션만 만들고 스토어 연결을 안 하면 인증은 되는데 데이터가 0건으로 나옵니다. 가장 흔한 원인이에요.
• 권한을 안 고른 경우. 정산 조회 권한 없이 정산 데이터를 부르면 거절됩니다.
• 계정이 다른 경우. 커머스API센터 로그인 계정과 스토어 소유 계정이 다르면 연결이 안 돼요.
• 시크릿 복사 시 공백. 앞뒤 공백이나 줄바꿈이 따라오면 인증이 실패합니다.
• 조회 기간 제한. 한 번에 부를 수 있는 기간에 상한이 있어서, 과거 데이터를 길게 가져올 때는 나눠서 호출해야 해요. 연동 서비스가 알아서 나눠 부르는지 확인해 두면 좋습니다.

연동한 다음에 볼 것

첫 수집이 끝나면 상품 수와 주문 건수를 스마트스토어센터 화면과 맞춰 보세요. 숫자가 어긋나면 대개 조회 기간이나 주문 상태 필터가 원인입니다. 여기서 한 번 맞춰 두면 이후의 손익 숫자를 믿고 쓸 수 있어요.

광고비는 커머스API가 아니라 네이버 검색광고 쪽에서 따로 가져와야 합니다. 두 곳을 붙여야 광고비까지 뺀 순이익이 나온다는 점을 기억해 두세요.