> For the complete documentation index, see [llms.txt](https://www.analytics-docs.laplacetec.com/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.analytics-docs.laplacetec.com/guide/startguide/connect/mall/toss-shopping.md).

# 토스쇼핑 연결

라플라스에 토스쇼핑을 연결하는 방법입니다. 토스 파트너스 연동 관리에서 Direct API 키를 발급하며 라플라스 IP를 등록하고, 라플라스에서 토스쇼핑 연결을 마치는 순서를 안내합니다.

이 가이드는 토스쇼핑(Toss Shopping) 데이터를 라플라스에 연동하기 위한 절차를 안내합니다.

## 사전 준비 <a href="#ready" id="ready"></a>

토스쇼핑 데이터를 라플라스에 연동하려면 아래 항목이 필요합니다.

* 토스쇼핑 파트너스 입점 계정 (토스페이 청약까지 완료된 상태)
* 토스쇼핑 파트너스에서 발급한 **Direct API 키**의 Access Key, Secret Key
* Direct API 키에 라플라스 IP(**3.37.139.73**) 등록
* 라플라스 계정

***

## Step 1. 토스 파트너스에서 Direct API 키 발급 <a href="#step1" id="step1"></a>

토스 파트너스에서 라플라스 연결용 **Direct API 키**를 발급받습니다.

1. 토스 파트너스 (<https://shopping-seller.toss.im/>)에 로그인합니다.
2. 왼쪽 메뉴에서 **쇼핑 > 연동 관리**로 이동합니다.
3. **내 연동 키**에서 Direct API 키 발급을 시작합니다. 화면은 이미 발급한 연동 키가 있는지에 따라 달라요.

   * **발급한 키가 없을 때**: **업체 선택**에서 맨 위의 **Direct API**를 고른 뒤 **발급하기**를 클릭합니다.

   ![연동 관리 업체 선택에서 Direct API 선택](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-187ae8b743a417363bfed7140c51ebe7caae91d0%2F4d2a5f5c8b1c.png?alt=media)

   * **사방넷 같은 다른 업체 키가 이미 있을 때**: 키 목록 아래의 **+ Direct API 키 발급**을 클릭합니다.

   ![내 연동 키 목록 아래 Direct API 키 발급](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-7872a21cbda8066f96356234fe126786a2f1eb6b%2Fac387aadb0d8.png?alt=media)

{% hint style="warning" %}
**라플라스 연결에는 반드시 Direct API 키를 사용해 주세요.**

업체 선택 목록의 사방넷, 플레이오토 같은 업체를 고르면 그 통합솔루션 업체가 쓰는 키가 발급돼요. 이미 있는 다른 업체 키를 라플라스에 입력해도 안 돼요.
{% endhint %}

4. **Direct API 키** 창에서 연동할 업체를 아래처럼 등록하고 **완료**를 클릭합니다.

   * **업체명**: 라플라스
   * **IP 주소**: **3.37.139.73**

   업체명 칸 아래의 「'자체 개발' 이라고 입력해주세요」 안내는 직접 개발할 때의 값이에요. 라플라스에 연결할 때는 연동할 업체 이름인 **라플라스**를 입력해 주세요.

   ![Direct API 키 창 업체명·IP 주소 입력](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-12220f6db554eb1e8563ff579ccf97dcb3bb7964%2Faafb4f3178db.png?alt=media)
5. 발급된 **Direct API 키**의 **Access Key, Secret Key**를 확인하고 안전하게 보관합니다.

   ![발급된 Direct API 키의 Access Key·Secret Key](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-a58db73958cec7831d7d4bc594fa7acfc8706ff6%2F593c509510bc.png?alt=media)

> Secret Key는 비밀번호와 같은 역할입니다. 외부 노출되지 않도록 주의하세요.

{% hint style="info" %}
**업체 선택이나 발급하기 버튼이 눌리지 않나요?**

토스페이 청약이 끝나기 전에는 연동 키를 발급할 수 없어요. 청약을 마친 뒤 다시 시도해 주세요.

**이미 발급한 Direct API 키가 있나요?**

연동 관리 화면의 **Direct API 키**에서 **수정**을 눌러 IP 주소에 **3.37.139.73**이 들어 있는지 확인하고, 그 키의 Access Key, Secret Key를 사용해 주세요.
{% endhint %}

***

## Step 2. 라플라스에서 토스쇼핑 연결 <a href="#step2" id="step2"></a>

1. 왼쪽 레일의 **데이터 연결**을 누른 뒤, 탐색 패널의 **커넥터 검색**에 토스쇼핑을 입력하거나 **쇼핑몰 연결** 카테고리에서 **토스쇼핑 연결**을 눌러 주세요.

![토스쇼핑 연결 화면](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-f050b825cd0869b8bd9a464b0a076a5c3251a52f%2Fstartguide__connect__mall__toss-shopping__01.png?alt=media)

{% hint style="info" %}
아직 연결한 계정이 없으면 커넥터 화면에 **연결하면 이런 분석을 할 수 있습니다**가 보여요. **샘플 보기**를 누르면 연결 후 볼 수 있는 화면을 샘플 데이터로 미리 볼 수 있습니다. 화면 아래 **연결 순서**와 **시작 전 준비물**에서 연결 단계와 미리 준비할 것도 확인해 주세요.
{% endhint %}

2. **토스쇼핑 연결** 화면 머리글 오른쪽의 **데이터 연결**을 눌러 연결 창을 열어 주세요. 창 위쪽 **연결 순서**에서 지금 단계를 확인할 수 있어요. **API 키 입력**에 **Access Key, Secret Key** 를 입력한 후 **토스쇼핑 계정연동**을 클릭합니다.

![토스쇼핑 연결 창 Access Key·Secret Key 입력](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-3ec56b6e2b8288e918f544d431ed979e3f51668f%2Fstartguide__connect__mall__toss-shopping__02.png?alt=media)

* 연결한 계정은 커넥터 화면의 연결 표에 보여요. 행 오른쪽 ⋯(**작업 더 보기**)에서 **최신화**와 **인증 갱신**을 할 수 있습니다.

{% hint style="info" %}
**데이터 연동이 왜 오래 걸리나요?**

👉 라플라스에서는 토스쇼핑의 데이터를 가져오기만 하는 것이 아니라 가져온 데이터를 정제하고 차트를 그려주는 작업을 해주기 때문이에요. 소요되는 시간 또한 데이터의 양이 많을수록 오래 걸릴 수도 있어요.

💬 진행 상황은 상단 바 오른쪽 **작업 · 데이터 상태**에서 확인할 수 있고, 연동이 완료되면 이메일로도 알려 드려요. 라플라스를 종료해도 수집은 계속되니 안심하시고 종료하셔도 됩니다.
{% endhint %}

***

## 연결이 되지 않을 때 <a href="#error" id="error"></a>

{% hint style="warning" %}
**연결은 완료됐는데 데이터 수집이 실패해요**

입력한 키가 **Direct API** 키가 아니거나, 키에 라플라스 IP가 등록되지 않았을 수 있어요.

👉 토스 파트너스 **쇼핑 > 연동 관리**에서 입력한 Access Key가 **Direct API 키**의 것인지, 그 키의 IP 주소에 **3.37.139.73**이 들어 있는지 확인해 주세요.

👉 다른 키를 입력했다면 [Step 1](#step1)대로 Direct API 키를 발급한 뒤, 라플라스 **토스쇼핑 연결** 화면 연결 표의 ⋯(**작업 더 보기**) > **인증 갱신**에서 새 Access Key, Secret Key를 입력해 주세요.
{% endhint %}

***

## 전담 매니저에게 요청하기

토스쇼핑 연결에 어려움이 있으신가요?

하단의 문의하기 혹은 홈페이지의 채팅 상담을 통해 문의하세요. 담당 매니저가 도움을 드리도록 하겠습니다.

> 💬 [채팅으로 문의하기](https://laplacetec.channel.io/lounge)
>
> 💬 [홈페이지에서 문의하기](https://www.analytics.laplacetec.com/contact)

**이메일 문의:** [**product@laplacetec.com**](mailto:product@laplacetec.com)
