PIX IN – Produtos Físicos

Este tipo de transação deve ser usado quando você vende produtos que serão entregues fisicamente ao cliente. Para garantir o pagamento e incluir o valor do frete, é preciso enviar, no corpo da requisição:

isInfoProducts: false
Indica que é um produto físico (não digital).

Dados do cliente (customer)

• name: nome completo
• email: e‑mail válido
• phone: número de telefone
• document: objeto com number (CPF/CNPJ) e type (“cpf” ou “cnpj”)

Informações de envio (shipping)

• fee: custo do frete em centavos (use 0 se for frete grátis)
• address: endereço completo para entrega
  • street, streetNumber, neighborhood, city, state, zipCode, country, complement

Itens do pedido (items)
Cada produto deve ter:

• title e description para identificação
• unitPrice em centavos
• quantity de unidades
• tangible: true para itens físicos

Essas informações permitem que o sistema calcule o total (produto + frete) e gere o QR Code correto.

---

Como testar no Swagger

Authorize

• Abra a barra lateral do Swagger e clique em Try it out.
• Insira suas chaves:
  • x-authorization-key: sua chave secreta
  • x-store-key: sua chave pública (opcional)
• Clique em Authorize para ativar o Teste.

Try it Out

• Ajuste o corpo da requisição se necessário e depois clique no botão Execute abaixo.

Verifique a resposta

• Role até Response para ver o JSON retornado.

---

✅ Exemplo de Resposta

   {
     "id": "c4cf1994e-6f62-4761-b051-931cf1997155",
     "orderId": "c4cf1994e-6f62-4761-b051-931cf1997155",
     "status": "pending",
     "isInfoProducts": false,
     "shipping": {
       "fee": 0,
       "address": {
         "street": "Rua",
         "streetNumber": "20",
         "zipCode": "00000000",
         "neighborhood": "Bairro",
         "city": "Cidade",
         "state": "Estado",
         "country": "Brasil",
         "complement": "Complemento"
       }
     },
     "pix": {
       "encodedImage": "data:image/png;base64,(QR Code)",
       "payload": "000201..."
     }
   }