Pagamento via Pix
Gera as instruções de pagamento via Pix para um pedido existente: QR Code (imagem base64) e código EMV (copia-e-cola).
Exiba um cronômetro de expiração
Na página de sucesso, mostre o QR Code, o copia-e-cola e um cronômetro
com o tempo restante até pix_expiration_date. Calcule a contagem
regressiva dinamicamente a partir desse campo — não fixe um tempo
de expiração no seu código, pois esse valor pode variar.
Vencimento personalizado
Por padrão, o vencimento do Pix vem da configuração da loja. Para
definir um vencimento por transação, envie
payment_data.pix.expiration_date no formato Y-m-d H:i:s, no fuso
de Brasília (America/Sao_Paulo) e com data futura.
O campo é opcional: se não for enviado, o vencimento continua vindo da configuração da loja, sem nenhuma mudança de comportamento.
Testando no sandbox
No sandbox o Pix é aprovado automaticamente cerca de 5 segundos
depois de gerado. O cenário depende do document_number:
document_number |
Resultado no sandbox |
|---|---|
Qualquer CPF ou CNPJ válido (ex.: 19100000000) |
Aprovado em ~5 s e depois integrado |
CPF 40827365144 ou CNPJ 40827365000109 |
Fica pendente (o pagamento não é confirmado) |
Os dois cenários estão prontos no Corpo da Requisição, nas abas Sandbox: aprovado e Sandbox: pendente. Webhooks recebidos em cada um: Testar no sandbox.
Autorizações
Token Bearer do merchant obtido via POST /oauth2/token usando as
credenciais do merchant (não do app). Veja
Autenticação.
Corpo da Requisição
Respostas
Instruções Pix retornadas. Os campos pix_qrcode (PNG em base64,
sem prefixo data:), pix_emv (BR Code copia-e-cola) e
pix_expiration_date (data/hora de expiração do Pix, formato
Y-m-d H:i:s) vivem em data.payment. Exiba o QR Code e o
copia-e-cola ao cliente.