이제 API 호출을 위한 모든 셋팅이 완료되었다면,
카카오쇼핑 API를 통한 판매자의 상품/주문 정보 관리를 위해 연동대행사-판매자 연결을 진행합니다.
다른 API 호출 이전, 아래의 연동대행사와 판매자를 연결하는 아래의 API 호출이 먼저 되어야 합니다.
연결 API 호출 시에도 공통 인증 헤더를 설정하여 호출합니다.
POST /v1/store/register
정상적으로 연결되었다면 아래 경로의 API 인증키가 '판매자 API 인증키(연동대행사 앱 명)’ 으로 노출됩니다.
- 경로 : 카카오쇼핑 판매자센터 > 가입한 판매채널의 [정보관리] > 판매채널 정보 > API 인증키 확인
[정상 응답]
HTTP/1.1 200 OK
FAQ. 연동대행사-판매자 미연결 상태로 다른 API 호출할 경우
연동대행사와 판매자 연결이 선행되지 않은 상태에서 다른 API를 호출할 경우 아래와 같은 에러 메시지가 노출됩니다.
‘대행사 매핑/권한 확인이 필요합니다.’
FAQ. 선물하기 API 권한이 없는 판매자인 경우
선물하기 채널의 데이터를 불러가는 API를 호출하는 경우에는 카카오쇼핑 판매자센터 내에서 API 호출 대상 서비스의 API 호출 권한이 없으면 해당 서비스의 API 호출이 불가합니다.
판매자가 담당 MD 혹은 선물하기 판매자센터의 문의하기를 통하여 API 호출 권한 부여 신청을 선행해주셔야 합니다.
만약 권한을 부여받지 않은 판매자가 API 호출 시, 아래와 같이 에러 메시지가 노출됩니다.
[선물하기]
- 상품 권한이 없는 경우
‘선물하기 상품 권한이 없습니다. 판매자센터 내 1:1 문의를 통해 api 권한을 신청해 주세요.’
- 주문 권한이 없는 경우
‘선물하기 주문 권한이 없습니다. 판매자센터 내 1:1 문의를 통해 api 권한을 신청해 주세요.’
[톡스토어]
- 상품 권한이 없는 경우
‘톡스토어 상품 권한이 없습니다. 판매자센터 내 1:1 문의를 통해 api 권한을 신청해 주세요.’
- 주문 권한이 없는 경우
‘톡스토어 주문 권한이 없습니다. 판매자센터 내 1:1 문의를 통해 api 권한을 신청해 주세요.’
[그 외 기타]
- ‘대행사 매핑/권한 확인이 필요합니다.’
FAQ. 이미 다른 3개 API 대행사에 매핑된 인증키인 경우
만약, 판매자가 다른 연동대행사를 사용하고 있었던 경우 이미 판매자와 연결된 연동대행사가 있을 수 있습니다. 내부 정책상 판매자는 최대 3개의 연동대행사와 연결될 수 있으며, 이미 다른 3개의 연동대행사와 연결된 경우 아래와 같은 에러 메시지가 출력됩니다. 이 경우, 판매자가 직접 카카오쇼핑 고객센터를 통해 연동대행사와의 매핑정보를 삭제 요청하셔야 하며, 매핑정보 삭제 시 기존에 판매자와 연결된 연동대행사 정보가 초기화되므로 매핑이 유지되어야 하는 연동대행사가 있으면 판매자를 다시 연결해 주셔야 합니다.
{
"msg": "KakaoStoreException",
"code": -800,
"extras": {
"error_code": -100007,
"error_message": "대행사는 최대 3개까지 등록할 수 있습니다."
}
}