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

쿠팡 Wing OpenAPI 키 발급 방법

쿠팡 Wing OpenAPI 키는 Wing에 로그인한 뒤 판매자 정보 계열 메뉴에서 직접 발급받습니다. 별도 심사나 신청서 없이 화면에서 바로 만들 수 있고, 발급하면 Access Key와 Secret Key 두 개가 나와요. 여기에 업체코드(Vendor ID)까지 세 가지를 함께 챙겨야 외부 서비스 연동이 됩니다.

발급 순서

1. Wing에 판매자 계정으로 로그인합니다.
2. 우측 상단 계정 영역에서 판매자 정보 또는 이에 준하는 메뉴로 들어갑니다.
3. 페이지 안에서 오픈API 키 발급 항목을 찾습니다. 대체로 판매자 정보 화면 하단이나 별도 탭에 있어요.
4. 발급 버튼을 누르면 Access Key와 Secret Key가 생성됩니다.
5. 같은 화면에 표시되는 업체코드를 함께 적어 둡니다. A로 시작하는 코드예요.

메뉴 이름과 위치는 Wing 개편에 따라 바뀔 수 있습니다. 화면에서 못 찾으면 Wing 상단 검색이나 판매자 고객센터에서 "오픈API"로 찾아보세요.

세 가지를 다 챙겨야 하는 이유

Secret Key는 발급 화면을 벗어나면 다시 못 보는 경우가 있습니다. 발급하는 순간 안전한 곳에 옮겨 적어 두세요. 잃어버리면 재발급밖에 답이 없고, 재발급하면 기존 키를 쓰던 연동이 전부 끊깁니다.

키를 다룰 때 지킬 것

• 메신저나 메일 본문에 그대로 붙여 넣지 마세요. 대화방은 검색이 되고 스크린샷은 돌아다닙니다.
• 엑셀 파일에 평문으로 두지 마세요. 공유 드라이브에 올라가는 순간 통제를 벗어나요.
• 연동 서비스에 넣을 때는 그 서비스가 키를 어떻게 보관하는지 확인하세요. 암호화해서 저장하는지, 어디에 쓰는지가 안내되어 있어야 합니다.
• 직원이 나가면 재발급하세요. 계정 비밀번호만 바꾸는 걸로는 이미 나간 키가 안 막힙니다.

발급 후 연동이 안 될 때

• 업체코드를 안 넣었거나 잘못 넣은 경우. 가장 흔한 원인이에요. 대소문자까지 그대로 넣어야 합니다.
• 키 앞뒤에 공백이 붙은 경우. 복사할 때 따라온 줄바꿈이나 공백이 인증을 깨뜨립니다.
• 권한이 있는 계정이 아닌 경우. 매니저 계정으로는 발급이 안 되거나 일부 조회 권한이 빠질 수 있어요.
• 호출 시각이 어긋난 경우. 쿠팡 API는 요청 시각으로 서명을 만들기 때문에, 서버 시간이 몇 분 이상 어긋나면 전부 거절됩니다. 연동 서비스 쪽 문제라면 이 부분을 문의해 보세요.

발급하고 나면

키를 넣으면 상품, 주문, 정산, 반품 내역을 자동으로 가져올 수 있습니다. 다만 광고 지출은 셀러용 조회 API가 따로 없어서, 광고비까지 손익에 반영하려면 광고센터에서 보고서를 내려받아 올리는 방식이 필요해요. 이 부분을 미리 알고 있으면 연동 후에 "광고비가 왜 0원이지" 하고 당황하지 않습니다.