Venda pela loja SoftPay em qualquer site

Rotas

Todas respondem JSON. Nos POST, envie Content-Type: application/json. Não há chave secreta nem login.

Pelo navegador, só sites autorizados pelo lojista usam a API daquela loja. Chamadas de servidor (PHP, Node, app) não passam por essa checagem, mas seguem todas as outras regras. Sem plano ativo, a API da loja para em todo lugar.

Mostrar os produtos

curl "https://sdk.softpaybr.com/v1/lojas/nero-forno/produtos?categoria=Pizzas&limite=24"

{
  "produtos": [
    {
      "id": "3f1c…",
      "nome": "Calabresa",
      "preco": 45,
      "imagem": "https://…",
      "variacoes": [{ "id": "g", "nome": "G", "tamanho": "G", "preco": 59, "estoque": null }],
      "adicionais": [{ "id": "borda", "nome": "Borda de catupiry", "preco": 9 }],
      "aceitaMeioAMeio": true
    }
  ],
  "pagina": 1,
  "limite": 24
}

Variação sem preco usa o preço do produto. estoque vem null quando a loja não mostra estoque.

Criar o pedido

POST https://sdk.softpaybr.com/v1/lojas/nero-forno/pedidos
Content-Type: application/json

{
  "chave": "2b0f1d9e-6c1a-4f7e-9b1e-5d7a8c3e4f21",
  "cliente": { "nome": "Ana", "telefone": "11988887777", "cpf": "12345678909" },
  "entrega": {
    "tipo": "entrega",
    "bairro": "Centro",
    "endereco": { "rua": "Rua A", "numero": "10", "complemento": "ap 2" }
  },
  "pagamento": "pix",
  "cupom": "PROMO10",
  "observacao": "Sem cebola",
  "itens": [
    { "produtoId": "3f1c…", "variacaoId": "g", "quantidade": 1, "adicionais": ["borda"], "sabores": ["8a2d…"] }
  ]
}

201 Created
{ "id": "c0de…", "chave": "2b0f1d9e-…", "total": 64, "subtotal": 59, "taxaDeEntrega": 5, "duplicado": false, "itensPulados": [] }

• pagamento: pix, dinheiro, cartao (maquininha na entrega ou retirada) ou outro, só entre as formas que a loja aceita.
• Gere uma chave (UUID) por pedido e guarde. Se a conexão cair, envie de novo com a mesma chave: a loja devolve o pedido já criado, sem duplicar. A chave também autoriza o Pix e a consulta de pagamento.
• O servidor recalcula preço, adicionais, meio a meio, promoção, frete e cupom. O total da resposta é o que o cliente paga.
• O site segue a configuração do catálogo da loja: formas de pagamento, entrega ou retirada, pedido mínimo, bairros atendidos, horário e tamanhos pausados.

Cobrar no Pix

Quando pagamento.pixAutomatico vem true nos dados da loja, o Pix é confirmado sozinho:

POST /lojas/nero-forno/pedidos/{id}/pix        { "chave": "2b0f1d9e-…" }
→ { "jaPago": false, "copiaECola": "000201…", "segundosRestantes": 598, "valor": 64 }

POST /lojas/nero-forno/pedidos/{id}/pagamento  { "chave": "2b0f1d9e-…" }
→ { "status": "pendente" }   …   { "status": "pago" }

Desenhe o QR Code no navegador a partir do copiaECola e consulte o status a cada 3 segundos. Sem Pix automático, mostre pagamento.chavePix ou combine com a loja.

Atalho em JavaScript

<script src="https://sdk.softpaybr.com/v1.js"></script>
<script type="module">
  const loja = SoftPayLoja.conectar('nero-forno');

  const produtos = await loja.produtos({ categoria: 'Pizzas' });
  const pedido = await loja.criarPedido({ cliente, entrega, pagamento: 'pix', itens });
  const pix = await loja.gerarPix(pedido);
  await SoftPayLoja.desenharQrCode('#qr', pix.copiaECola);
  loja.acompanharPagamento(pedido, { aoPagar: () => mostrarConfirmacao() });
</script>

O SDK gera a chave, reenvia com segurança e acompanha o Pix. SoftPayLoja.precoDoItem(produto, escolha, info) mostra o preço antes do pedido, pela mesma regra da loja.

Erros

Todo erro vem como { "erro": { "codigo": "…", "mensagem": "…" } }. A mensagem já está em português, pronta para o cliente.

A lista completa de códigos, com o que o site deve fazer em cada um, está no prompt mestre.

Limites

• Até 48 produtos por página.
• 8 pedidos e 10 cobranças Pix a cada 2 minutos por conexão, por loja.
• 3 pedidos a cada 2 minutos por navegador e 120 pedidos por hora por loja.
• Cartão é na maquininha, na entrega ou na retirada. Não há cobrança de cartão online.