EcomDocs
POSTCheckout & Loja

Checkout

Cria um pedido pendente + PaymentIntent para o cliente autenticado. O preço nunca é aceito no item (calculado no servidor).

POST/store/checkout
AutenticaçãoCliente

Cookie de sessão do cliente final (ecom_customer_token).

Corpo da requisição

  • itensarrayobrigatório

    Lista de { productId: uuid, qtd: number }.

Cabeçalhos

  • Cookiestringobrigatório

    Cookie de sessão do cliente: ecom_customer_token=<jwt> (POST /store-auth/login).

Requisição

curl -X POST "https://api.ecomplataforma.com.br/store/checkout" \
  -b customer.txt -H "Content-Type: application/json" \
  -d '{"itens":[{"productId":"p_12","qtd":2}]}'

Resposta201

200 OK
{
  "success": true,
  "data": { "orderId": "o_777", "clientSecret": "pi_..._secret", "publishableKey": "pk_..." }
}

Respostas de erro

401Não autenticado
401 Não autenticado
{
  "success": false,
  "error": "Sessão ausente ou expirada."
}
422Falha de validação
422 Falha de validação
{
  "success": false,
  "error": "O campo 'email' é obrigatório."
}
AnteriorGerar etiquetaPróximoMeus pedidos