> For the complete documentation index, see [llms.txt](https://docs.linkolis.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.linkolis.com/apps-and-integrations/rakuten.md).

# Rakuten

Follow the steps below to connect your Rakuten seller account to Linkolis and automatically import your orders.

***

### Prerequisites

Before you start, make sure you have:

* An active **Rakuten seller account**
* Access to the **Rakuten Merchant Center** ([fr.shopping.rakuten.com/connect](https://fr.shopping.rakuten.com/connect?action=login))

***

### Step 1 — Retrieve your Rakuten Token API

<figure><img src="https://1959206534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1nBUT3FgZSGH9OiTslZp%2Fuploads%2FWTHRzu3pDVlq9M1RXiNR%2FDesign%20sans%20titre%20(6).png?alt=media&amp;token=2a46ebbf-69ec-4b5f-8f70-a40454c949cf" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1959206534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1nBUT3FgZSGH9OiTslZp%2Fuploads%2FPIdaElBcXo38ZB3lqfR2%2FDesign%20sans%20titre%20(7).png?alt=media&amp;token=fe2860d8-1acb-47f5-b771-dbc99c650ba3" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://1959206534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1nBUT3FgZSGH9OiTslZp%2Fuploads%2FFypd3IiauMMGYleelLzc%2FDesign%20sans%20titre%20(8).png?alt=media&amp;token=d9e157fd-e84a-4ceb-b897-813682debc6c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1959206534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1nBUT3FgZSGH9OiTslZp%2Fuploads%2F9DPvCtniDrO5ocClMWgx%2FDesign%20sans%20titre%20(9).png?alt=media&amp;token=84f45e6e-c0a3-4523-ad77-d6f5f2b2b6ed" alt=""><figcaption></figcaption></figure>

Linkolis authenticates with Rakuten using a **Token API** — a unique key tied to your seller account. You never share your password with a third-party tool; the token is used instead.

1. Log in to the **Rakuten Merchant Center** at [fr.shopping.rakuten.com/connect](https://fr.shopping.rakuten.com/connect?action=login)
   * Enter your **Login** and **Token API** (not your password — click **Get your Token API** if you don't have one yet)
2. Once logged in, click your account name in the top-right corner and go to **Analytics → API & webservices**
3. Scroll down to the **Mes informations développeur** section
4. Click **Générer un token**
5. A confirmation banner will appear: *"Votre token de connexion a bien été généré et peut être communiqué à votre partenaire."*
6. Copy the **Token** value displayed (e.g. `73098936d24152ebc4acd233f93128a`)

> **Note:** The token can be shared safely with third-party partners like Linkolis. You should never share your Rakuten password with any external service.

***

### Step 2 — Find your Rakuten Seller ID

<figure><img src="https://1959206534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1nBUT3FgZSGH9OiTslZp%2Fuploads%2F4xlq6X2EQvvK2yUOhT4j%2FDesign%20sans%20titre%20(10).png?alt=media&amp;token=00304828-67bd-49a2-9fb5-d8d1e4272e28" alt="" width="375"><figcaption></figcaption></figure>

Your **Seller ID** is the name of your shop on Rakuten, as it appears in the top-right corner of the Merchant Center (e.g. "WorldGlobal"). Use this exact shop name in the Linkolis form.

***

### Step 3 — Open the Apps section in Linkolis

<figure><img src="https://1959206534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1nBUT3FgZSGH9OiTslZp%2Fuploads%2FpQxDeEvtK9UlJK8t2lzG%2FDesign%20sans%20titre.png?alt=media&amp;token=a382c9ff-1bbc-44f1-ba6c-3b1c3ee12ffb" alt=""><figcaption></figcaption></figure>

From the left sidebar, click **Apps**. You will land on the **My Applications** page.

***

### Step 4 — Open the application catalogue

Click the **+** button in the top-right corner to open the **All Applications** catalogue.

***

### Step 5 — Install the Rakuten app

<figure><img src="https://1959206534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1nBUT3FgZSGH9OiTslZp%2Fuploads%2FQJApWSaIPbDJEZgUjFEz%2Fimage.png?alt=media&amp;token=7096eeab-cec7-4b1c-ac68-f8df5895fdb7" alt="" width="206"><figcaption></figcaption></figure>

Find **Rakuten** in the catalogue and click **Install**. A configuration panel will slide open on the right side of the screen.

***

### Step 6 — Fill in the installation form

| Field                            | Description                                                                                                       |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| **Application name**             | A display label for this integration. Defaults to "Rakuten".                                                      |
| **Your Rakuten Seller ID**       | The name of your Rakuten shop, as displayed in the top-right corner of your Merchant Center (e.g. "WorldGlobal"). |
| **Rakuten token**                | The Token API generated in Step 1 from your Merchant Center developer settings.                                   |
| **Synchronization stock update** | When checked, Linkolis will automatically push stock level updates to your Rakuten listings.                      |

Once all fields are filled in, click **Confirm**.

***

### Step 7 — Verify the connection

The Rakuten app will appear in your **My Applications** list. Click the wrench icon to open the configuration panel. A blue **"Module installed correctly"** banner at the top confirms the integration is active.

***

### What happens next?

Once connected, Linkolis will automatically:

* **Import new orders** from your Rakuten store
* **Update stock levels** on Rakuten in real time (if synchronization stock update is enabled)

You can edit or delete the integration at any time from the **My Applications** page using the wrench (edit) or trash (delete) icon.

***

### Troubleshooting

**I don't have a Token API yet** On the Rakuten Merchant Center login page, click **Get your Token API**. You will be redirected to [fr.shopping.rakuten.com/usersecure?action=usrwstokenaccess](https://fr.shopping.rakuten.com/usersecure?action=usrwstokenaccess) to generate one.

**"Module installed correctly" banner does not appear** Double-check that your Seller ID matches exactly the shop name shown in the Merchant Center, and that the token was copied in full without extra spaces. Regenerate the token from **Analytics → API & webservices** if needed, then update it in Linkolis via the wrench icon.

**Stock is not updating on Rakuten** Verify that the **Synchronization stock update** checkbox is enabled in the configuration panel. Stock sync is opt-in and disabled by default.