PHPackages                             isckosta/laravel-tiktok-shop - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. isckosta/laravel-tiktok-shop

ActiveLibrary[API Development](/categories/api)

isckosta/laravel-tiktok-shop
============================

Laravel integration for TikTok Shop (multi-tenant, webhooks, DTOs, retries).

v0.6.0(9mo ago)121MITPHPPHP ^8.3

Since Sep 9Pushed 9mo agoCompare

[ Source](https://github.com/isckosta/laravel-tiktok-shop)[ Packagist](https://packagist.org/packages/isckosta/laravel-tiktok-shop)[ RSS](/packages/isckosta-laravel-tiktok-shop/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (8)Versions (11)Used By (0)

Laravel TikTok Shop
===================

[](#laravel-tiktok-shop)

Integração robusta e extensível com a **API da TikTok Shop**, construída para aplicações Laravel. Suporta autenticação OAuth, múltiplas lojas (multi-tenant), gerenciamento de produtos, pedidos, preços, estoque e webhooks.

---

🚀 Requisitos
------------

[](#-requisitos)

- PHP **^8.3**
- Laravel **^11 ou ^12**
- Extensão cURL habilitada

---

📦 Instalação
------------

[](#-instalação)

```
composer require isckosta/laravel-tiktok-shop
```

Publique as configurações:

```
php artisan vendor:publish --tag="tiktokshop-config"
```

Publique os migrations:

```
php artisan vendor:publish --tag="tiktokshop-migrations"
```

Opcionalmente, publique os controllers stubs:

```
php artisan vendor:publish --tag="tiktokshop-controllers"
```

Opcionalmente, publique as rotas:

```
php artisan vendor:publish --tag="tiktokshop-routes"
```

---

⚙️ Configuração
---------------

[](#️-configuração)

### 1. Variáveis de ambiente

[](#1-variáveis-de-ambiente)

```
TTSHOP_SERVICE_ID=seu_service_id
TTSHOP_APP_KEY=seu_app_key
TTSHOP_APP_SECRET=seu_app_secret
TTSHOP_REDIRECT_URI=https://seusistema.com/tiktok/callback
TTSHOP_BASE_URI=https://open-api.tiktokglobalshop.com
TTSHOP_AUTH_BASE_URI=https://auth.tiktok-shops.com
```

> As credenciais (App Key e App Secret) são obtidas no painel da TikTok Shop Developer:

---

🔑 Rotas & Fluxo de Autenticação (OAuth)
-------------------------------------------

[](#-rotas--fluxo-de-autenticação-oauth)

O package já registra automaticamente as rotas de autorização e callback se `enable_default_routes = true` (padrão):

```
/tiktok/authorize     -> TikTokShopAuthController@redirect
/tiktok/callback      -> TikTokShopAuthController@callback
/webhooks/tiktok-shop -> TikTokWebhookController@handle
```

Se você **publicar as rotas**, o package vai dar preferência ao arquivo publicado (`routes/tiktokshop.php`) em vez do do package. Se você **desabilitar a flag**, nenhuma rota será registrada e você deve criar manualmente.

### Como personalizar:

[](#como-personalizar)

1. Desabilitar as rotas no `config/tiktokshop.php`:

    ```
    'enable_default_routes' => false,
    ```
2. Publicar os controllers stubs:

    ```
    php artisan vendor:publish --tag="tiktokshop-controllers"
    ```
3. Definir suas próprias rotas em `routes/web.php` ou usar o arquivo publicado:

    ```
    use App\Http\Controllers\TikTokOAuthController;
    use App\Http\Controllers\TikTokWebhookController;

    Route::get('/tiktok/authorize', [TikTokOAuthController::class, 'redirect']);
    Route::get('/tiktok/callback', [TikTokOAuthController::class, 'callback']);
    Route::post('/webhooks/tiktok', [TikTokWebhookController::class, 'handle']);
    ```

---

### Exemplo de Controller OAuth (stub publicado)

[](#exemplo-de-controller-oauth-stub-publicado)

```