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