Pix estatico¶

PixCanvas gera payload Pix estatico no formato BR Code.

from decimal import Decimal

from pixcanvas import create_static_pix

pix = create_static_pix(
    pix_key="fulano@example.com",
    merchant_name="Fulano de Tal",
    merchant_city="Sao Paulo",
    amount=Decimal("10.00"),
    txid="PEDIDO123",
    description="Pedido 123",
)

Campos¶

Parametro	Obrigatorio	Observacao
`pix_key`	Sim	CPF, CNPJ, e-mail, telefone ou EVP
`merchant_name`	Sim	Normalizado para uppercase sem acentos
`merchant_city`	Sim	Normalizado para uppercase sem acentos
`amount`	Nao	`Decimal`, `str` ou `None`; `float` e rejeitado
`txid`	Nao	Default `***`
`description`	Nao	Limitado a 23 caracteres

Normalizacao¶

CPF/CNPJ aceitam pontuacao.
E-mail e EVP viram lowercase.
Telefone brasileiro aceita +55, 55 ou formato local.
Nome e cidade removem acentos e viram uppercase.
description maior que 23 caracteres vira 20 caracteres + ....

Erros comuns¶

Erro	Causa comum
`InvalidPixKeyError`	Chave Pix invalida
`InvalidAmountError`	Valor com `float` ou formato invalido
`FieldTooLongError`	Campo EMV excede limite
`InvalidFieldError`	Campo vazio ou malformado

Core zero-dependencia

create_static_pix nao depende de bibliotecas externas.