Skip to main content
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).

​
1. Crie o produto

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: 
{
  "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: 
curl "https://api.speedsellx.io/seller/v1/checkouts?product_id=3257" \
  -H "Authorization: Bearer $SPEEDSELLX_API_KEY"

{
  "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. 
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
  }'

{
  "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"
  }
}
Produto criado e checkout personalizado. O produto já pode receber vendas.