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, checkouts:read e checkouts:write. Requisições que alteram dados exigem o header HTTP Idempotency-Key (veja Idempotência).

1. Crie o produto

O POST cria a representação inteira: os campos abaixo são todos obrigatórios.
image aceita um data URI base64 (data:image/png;base64,...) ou um caminho já gravado, devolvido como veio. Uma URL externa não é baixada. Leia o arquivo e envie o base64.
Resposta 201 com o produto criado:
Guarde o data.id (aqui, 3257).
O produto nasce com approved: false: ele entra na fila de moderação, como um produto criado pelo painel. A aprovação não passa por esta API.

2. Encontre o checkout do produto

O checkout inicial é criado logo depois do produto, em segundo plano. Liste os checkouts da conta e procure o que aponta para o product_id:
A listagem vem do mais novo para o mais antigo e não aceita filtro por produto. Se o checkout do produto recém-criado ainda não aparecer, ele está sendo criado: repita a chamada em alguns instantes.Guardando o sku, a consulta seguinte fica direta: GET /public/checkouts/by-sku/{sku}.

3. Personalize o checkout

Edite com um PUT. Envie só o que muda: o PUT de checkout faz merge, então o que você não envia continua como está, inclusive os meios de pagamento e os scripts do checkout.
secondary_color não é aceito e derruba a requisição com 422. Os campos de cor são três: primary_color, header_bg_color e header_text_color.
Produto criado e checkout personalizado. Assim que a moderação aprovar o produto, o public_url do checkout recebe vendas.