> ## Documentation Index
> Fetch the complete documentation index at: https://docs.speedsellx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar produto e checkout

> Crie um produto e personalize seu checkout

Ao criar um produto, a SpeedSellX já cria um checkout inicial para ele. O fluxo é: criar o produto, encontrar o checkout e personalizá-lo.

Escopos necessários: `products:write` e `checkouts:write`. Requisições que alteram dados exigem o header HTTP `Idempotency-Key` (veja [Idempotência](/apps/seller/guias/idempotencia)).

## 1. Crie o produto

```bash theme={null}
curl -X POST https://api.speedsellx.io/seller/v1/products \
  -H "Authorization: Bearer $SPEEDSELLX_API_KEY" \
  -H "Idempotency-Key: 6b3a8f2e-2a1b-4c9d-9f1e-7a0c2d4e5f60" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Curso de Vendas",
    "description": "Curso completo de vendas",
    "image": "https://placehold.co/600x400",
    "category_id": 1,
    "language_id": 1,
    "payment_type": "unique",
    "price": 199.9,
    "currency": "brl",
    "type": "digital",
    "delivery": "nothing",
    "warranty_time": 7,
    "publish_status": "published"
  }'
```

Resposta `201` com o produto criado:

```json theme={null}
{
  "data": {
    "id": 3257,
    "name": "Curso de Vendas",
    "description": "Curso completo de vendas",
    "status": "published",
    "type": "digital",
    "payment_type": "unique",
    "price": 199.9,
    "currency": "brl",
    "is_free": false,
    "created_at": "2026-06-05T14:49:52-03:00",
    "updated_at": "2026-06-05T14:49:52-03:00"
  }
}
```

Guarde o `data.id` (aqui, `3257`).

## 2. Encontre o checkout do produto

O checkout inicial já existe. Liste os checkouts filtrando pelo produto:

```bash theme={null}
curl "https://api.speedsellx.io/seller/v1/checkouts?product_id=3257" \
  -H "Authorization: Bearer $SPEEDSELLX_API_KEY"
```

```json theme={null}
{
  "data": [
    {
      "id": 3539,
      "product_id": 3257,
      "name": "Checkout Inicial",
      "template": null,
      "checkout_theme_id": 1,
      "status": "published",
      "branding": { "dark_mode": false, "primary_color": null },
      "created_at": "2026-06-05T14:49:52-03:00",
      "updated_at": "2026-06-05T14:49:52-03:00"
    }
  ],
  "meta": { "current_page": 1, "per_page": 100, "total": 1, "last_page": 1 }
}
```

## 3. Personalize o checkout

Edite com um `PUT`. Os campos são opcionais; envie só o que muda.

```bash theme={null}
curl -X PUT https://api.speedsellx.io/seller/v1/checkouts/3539 \
  -H "Authorization: Bearer $SPEEDSELLX_API_KEY" \
  -H "Idempotency-Key: 9f1e7a0c-2d4e-5f60-6b3a-8f2e2a1b4c9d" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Checkout Principal",
    "primary_color": "#0B6BFF",
    "dark_mode": true
  }'
```

```json theme={null}
{
  "data": {
    "id": 3539,
    "product_id": 3257,
    "name": "Checkout Principal",
    "status": "published",
    "branding": { "dark_mode": true, "primary_color": "#0B6BFF" },
    "updated_at": "2026-06-05T14:50:10-03:00"
  }
}
```

<Check>Produto criado e checkout personalizado. O produto já pode receber vendas.</Check>