Spresso
쿠팡 마켓 계정 연동
이 문서에서
이게 뭔가요?어느 쪽인가요?🚚 쿠팡 출고지/반품지 등록하기🔑 쿠팡 API Key 발급받기Spresso에 쿠팡 마켓 계정 추가하기결과 확인자주 보는 메시지쿠팡에서 지금 되는 것다음 단계관련 문서이게 뭔가요?
Spresso가 쿠팡에 상품을 올리고 주문을 가져오려면 쿠팡 윙(쿠팡 판매자센터)에서 발급한 OPEN API 키가 필요합니다. 이 키가 Spresso의 API Key입니다. 순서는 셋입니다.
쿠팡 윙에 출고지·반품지를 등록합니다. Spresso 마켓 정책에서 이 주소를 고르므로 먼저 해 둡니다.
쿠팡 윙에서 OPEN API 키를 발급받습니다.
Spresso에 키를 넣고 테스트한 뒤 저장합니다.
어느 쪽인가요?
출고지 주소는 판매 방식(해외 구매대행·위탁 판매·사입 판매)에 따라 다릅니다. 반품지는 모두 실제 상품을 받을 수 있는 국내 사무실 주소입니다.
| 판매 방식 | 출고지 | 반품지 |
|---|---|---|
| 해외 구매대행 | 국가 구분 ‘해외’, 해외 주소(쓰는 배송대행지 주소) | 국내 사무실 주소 |
| 국내 위탁 판매·사입 판매 | 국가 구분 ‘국내’, 사무실 또는 실제 출고지 주소 | 국내 사무실 주소 |
🚚 쿠팡 출고지/반품지 등록하기
쿠팡 윙에 접속해 로그인합니다.
판매자정보 > 주소록/배송정보 관리 > 새주소지 등록을 선택합니다.
출고지를 등록합니다. 국가 구분과 주소는 위 "어느 쪽인가요?" 표대로 넣습니다.
제주/도서산간 배송여부는 ‘가능’으로 선택하고 임의의 택배사와 금액을 입력합니다.
반품지를 등록합니다. 실제 상품을 받을 수 있는 국내 사무실 주소를 넣습니다.
💡아직 쓰는 배송대행지가 없으면 아래 해외 주소를 임시로 입력합니다.
국가 : United States
우편번호 : 07072
주소 1 : 55 Triangle Blvd Suite B
주소 2 : Unit A
전화번호 : 5513785503
🔑 쿠팡 API Key 발급받기
쿠팡 윙에 접속해 로그인합니다.
판매자정보 > 추가판매정보 > API Key 발급 받기를 선택합니다.
키 사용 목적은 ‘OPEN API’를 선택하고 약관에 동의한 뒤 [Key 발급받기]를 선택합니다.
이미 발급된 OPEN API 키가 있으면 삭제 또는 수정을 선택해 진행합니다.
⚠️ 다른 프로그램이 그 키를 쓴다면 삭제하지 말고 수정에서 IP만 더합니다(4단계). 키를 지우면 그 키로 연결한 프로그램은 다시 연결해야 합니다.
발급 화면에서 업체 입력 방식은 ‘자체개발’을 선택하고 아래 내용을 입력한 뒤 [확인]을 선택합니다.
업체명: Spresso
URL: https://console.spresso.kr
IP 주소: Spresso 전용 서버 IP. Spresso 사이드바 맨 위 계정 영역을 선택하면 열리는 계정 팝업의 내 IP 옆 복사 아이콘으로 복사합니다(화면 둘러보기).
다른 프로그램도 함께 쓰면 IP를 쉼표(,)로 구분해 더 넣을 수 있습니다.
OPEN API 키가 발급되면 업체코드, Access Key, Secret Key를 복사해 메모합니다.
Spresso에 쿠팡 마켓 계정 추가하기
Spresso에 로그인한 뒤 마켓 관리 > 마켓 계정 관리로 이동합니다.
쿠팡 탭을 선택하고 [마켓 계정 추가]를 선택합니다.
마켓 계정 추가 칸에 아래 항목을 입력합니다.
칸 넣을 값 아이디 쿠팡 아이디 업체 코드 OPEN API 키 발급 화면의 업체코드 쿠팡 API Key OPEN API 키 발급 화면의 Access Key Secret Key OPEN API 키 발급 화면의 Secret Key [API Key 테스트]를 선택합니다.
안 되면: 아래 "자주 보는 메시지"를 봅니다. 키를 막 발급받았다면 아래 💡처럼 시간이 지난 뒤 다시 테스트합니다.
"테스트 성공"이 나오면 (선택) 옵션을 정합니다.
최대 등록 상품 개수: 이 계정에 등록할 최대 상품 수. 비워 두면 목록에 "제한 없음"으로 나옵니다.
자주 사용하는 택배사: 주문 조회에서 송장 택배사를 고를 때 여기서 고른 택배사만 나옵니다.
[변경사항 저장]을 선택합니다.
쿠팡 API Key를 새로 발급받거나 수정하면 쿠팡이 새 키를 확인하는 동안 최소 15분에서 최대 3시간까지 API Key 테스트가 실패할 수 있습니다. 시간이 지난 뒤 다시 테스트합니다.
결과 확인
"변경사항을 저장하였습니다."가 나오고 쿠팡 탭 계정 목록에 쿠팡 아이디가 생기고 연동 상태가 "연결"(초록)이면 끝입니다.
자주 보는 메시지
| 화면 문구 | 뜻과 해결 |
|---|---|
| 계정 확인에 실패했습니다. | 쿠팡이 사유를 알려 주지 않고 거절했습니다. 쿠팡 윙 OPEN API 키의 IP 주소에 내 IP를 넣었는지, 키를 빠짐없이 복사했는지 확인합니다. 키를 막 발급받거나 고쳤으면 시간이 지난 뒤 다시 테스트합니다. |
| Specified key is not registered. 가 들어간 문구, 또는 쿠팡에 등록되지 않은 API 키입니다. 쿠팡 WING에서 API 키를 확인한 뒤 다시 연동해주세요. | 쿠팡이 이 Access Key를 모릅니다. 쿠팡 API Key 칸에 Access Key를 넣었는지 확인합니다. 영어 문구는 테스트 때, 한국어 문구는 연결한 뒤 작업 중에 나옵니다. |
| 현재 IP 주소(…)가 쿠팡 API에서 허용되지 않았습니다. 쿠팡 WING에서 허용 IP를 확인해주세요. | (연결한 뒤 마켓 정책에서 출고지·반품지를 불러올 때) 쿠팡 윙 OPEN API 키의 IP 주소에 내 IP가 없습니다. 4단계처럼 IP를 넣습니다. |
| 쿠팡 API 인증이 만료되었습니다. 쿠팡 WING에서 API 키를 재발급한 뒤 다시 연동해주세요. | (연결한 뒤) 쿠팡 키가 만료되었습니다. 쿠팡 윙에서 키를 다시 발급받고 계정 수정에서 넣은 뒤 다시 테스트합니다. |
중복 계정·계정 한도처럼 모든 마켓에 같은 문구는 마켓 계정 관리에 있습니다.
그래도 안 되면 고객센터에 1:1 문의를 남깁니다. 화면에 나온 문구 그대로, 누른 버튼, 시각, 쿠팡 윙에서 키를 발급하거나 고친 시각을 적습니다. Access Key·Secret Key는 적지 않습니다.
쿠팡에서 지금 되는 것
상품: 등록·수정·품절·삭제가 됩니다.
주문: 주문 가져오기·발주 처리·송장 전송이 됩니다. 송장은 마켓 상태가 배송준비·배송중인 주문만 보냅니다(주문 조회).
문의: 고객 문의·고객센터 문의를 가져와 답변합니다. 쿠팡 고객센터가 넘긴 문의는 [확인처리]만 합니다(문의 조회).
연결한 쿠팡 계정을 지우려면 이 계정으로 등록한 상품을 모두 삭제하고 이 계정을 쓰는 마켓 정책 연결도 풀어야 합니다. 그다음 [계정 삭제]를 선택합니다(마켓 계정 관리).
다음 단계
관련 문서
이 문서로 해결되지 않으면 화면에 나온 문구로 자주 보는 오류 메시지를 찾거나 고객센터에서 1:1 문의를 남깁니다. 모르는 낱말은 용어집에 있습니다.