쿠팡 API, 스마트스토어 API, 카페24 앱: 우리 회사는 어떤 연동이 가능한가

쇼핑몰 주문을 API로 자동 수집할 수 있는지는 판매처마다 다릅니다. 쿠팡은 판매자가 Wing에서 발급한 키와 개발사 서버의 고정 IP를 등록하면 주문 조회와 송장 전송을 연동할 수 있고, 카페24는 OAuth 앱을 등록해 쇼핑몰 운영자 승인을 받는 방식입니다. 스마트스토어는 외부 업체가 판매자 키를 받아 대신 운영하는 것이 정책상 막혀 있어, 외주로 맡길 때는 엑셀 방식이 현실적입니다.

쇼핑몰 주문은 API로 자동 수집할 수 있나요?

API는 프로그램끼리 데이터를 주고받는 정해진 통로입니다. 사람이 판매자센터에 들어가 엑셀을 내려받는 대신, 프로그램이 일정 시간마다 새 주문을 가져오고 송장번호를 보내는 것이 API 연동입니다.

문제는 "누가 그 통로를 쓰는가"입니다. 각 판매처는 판매자 본인, 승인받은 연동 업체, 외주 개발사를 다르게 취급합니다. 먼저 전체 그림을 보겠습니다.

네이버 커머스API: 판매자 직접 연동과 대행사 차이

네이버 커머스API에는 애플리케이션 유형이 세 가지 있습니다. 판매자가 직접 연동하는 "내스토어 애플리케이션", 솔루션마켓에 입점하는 "커머스솔루션", 신청서 검토 후 발급받는 "API대행사"입니다.

네이버는 공식 답변에서 내스토어 애플리케이션 정보를 "제공 또는 위탁받아 운영하시는 방법으로 서비스를 제공해서는 안 된다"고 밝혔습니다. 제3자가 스토어 운영 기능을 제공하려면 커머스솔루션이나 API대행사로 승인받아야 하고, 같은 답변에 따르면 국내 법인 사업자가 아니면 대행사 신청이 반려될 수 있습니다.

그래서 "개발사에 API 키를 넘기고 주문 수집을 맡긴다"는 계획은 스마트스토어에서는 성립하지 않습니다. 이미 네이버 승인을 받은 통합 주문관리 서비스를 쓰거나, 주문 엑셀을 내려받아 처리하는 방식이 남습니다. 엑셀 방식은 주문 엑셀 합치기 글에 정리했습니다.

쿠팡 Wing API: 키 발급과 고정 IP 등록

쿠팡 개발자 포털의 시작 안내에 따르면 순서는 이렇습니다.

1. Wing에서 Open API 키(Access Key, Secret Key)를 발급받습니다.
2. 연동 방식으로 "자체개발"을 고르면 업체명, URL, API를 호출할 서버 IP를 입력합니다.
3. 등록된 IP에서만 API 호출이 허용되므로 개발사는 주소가 바뀌지 않는 고정 IP 서버를 준비해야 합니다.

연동 업체 도움말에 따르면 키는 유효기간(180일)이 있어 만료 전에 다시 발급받아야 합니다. 이걸 놓치면 어느 날 주문 수집이 멈추므로, 만료 알림을 미리 걸어 두는 것이 운영의 일부입니다.

송장 전송도 API로 됩니다. 쿠팡 송장업로드 API는 주문이 "상품준비중" 상태일 때만 등록되므로, 주문 확인 단계를 먼저 처리하는 흐름이 필요합니다.

한 가지 더 있습니다. API로 주문을 받으면 고객 이름, 연락처, 주소가 개발사 서버를 거칩니다. 이 경우 개인정보 처리 위탁 계약과 보관 기간을 정해야 합니다. 확인할 항목은 개인정보 체크 글에서 다룹니다.

카페24: OAuth 앱과 심사 과정

카페24는 키를 건네받는 방식 대신 OAuth를 씁니다. 개발자센터에 앱을 등록하고, 쇼핑몰 운영자가 "이 앱이 주문을 읽고 쓰는 것을 허락한다"고 승인하면 앱이 접근 토큰을 받습니다.

카페24 OAuth 가이드에 따르면 접근 토큰은 2시간, 갱신 토큰은 2주 동안 유효합니다. 주문 조회에는 mall.read_order, 주문 정보를 바꾸는 작업에는 mall.write_order 권한이 쓰입니다. 앱을 앱스토어에 출시하려면 테스트와 심사를 거치므로, 개발 기간에 심사 기간을 더해 일정을 잡아야 합니다.

통합 주문관리 서비스와 직접 연동 비교

이미 여러 판매처를 묶어 주는 통합 주문관리 서비스가 있습니다. 이들은 각 판매처의 승인 절차를 마친 상태라 스마트스토어까지 한 화면에서 처리됩니다. 월 이용료를 내고, 회사 업무 방식을 서비스 화면에 맞춰야 합니다.

정해진 답은 없고, 판매처별 주문 비중과 회사가 감당할 운영 부담을 보고 고르는 문제입니다.

API 연동을 맡기기 전에 회사가 준비할 것

API 연동은 만든 뒤 계속 돌아가게 관리하는 기간이 훨씬 깁니다. 외주 업체와 이야기하기 전에 아래 항목을 회사 안에서 먼저 정해 두면 견적과 일정이 덜 흔들립니다.

1. 판매처별 주문 비중. 최근 한 달 주문 수를 판매처별로 적습니다. 어느 판매처를 먼저 연결할지 정하는 근거가 됩니다.
2. 키를 발급할 사람. 쿠팡 키나 카페24 앱 승인은 판매자 계정 권한이 있는 사람이 해야 합니다. 대표 계정이라면 대표가 시간을 내야 하는 일정도 잡아 둡니다.
3. 서버를 누가 운영하나. 고정 IP 서버를 회사 명의로 둘지 업체가 운영할지, 월 비용은 누가 내는지 정합니다.
4. 만료와 갱신 담당자. 키 유효기간, 토큰 재승인처럼 날짜가 정해진 일을 누가 챙길지 이름을 적습니다.
5. 개인정보 위탁 범위. 주문 정보가 업체 서버를 거친다면 위탁 계약과 보관 기간을 정합니다.
6. 멈췄을 때 돌아갈 절차. API가 멈춘 날에도 출고는 해야 하므로 엑셀로 처리하는 순서를 문서로 남겨 둡니다.

TIP키를 발급할 때 발급일과 발급한 사람, 등록한 서버 IP를 회사 문서에 적어 둡니다. 업체가 바뀌거나 담당자가 퇴사해도 무엇을 다시 발급하고 어디를 바꿔야 하는지 회사가 알 수 있습니다.

API 연동이 자주 멈추는 곳과 대응

연동이 멈추는 원인이 코드에만 있지는 않습니다. 키 만료나 서버 주소 변경처럼 운영 중에 생기는 원인도 자주 있습니다. 위 공식 문서에 나온 조건을 기준으로 정리하면 이렇습니다.

어느 경우든 "멈춘 것을 언제 알았나"가 피해 크기를 정합니다. 수집 건수가 평소보다 크게 줄면 담당자에게 알림이 가도록 해 두면, 출고 마감 전에 엑셀 방식으로 돌아갈 시간을 벌 수 있습니다.

TIPAPI 연동을 시작해도 첫 2주는 판매자센터 주문 수와 프로그램이 가져온 주문 수를 하루 한 번 비교합니다. 숫자가 맞는 날이 이어지면 비교 주기를 늘립니다.

가상 사례: 판매처별로 방식을 섞은 화장품 쇼핑몰

가상 사례 아래는 이해를 돕기 위해 만든 예시 회사입니다. 실제 고객 사례가 아닙니다.

직원 50명인 화장품 쇼핑몰이 하루 약 600건을 처리합니다. 쿠팡 300건, 스마트스토어 220건, 카페24 자사몰 80건입니다.

1단계: 쿠팡만 API로. 주문의 절반이 쿠팡이라 효과가 가장 큽니다. 대표가 Wing에서 키를 "자체개발"로 발급하고 개발사 서버 IP를 등록합니다. 프로그램이 주기적으로 주문을 가져와 출고 목록에 넣고, 택배사 송장이 나오면 상품준비중 주문에 송장을 보냅니다. 쿠팡 엑셀을 내려받아 옮기고 송장 파일을 올리던 시간이 하루 약 40분이라고 가정하면, 40분 × 22일 = 월 약 15시간이 줄어듭니다. 키 만료 2주 전에 담당자에게 알림이 가도록 설정합니다.

스마트스토어는 엑셀 유지. 외부 업체 대행 운영이 허용되지 않으므로, 담당자가 주문 엑셀을 내려받아 합치기 화면에 넣고, 결과로 나온 송장 파일을 일괄발송으로 올립니다.

2단계: 카페24 앱. 자사몰 비중이 아직 작아 1단계가 안정된 뒤 OAuth 앱을 등록하고 심사를 거쳐 붙입니다. 그 전까지는 카페24도 엑셀로 처리합니다.

이렇게 하면 처음부터 모든 판매처를 API로 묶는 것보다 일정과 비용 부담이 작고, 정책상 막힌 곳을 억지로 연결하지 않아도 됩니다.

우리 회사에 맞는 방식 고르는 표

엑셀 방식을 고른 경우에도 송장까지 이어지는 흐름은 같습니다. 택배 접수 파일과 판매처별 송장 파일을 만드는 과정은 송장 일괄 등록 글에 정리했고, 외주 견적에서 운영 범위를 어떻게 확인하는지는 업무 자동화 외주 견적 읽는 법에서 다룹니다.

엑셀 방식부터 확인해 보기

루코 웍스의 주문 합치기 데모는 스마트스토어·쿠팡·카페24 주문 엑셀을 합쳐 택배 접수 파일과 판매처별 송장 파일을 만듭니다. 파일은 브라우저 안에서만 처리됩니다. 쿠팡과 카페24 API 연동은 회사 상황을 본 뒤 다음 단계로 검토합니다.

판매처별 주문 비중과 지금 쓰는 파일을 알려 주시면 어느 판매처를 API로, 어느 판매처를 엑셀로 처리할지부터 정리해 드립니다.