쿠팡 윙 OPEN API 키 발급하고 담당자에게 권한 주는 법 (비밀번호 안 주고)

발주와 송장 업무를 누군가에게 맡기려고 하면 가장 먼저 부딪히는 질문이 이겁니다. "윙 아이디랑 비밀번호를 줘야 하나요?" 답은 아니요입니다. 쿠팡은 판매자가 직접 발급하는 OPEN API 키를 제공합니다. 이 키를 주면 주문 조회와 송장 등록 같은 작업만 할 수 있고 비밀번호는 판매자만 압니다. 일이 끝나면 키만 지우면 됩니다.

이 글은 그 키를 발급하는 순서와 주의할 점입니다. 쿠팡 개발자센터 공식 안내를 기준으로 썼고 저희가 실제로 셀러분들과 발급하면서 걸렸던 부분을 덧붙였습니다.

발급 전에 확인할 것

사업자 인증이 된 윙 계정이어야 합니다. 일반 회원은 발급이 안 됩니다.
판매중지 상태인 계정은 발급이 제한됩니다. 소명 후 판매가 재개되면 됩니다.
키를 받을 상대가 연동업체 목록에 있는 회사인지 아니면 자체 서버인지 물어보세요. 아래 4단계에서 갈립니다.
자체개발 방식이면 상대의 서버 IP 주소가 필요합니다. 미리 받아 두세요.

발급 순서

1. 윙 로그인 후 판매자정보로 이동

쿠팡 윙(wing.coupang.com)에 로그인하고 오른쪽 위 아이디를 누릅니다. 판매자정보 또는 추가판매정보 메뉴가 보입니다. 판매자 아이디에 따라 둘 중 하나로 나옵니다. 비밀번호를 한 번 더 묻는 경우가 있습니다.

2. 화면 아래 OPEN API 키 발급

페이지를 아래로 내리면 OPEN API 키 발급 영역이 있습니다. API Key 발급받기 버튼을 누르면 키의 사용 목적을 묻는 창이 뜹니다. OPEN API를 선택하고 확인합니다.

3. 약관 동의

약관에 모두 동의하고 약관 동의 및 Key 발급받기를 누릅니다.

4. 업체 입력 방식 선택

여기서 두 갈래입니다.

연동업체 선택: 목록에 있는 회사에 키를 주는 경우입니다. 사방넷이나 플레이오토 같은 셀러툴이 여기에 있습니다. 회사를 하나 고르고 확인합니다. 연동업체는 한 번에 하나만 선택할 수 있습니다.

자체개발(직접입력): 목록에 없는 회사나 자체 서버에 키를 주는 경우입니다. 세 칸을 채웁니다.

항목	입력할 것
업체명	키를 받을 회사 이름
URL	그 회사 홈페이지. 없으면 wing.coupang.com 을 넣어도 됩니다
IP 주소	그 회사가 알려준 서버 IP. 최대 10개

5. 발급 결과 확인

확인을 누르면 업체코드(vendorId) 와 Access Key 와 Secret Key 세 가지가 보입니다. 이 세 개를 상대에게 전달하면 됩니다.

전달할 때 지킬 것

세 값을 카톡 대화방에 그대로 남기기보다 메일이나 암호 걸린 파일로 보내고 상대가 등록했다고 하면 지웁니다. 쿠팡도 온라인 문의 때 키를 입력하지 말라고 안내합니다.
상대에게 어떤 작업에 쓰는지 확인해 둡니다. 주문 조회와 송장 등록만인지 상품 등록이나 가격 수정까지인지에 따라 맡기는 범위가 달라집니다.
대행을 그만둘 때는 판매자정보 화면의 삭제 버튼으로 키를 지우면 그 즉시 접근이 끊깁니다. 비밀번호를 바꿀 필요가 없습니다.

발급 후에 자주 겪는 일

상황	이유와 대응
발급은 됐는데 하루 정도 연동이 안 됨	처음 발급하면 실제 접근 권한이 열리기까지 24시간 이상 걸릴 수 있습니다. 재발급이나 정보 수정은 30분 안에 반영됩니다.
403 Not allowed IP 오류	등록한 IP와 실제 호출 IP가 다릅니다. IP를 수정하고 30분 뒤 다시 시도합니다.
정보 수정이 막힘	연동 정보 수정은 한 주에 10회까지입니다. IP를 자주 바꾸는 환경이면 처음에 여러 개를 넣어 두세요.
6개월 뒤 갑자기 연동 중단	키 유효기간이 180일입니다. 만료 2주 전과 1주 전에 판매자 이메일로 안내가 오고 만료 14일 전부터 재발급 버튼이 켜집니다. 재발급하면 Secret Key가 새로 나오니 상대에게 다시 전달해야 합니다.
재발급 버튼이 회색	만료 14일 전이 아직 안 된 상태입니다. 당장 바꾸고 싶으면 기존 키를 삭제한 뒤 새로 발급합니다.

스마트스토어는 방식이 다릅니다

네이버 스마트스토어는 판매자가 발급한 커머스API 키를 다른 회사에 넘겨 쓰는 것을 허용하지 않습니다. 대신 매니저 초대 기능으로 담당자 계정에 필요한 권한만 주는 방식을 씁니다. 이 부분은 따로 정리하겠습니다. 토스쇼핑은 쿠팡과 비슷하게 판매자가 키를 발급하고 IP를 등록하는 구조입니다.

정리

비밀번호를 주지 않아도 발주와 송장 업무를 맡길 수 있습니다. 키 발급은 5분이면 끝나고 지우는 것도 버튼 하나입니다. 오토셀러도 이 방식으로 일합니다. 셀러분이 직접 키를 발급해 주시면 저희 서버 IP만 등록하고 주문 확인부터 송장 등록까지 처리합니다. 발급 화면에서 막히는 부분이 있으면 카톡으로 화면을 보내주세요. 같이 봐드립니다.