> **API Pix do PixMate | A cobrança sai do seu sistema, o QR aparece no terminal** > API Pix para ERPs e sistemas: uma chamada cria a cobrança e o QR Code aparece no terminal do atendimento. Webhook na confirmação do banco, OAuth2 e sandbox. > Página: https://pixmate.com.br/api-pix/ · Empresa: Atenza Sistemas de Informação Ltda. (CNPJ 13.338.544/0001-00) # A cobrança sai do seu sistema e o QR aparece no terminal O PixMate opera de forma autônoma: o terminal cobra e o painel registra tudo, sem exigir nenhuma integração. Quando já existe um sistema — um ERP, uma agenda, um software de gestão —, uma chamada cria a cobrança e o **QR Code aparece no terminal do atendimento**, sem digitação do valor. Quando o banco confirma o pagamento, o seu sistema é notificado. O PixMate não retém percentual sobre o que você recebe. Eventuais tarifas de Pix são as do seu [próprio banco](https://pixmate.com.br/#integracoes). O uso do terminal e do sistema é contratado por plano — fale com vendas. ## O valor vai do sistema para o terminal, sem digitação Quando a ordem de serviço, a comanda ou a consulta já foi emitida no sistema, a redigitação do valor no teclado é desnecessária — e é nela que se originam o erro de digitação e a divergência no fechamento. ### Uma chamada exibe o QR no terminal O seu sistema informa o terminal e o valor. O QR Code aparece na tela do atendimento imediatamente, e o cliente também pode pagar por aproximação. Não é necessário renderizar o QR Code no seu sistema nem imprimi-lo. ### A confirmação vem do banco A baixa no seu sistema não depende do comprovante apresentado pelo cliente: assim que o valor entra na conta, o PixMate aciona o seu webhook. O evento traz o `txid` e o terminal em que a cobrança foi paga. ### Sem intermediário no recebimento A cobrança é criada na conta bancária do estabelecimento, com as credenciais dele. O PixMate não é intermediário financeiro: integrar o seu sistema não coloca ninguém entre a venda e a conta que recebe. ### Padrão de mercado Autenticação OAuth2 (`client_credentials`) e cobranças no vocabulário do Banco Central: `txid`, `status`, `valor`, `pixCopiaECola`. Quem já integrou o Pix de um banco reconhece os campos. ### Ambiente de testes no terminal real No ambiente de testes o QR Code aparece no terminal real e o pagamento é simulado por uma chamada — o seu webhook é acionado como em produção. É possível fechar o ciclo completo sem movimentação de dinheiro real. ### Vários terminais, um sistema A cobrança nomeia o terminal em que deve aparecer. Uma rede com várias recepções, caixas ou salas usa a mesma credencial e escolhe, a cada chamada, em qual tela o QR Code surge. ## Do pedido no sistema à baixa automática ### O seu sistema autentica As credenciais são criadas pelo estabelecimento no painel, em **API / Integradores**, e trocadas por um token de acesso. ### Cria a cobrança Uma chamada com o terminal e o valor. A resposta traz o `txid`, e o QR Code já está na tela do terminal quando ela chega. ### O cliente paga Aproxima o celular do terminal ou lê o QR Code. O app do banco abre com o valor preenchido. ### O banco confirma e o seu sistema recebe O terminal anuncia o pagamento e o PixMate aciona o seu webhook com o `txid`. A baixa ocorre sem conferência de comprovante. ## As requisições e o webhook O manual completo da integração, com todos os campos, códigos de erro e o passo a passo do sandbox, é enviado pela nossa equipe junto com as credenciais. Autenticar, cobrar e receber a confirmação `# 1. Token de acesso (OAuth2 client_credentials) curl -X POST https://pixmate.com.br/api/pix/oauth/token \ -u "$CLIENT_ID:$CLIENT_SECRET" \ -d '{"grant_type":"client_credentials"}' # 2. Cria a cobranca no terminal. external_id e a SUA referencia (n. do pedido) curl -X POST https://pixmate.com.br/api/pix/v1/cob \ -H "Authorization: Bearer $TOKEN" \ -d '{"device":"38240718750005","valor":"29.90","external_id":"PEDIDO-4821"}' # → o QR JA esta na tela do terminal quando esta resposta chega { "txid": "a644ba667ee0cf2c7d91d15aee10f6fd", "status": "ATIVA", "valor": { "original": "29.90" }, "pixCopiaECola": "00020126440014br.gov.bcb.pix...", "device": "38240718750005", "external_id": "PEDIDO-4821" } # 3. O banco confirma o pagamento → o PixMate chama o SEU webhook # com a SUA referencia de volta — a baixa e no pedido certo, sem adivinhar POST https://seu-sistema.com.br/webhooks/pixmate { "tipo": "pix.recebido", "txid": "a644ba667ee0cf2c7d91d15aee10f6fd", "device": "38240718750005", "external_id": "PEDIDO-4821", "pix": [ { "valor": "29.90", "horario": "2026-07-11T02:14:47Z" } ] }` Quando o próprio sistema já é o balcão, em vez de um valor avulso ele monta o **carrinho** e o envia ao terminal. O operador conclui a venda no aparelho — em Pix ou em dinheiro, com troco — e a ficha é impressa como em uma venda comum. Carrinho pronto: o seu sistema monta, o terminal recebe `# Envia o carrinho para um terminal (p = preco em centavos, q = quantidade) # external_id amarra a venda ao seu pedido, do mesmo jeito da cobranca avulsa curl -X POST https://pixmate.com.br/api/pix/v1/pos/sales \ -H "Authorization: Bearer $TOKEN" \ -d '{"device":"38240718750005","external_id":"VENDA-77","items":[{"p":1000,"q":2},{"p":1200,"q":1}]}' # → o carrinho aparece no terminal, no total; o operador escolhe Pix ou dinheiro { "status": "sent", "device": "38240718750005", "items": 3, "external_id": "VENDA-77" }` O preço de cada item (em centavos) é a **chave do item** no cardápio do PixMate. O sistema consulta os valores válidos — assim como os terminais e as contas de recebimento — por três chamadas de leitura, sem depender do painel. Descoberta: contas, terminais e cardápio `# Contas de recebimento da organizacao (o id vai no campo "conta" da cobranca) curl https://pixmate.com.br/api/pix/v1/accounts -H "Authorization: Bearer $TOKEN" # → [{ "id": "...", "label": "EFI Bank", "provider": "efibank", "active": true },...] # Terminais da organizacao (o "device" das cobrancas e vendas) curl https://pixmate.com.br/api/pix/v1/devices -H "Authorization: Bearer $TOKEN" # → [{ "device": "38240718750005", "name": "Recepcao", "online": true, "pos_enabled": true },...] # Cardapio do PDV (o "price_cents" e a chave que vai em "p") curl https://pixmate.com.br/api/pix/v1/catalog -H "Authorization: Bearer $TOKEN" # → [{ "price_cents": 1000, "valor": "10.00", "label": "Agua/Refrigerante", "print_group": "copa" },...]` Referência dos endpoints — base `https://pixmate.com.br/api/pix`. Todas as chamadas, exceto o token, levam o cabeçalho `Authorization: Bearer`. Método Endpoint O que faz POST /oauth/token Troca **client_id / client_secret** por um token de acesso (OAuth2 `client_credentials`, validade de 24 h). GET /v1/accounts Lista as **contas de recebimento** da organização (para o campo `conta`). Sem credenciais. GET /v1/devices Lista os **terminais** (para o campo `device`), com o status `online`. GET /v1/catalog Lista o **cardápio** do PDV; o `price_cents` é a chave que vai em `p`. POST /v1/cob Cria a **cobrança** e exibe o QR no terminal. Campos: `device`, `valor`, e os opcionais `external_id`, `descricao`, `conta`, `webhook_url`. GET /v1/cob/{txid} Consulta o **status** da cobrança (`ATIVA` ou `CONCLUIDA`). POST /v1/pos/sales Envia um **carrinho de PDV** ao terminal (`items` de `{p,q}` + `external_id`); o operador conclui a venda no aparelho. GET /v1/transactions Lista os **recebimentos** (Pix e dinheiro). Filtra por `external_id` para localizar a venda que você iniciou. PUT /v1/webhook Registra a **URL de webhook** padrão da credencial (também pode ir por cobrança, em `webhook_url`). POST /v1/cob/{txid}/simular-pagamento No **sandbox**: dispara o pagamento e aciona o webhook, como em produção. O evento de webhook `pix.recebido` e a consulta `/v1/transactions` devolvem o seu `external_id`, então a conciliação é sempre pela sua própria referência — nunca pelo nosso identificador. ## Perguntas frequentes ### Preciso integrar para usar o PixMate? Não. O terminal cobra e o painel registra tudo o que entrou, sem nenhuma integração — é assim que a maior parte dos estabelecimentos usa. A API existe para quem já tem um sistema e não quer redigitar o valor no terminal. ### O QR Code aparece onde? Na tela do terminal do atendimento, que é escolhido a cada cobrança pelo número de série. O seu sistema não precisa renderizar nem imprimir o QR Code: quando a resposta da chamada chega, ele já está na tela para o cliente. O `pixCopiaECola` é devolvido apenas para registro do seu lado. ### Como o meu sistema sabe que o cliente pagou? Pelo webhook. Quando o banco confirma que o valor entrou na conta, o PixMate chama a URL do seu sistema com o `txid` e o terminal. Não é preciso ficar consultando o status, embora a consulta exista. O mesmo `txid` pode ser notificado mais de uma vez, então trate a baixa de forma idempotente. ### Consigo saber qual pedido foi pago? Sim. Você envia um `external_id` — o número do seu pedido ou da sua guia — ao criar a cobrança ou a venda de PDV, e o PixMate o devolve no webhook e na consulta de recebimentos. A baixa é sempre no pedido certo, sem precisar casar por valor e horário. A consulta `/v1/transactions` ainda aceita filtrar por esse `external_id`. ### Existe ambiente de testes? Sim, e ele chega ao terminal: no sandbox o QR Code aparece na tela de verdade e o pagamento é disparado por uma chamada de simulação, que aciona o seu webhook como em produção. Nenhum dinheiro é movimentado, e o QR do sandbox não é pagável. ### A integração muda quem recebe o dinheiro? Não. A cobrança continua sendo criada na conta bancária do estabelecimento, com as credenciais dele, e o valor é creditado direto lá. O PixMate não é intermediário financeiro, com ou sem integração. ### Como obtenho as credenciais? O próprio estabelecimento cria a credencial no painel, em API / Integradores, e escolhe o ambiente (sandbox ou produção). O `client_secret` aparece uma única vez, na criação. O manual completo da integração acompanha as credenciais. ## Integre o seu sistema ao PixMate Informe qual sistema você usa ou desenvolve e como o atendimento cobra hoje. A nossa equipe responde com o manual da integração e as credenciais de sandbox. - Atendimento direto com quem constrói a API - Credenciais de sandbox para testar antes de decidir - Manual com todos os campos, erros e exemplos PixMate © 2026 | Terminal de pagamento Pix | [pixmate.com.br](https://pixmate.com.br/) Atenza Sistemas de Informação Ltda. · CNPJ 13.338.544/0001-00 Tecnologia com pedido de patente de invenção depositado no INPI · BR 10 2026 017576-5 [Pix para profissionais liberais](https://pixmate.com.br/pix-para-autonomos/) · [Pix para clínicas e consultórios](https://pixmate.com.br/pix-para-clinicas/) · [Pix para entidades e associações](https://pixmate.com.br/pix-para-entidades/) · [Pix para cartórios](https://pixmate.com.br/pix-para-cartorios/) · [Pix para atrativos turísticos](https://pixmate.com.br/pix-para-atrativos/) · [Pix para eventos e festas](https://pixmate.com.br/pix-para-eventos/) [API para o seu sistema](https://pixmate.com.br/api-pix/) · [Privacidade e proteção de dados](https://pixmate.com.br/privacidade/) · [Entrar no painel](https://pixmate.com.br/painel/)