# Venda itens sob medida na sua própria página

> Se você criou uma página própria em que os clientes montam um produto e veem o preço na hora, ela pode adicionar esse item exato ao seu carrinho do Shoprocket. Seu servidor assina o item com uma chave de assinatura, para que ninguém consiga alterar o preço no navegador.

Central de Ajuda / Integrações - Atualizado em 12 de novembro de 2026

Alguns produtos têm o preço definido pelas escolhas do cliente. Uma prateleira sob medida custa mais quando é mais comprida, e o preço de uma pérgola depende do tamanho e da madeira usada. Muitos vendedores hoje criam uma página própria para isso, muitas vezes com um criador de sites com IA: o cliente mexe em alguns controles deslizantes e vê o preço mudar.

Essa página pode adicionar o projeto pronto ao seu carrinho do Shoprocket. Depois o cliente finaliza a compra normalmente, com seus outros produtos no mesmo carrinho, e o pedido, os e-mails e a fatura mostram todas as escolhas dele.

**O preço é assinado, então os clientes não conseguem alterá-lo.** Um preço que uma página da web envia por conta própria poderia ser editado por qualquer pessoa no navegador. Em vez disso, o seu próprio servidor calcula o preço e o assina com uma chave secreta. O Shoprocket confere a assinatura antes de o item entrar no carrinho e o recusa se algo tiver sido alterado.

Isso exige um desenvolvedor, ou um criador com IA que consiga executar código em um servidor, porque a assinatura precisa acontecer em um servidor e não na página da web.

## Antes de começar

As chaves de assinatura ficam na tela **Chaves de API**, que faz parte do app **Ferramentas para desenvolvedores**. Se você não vê **Chaves de API** em **Configurações** na barra lateral, vá em **Apps**, encontre **Ferramentas para desenvolvedores** em **Desenvolvedores** e clique em **Adicionar**. Veja [Adicionar e remover apps](https://shoprocket.io/pt/ajuda/adicionar-e-remover-apps.md).

Você também precisa de um produto no catálogo ao qual o item pertença, como "Prateleira sob medida". O item usa a configuração de impostos e as opções de entrega desse produto, e também a imagem, a menos que o seu servidor envie uma própria. Se você não quer que os clientes comprem o produto sozinho pelo preço listado, defina-o como **Consultar** (veja [Receba pedidos de orçamento e consultas](https://shoprocket.io/pt/ajuda/orcamentos-e-consultas.md)). Os clientes ainda poderão comprar um item assinado desse produto.

## Criar uma chave de assinatura

1. No seu painel, vá em **Configurações > Chaves de API**.
2. No cartão **Chaves de assinatura**, clique em **Criar chave de assinatura**.
3. Copie o **ID da chave** e o **Segredo** e clique em **Já salvei**.

![O cartão Chaves de assinatura com o ID da chave e o segredo de uma chave nova, e os botões Copiar](https://shoprocket.io/img/help/sell-custom-priced-items/signing-key.webp)

O segredo é mostrado só desta vez. Guarde-o no seu servidor, onde o código da sua página possa lê-lo, e nunca o coloque na própria página da web.

## Adicionar um item assinado ao carrinho

Seu servidor monta uma descrição curta do item e a assina. Depois sua página passa o resultado para o carrinho. A descrição inclui:

- a qual produto o item pertence e o preço de uma unidade, na moeda da sua loja
- um nome para o carrinho, como "Prateleira, 120 cm, carvalho"
- as escolhas do cliente, em uma lista de rótulos e valores, como "Comprimento: 120 cm"
- o peso de uma unidade, se você cobra o frete por peso
- uma imagem do design, se ela já estiver online, como um endereço da web que começa com https://
- durante quanto tempo o preço é válido, até 30 dias a partir de agora

Um desenvolvedor encontra o formato exato e um exemplo para copiar em [Itens assinados do carrinho](https://shoprocket.io/docs/signed-items.md). Sua página então adiciona o item com uma única linha, e o carrinho abre como acontece com qualquer outro produto:

```js
Shoprocket.cart.add({ signed: signedItemFromYourServer, quantity: 1 });
```

O cliente pode mudar a quantidade no carrinho, mas nunca o preço. Dois projetos diferentes ficam como dois itens separados.

## O que o seu cliente vê

O item aparece no carrinho com o nome que você deu, com a sua imagem e, embaixo, cada uma das escolhas do cliente. A imagem é a que o seu servidor enviou ou, se ele não enviou nenhuma, a do próprio produto. Depois do checkout, as mesmas escolhas aparecem no pedido no seu painel, no e-mail de confirmação do pedido e na fatura.

Para mostrar a cada cliente o seu próprio design, a sua página pode salvar uma imagem dele e enviá-la ao carrinho logo antes de adicionar o item:

```js
const { token } = await Shoprocket.cart.uploadFile(snapshot);
Shoprocket.cart.add({ signed: signedItemFromYourServer, image: token, quantity: 1 });
```

O Shoprocket guarda uma cópia própria da imagem, então você não precisa armazená-la em lugar nenhum. Se o cliente nunca finalizar a compra, a imagem é excluída junto com o carrinho dele. Uma imagem que o seu servidor envia como endereço da web também é copiada, quando o pedido é feito. Nos dois casos, o pedido e seus e-mails continuam mostrando a imagem, mesmo que o arquivo original seja excluído depois.

Códigos de desconto e descontos automáticos funcionam em itens assinados como em qualquer outro produto. O preço nunca é alterado pelo preço promocional do produto nem pelos descontos por quantidade, porque o preço que o seu servidor assinou é o preço.

Se você cobra o frete por peso, vale o peso que o seu servidor assinou. Caso contrário, valem as configurações de frete do próprio produto.

## Manter um preço durante um período fixo

Cada artigo assinado indica durante quanto tempo o seu preço é válido, para que possa cumprir um orçamento durante um período fixo. Por exemplo, se orçar uma pérgola em 1.000 e se comprometer a manter esse preço durante 14 dias, o seu servidor assina o artigo com uma expiração daqui a 14 dias. Pode manter um preço até 30 dias.

O seu cliente vê "Preço garantido até" e a data por baixo do artigo no carrinho. Até essa data, pode pagar a esse preço.

Depois da data, já não pode comprar o artigo a esse preço, mesmo que ainda esteja no carrinho. Quando tenta pagar, o carrinho mostra "Este preço expirou. Calcule o preço novamente." por baixo do artigo, com um botão para o remover. Pode então voltar à sua página e obter um novo preço.

Se um cliente já fez a encomenda, ou aprovou um pagamento PayPal, antes de o preço expirar, nada o impede. A encomenda é concluída ao preço que assinou.

## Substituir ou revogar uma chave

- **Substitua uma chave** quando um desenvolvedor sair ou você achar que o segredo vazou. Clique em **Substituir chave**. A chave antiga continua funcionando por 7 dias, então a sua página segue no ar enquanto você atualiza o servidor com o novo segredo. A chave antiga mostra a data em que deixa de funcionar.
- **Revogue uma chave** para pará-la imediatamente. Clique em **Revogar** e confirme. Nada que ela assinou poderá ser adicionado a um carrinho, e os itens que já estiverem no carrinho de um cliente serão recusados no checkout.

## Relacionados

- [Criar uma chave de API](https://shoprocket.io/pt/ajuda/criar-uma-chave-de-api.md)
- [Incorpore o Shoprocket em qualquer site](https://shoprocket.io/pt/ajuda/embed-em-qualquer-site.md)
- [Extras e personalização](https://shoprocket.io/pt/ajuda/extras-e-personalizacao.md)

[Abrir as chaves de API no seu painel](https://app.shoprocket.io/go/settings/api-keys)

---

- HTML version: https://shoprocket.io/pt/ajuda/vender-itens-sob-medida-na-sua-propria-pagina
- Language: Português (pt)
- Also in: [العربية](https://shoprocket.io/ar/help/sell-custom-priced-items.md), [Deutsch](https://shoprocket.io/de/hilfe/eigene-seite-massgefertigte-artikel-verkaufen.md), [Ελληνικά](https://shoprocket.io/el/help/sell-custom-priced-items.md), [English](https://shoprocket.io/help/sell-custom-priced-items.md), [Español](https://shoprocket.io/es/ayuda/vender-articulos-a-medida-desde-tu-propia-pagina.md), [Français](https://shoprocket.io/fr/aide/vendre-articles-sur-mesure-depuis-votre-page.md), [עברית](https://shoprocket.io/he/help/sell-custom-priced-items.md), [हिन्दी](https://shoprocket.io/hi/help/sell-custom-priced-items.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/jual-barang-pesanan-khusus-dari-halaman-anda-sendiri.md), [Italiano](https://shoprocket.io/it/aiuto/vendere-articoli-su-misura-dalla-tua-pagina.md), [日本語](https://shoprocket.io/ja/help/sell-custom-priced-items.md), [Lietuvių](https://shoprocket.io/lt/pagalba/parduokite-pagal-uzsakyma-pagamintas-prekes-is-savo-puslapio.md), [Norsk](https://shoprocket.io/nb/hjelp/selge-skreddersydde-varer-fra-din-egen-side.md), [Nederlands](https://shoprocket.io/nl/hulp/maatwerk-artikelen-verkopen-vanaf-je-eigen-pagina.md), [Polski](https://shoprocket.io/pl/pomoc/sprzedawaj-produkty-na-miare-z-wlasnej-strony.md), [Română](https://shoprocket.io/ro/ajutor/vinde-articole-la-comanda-din-propria-pagina.md), [Русский](https://shoprocket.io/ru/help/sell-custom-priced-items.md), [ไทย](https://shoprocket.io/th/help/sell-custom-priced-items.md), [Türkçe](https://shoprocket.io/tr/yardim/kendi-sayfanizdan-ozel-uretim-urunler-satin.md), [中文](https://shoprocket.io/zh/help/sell-custom-priced-items.md)
