쿠팡 WING 오픈API 키 발급 방법
쿠팡 오픈API 키는 WING 판매자센터에서 직접 발급받을 수 있어요. 발급받은 액세스 키와 시크릿 키, 업체코드, 답변 작성에 쓸 WING 아이디를 제디 에이전트에 입력하면 쿠팡 문의를 받고 답할 수 있어요.
최종 업데이트· 약 10분 소요
한눈에 보기
- 발급 위치
- WING 판매자센터의 오픈API 키 발급 화면 (셀프 발급)
- 필요한 값
- 액세스 키, 시크릿 키, 업체코드, WING 아이디 (4개)
- 키 유효기간
- 발급일로부터 180일 (만료 14일 전부터 재발급 가능)
- 호출 가능 시점
- 발급 직후가 아니라 최대 24시간 뒤
- 발급 조건
- 사업자 인증 완료
이 가이드로 연결하면
시작 전에 준비하세요
- 사업자 인증이 완료된 쿠팡 WING 판매자 계정
- 제디가 안내하는 서버 IP (채널 연결 화면에서 확인할 수 있어요)
발급 절차
WING에서 오픈API 키 발급 화면을 열어요
WING 판매자센터에 로그인하고, 오른쪽 위 아이디를 눌러 판매자정보 또는 추가판매정보로 들어가요. 아래쪽의 오픈API 키 발급에서 API Key 발급 받기를 눌러요. 사업자 인증이 끝나 있어야 발급 버튼이 활성화돼요.
사용 목적과 약관에 동의해요
사용 목적에서 오픈API를 고르고 약관에 동의해요.
연동 방식을 골라요
연동 방식에서 자체개발을 고르고, API를 호출할 서버의 IP를 허용 IP에 등록해요(최대 10개). 제디로 연결할 때 안내해 드리는 서버 IP를 넣으면 돼요. 이미 다른 연동 업체를 쓰고 있다면 아래 문제 해결을 먼저 확인해요.
키를 확인하고 바로 저장해요
발급이 끝나면 화면에 업체코드와 액세스 키, 시크릿 키가 나와요. 시크릿 키는 발급 화면을 벗어나면 다시 확인하기 어려우니 바로 복사해 안전한 곳에 보관하세요.
제디 에이전트에 입력해요
액세스 키와 시크릿 키, 업체코드, 그리고 답변 작성자로 쓸 WING 로그인 아이디를 제디 에이전트의 채널 연결 화면에 입력하고 연결해요.
입력값이 어디에 있나요?
| 입력칸 | 찾는 위치 |
|---|---|
| 액세스 키 (access key) | WING의 판매자정보 또는 추가판매정보에 있는 오픈API 키 발급 화면에서 발급 직후에 나와요. 발급할 때 바로 복사해 두세요. |
| 시크릿 키 (secret key) | 같은 발급 화면에서 액세스 키와 함께 나와요. 발급 화면을 벗어나면 다시 확인하기 어려우니 발급할 때 꼭 저장하세요. |
| 업체코드 (vendor id) | WING 오른쪽 위 판매자 이름을 누르면 보이는 A나 C로 시작하는 코드예요. 로그인 아이디와는 다른 값이에요. |
| WING 사용자 아이디 (답변 작성자) | WING에 로그인할 때 쓰는 아이디예요. 답변을 누가 썼는지 표시하는 데 쓰여요. 업체코드와는 다른 값이에요. |
문제가 생겼나요?
키를 발급받았는데 연결이 안 돼요.
발급 직후에는 호출 권한이 아직 열리지 않았을 수 있어요. 최대 24시간 뒤에 다시 시도해 보세요. 그래도 안 되면 허용 IP에 제디 서버 IP가 등록됐는지, 키 유효기간(180일)이 지나지 않았는지 확인해 주세요.
시크릿 키를 복사하기 전에 화면을 닫았어요.
발급 화면을 벗어나면 시크릿 키를 다시 확인하기 어려워요. 키를 재발급해 새 키로 연결해 주세요. 재발급하면 기존 키는 바로 사용할 수 없게 되니, 다른 서비스가 그 키를 쓰고 있다면 함께 바꿔 줘야 해요.
이미 다른 연동 업체(솔루션)를 쓰고 있어요.
쿠팡은 연동업체 방식과 자체개발 방식을 동시에 등록할 수 없고, 업체코드 하나에 키도 하나뿐이에요. 기존 연동을 유지하려면 자체개발로 바꾸고 허용 IP에 기존 업체 서버 IP와 제디 IP를 함께 넣어야 해요. 잘못 바꾸면 기존 연동이 끊길 수 있으니 시작하실 때 함께 봐 드릴게요.
자주 묻는 질문
발급하면 바로 연결되나요?
키는 바로 나오지만 실제로 호출할 수 있을 때까지 최대 24시간이 걸릴 수 있어요. 발급 직후 잠시 안 되더라도 다음 날 다시 시도하면 돼요.
키에 사용 기한이 있나요?
네, 발급일로부터 180일이에요. 만료 14일 전과 7일 전에 메일로 알려주고, 만료 14일 전부터 재발급할 수 있어요.
키를 재발급하면 어떻게 되나요?
재발급하면 기존 키는 바로 사용할 수 없게 되고, 새 키가 반영되기까지 30분 정도 걸릴 수 있어요. 그 사이 짧은 연동 공백이 생길 수 있으니 문의가 적은 시간대에 재발급하는 걸 권해요.
연동 방식은 나중에 바꿀 수 있나요?
네, 바꿀 수 있어요. 다만 연동 정보 수정은 주당 횟수 제한이 있고 반영에 시간이 걸릴 수 있으니, 처음부터 자체개발로 설정해 두는 걸 권해요.
공식 문서
발급 화면이나 정책이 바뀌면 아래 공식 문서가 가장 정확해요. 이 가이드도 공식 문서를 기준으로 관리하고 있어요.
연결하면 답변 초안까지
써 두는 AI 직원이 생겨요.
제디 에이전트는 쇼핑몰 운영자를 위한 CS 전용 AI 서비스예요. 여러 판매 채널의 문의를 한 화면에 모으고, 우리 매장 기준과 말투에 맞는 답변 초안을 미리 써 둬요.
검토하고 보내기만 하면 돼요.