Como gerar um QR Code Estático via Pix?

O QR Code estático funciona como uma "chave visual". Uma vez gerado, ele não expira após o primeiro pagamento, permitindo que diversos clientes utilizem o mesmo código para enviar valores à sua conta.

🛠️ Parâmetros Necessários

Ao utilizar a API de Criar um QR Code Estático, você deve preencher:

• key: A sua chave Pix cadastrada na Celcoin (CPF/CNPJ, E-mail, Telefone ou Chave Aleatória).

• transactionIdentification (TXID): Opcional. Um código de identificação que será vinculado ao QR Code.

  Atenção: No modelo estático, o Banco Central não garante a unicidade do TXID como ocorre no dinâmico. A gestão de conciliação desses IDs fica a cargo da sua aplicação.

• merchant: Objeto contendo os dados do beneficiário (Nome, Cidade, CEP e o código de categoria MCC).

🔄 Fluxo da Operação

1. Criação do Código: Sua aplicação envia os dados para a Celcoin.

2. Retorno do Payload: A API retorna a string (payload EMV) e a imagem do QR Code.

3. Exibição: Você disponibiliza o código para o pagador.

4. Definição do Valor: * Se você não definiu um valor na criação, o próprio pagador digitará quanto deseja enviar no app do banco dele.

   • Se você definiu um valor, ele aparecerá travado para o pagador (mas ainda assim, o QR Code continuará servindo para múltiplos pagamentos do mesmo valor).

💡 Exemplo de Requisição (JSON)

{
  "key": "suachave@exemplo.com",
  "transactionIdentification": "PDV-LOJA-01",
  "merchant": {
    "name": "Nome da Sua Empresa",
    "city": "Sao Paulo",
    "postalCode": "01001000",
    "merchantCategoryCode": "0000"
  },
  "amount": 0.00 
}

✅ Quando utilizar o QR Code Estático?

• Pontos de Venda (Checkout): Exposto no caixa para que o cliente escaneie e digite o valor da compra.

• Doações e Lives: Um único código exibido na tela para todos os espectadores.

• Recargas e Créditos: Ideal para fluxos onde o usuário escolhe o quanto quer carregar em uma carteira digital.

⚠️ Ponto de Atenção: Conciliação

Como o mesmo QR Code pode ser pago várias vezes, a conciliação automática via transactionIdentification requer mais cuidado do que no modelo dinâmico. Recomendamos o uso de Webhooks para monitorar cada entrada (RECEIVEPIX) e identificar o pagador pelos dados do debtor que retornam na notificação.