# BotaPix > BotaPix é uma plataforma brasileira de pagamentos via Pix. Desenvolvedores podem integrar uma **API REST** pra gerar cobranças Pix, assinaturas recorrentes (Pix Automático) e receber confirmação de pagamento por webhook. Criadores de conteúdo podem receber doações na live com uma **página pronta** (`/s/usuario`) e widgets pro OBS: alerta de doação (que pode ler toda doação em voz alta, sem custo extra, ou com uma voz de IA escolhida por quem doa), ranking de doadores, metas, maratona (subathon), enquetes e pedido de vídeo pago (Media Share) — sem escrever código e sem expor a chave Pix pessoal. Funciona na Twitch, na Kick, no YouTube e em qualquer plataforma que use OBS ou Streamlabs. Notas importantes: - **Autenticação da API:** header `Authorization: Bearer btpx_...`. O vendedor cria várias chaves no dashboard, cada uma com uma permissão (recebimentos, loja, somente leitura ou financeiro). - **Ambiente de testes:** chaves `btpx_test_` criam cobranças e assinaturas de teste, com simulação de pagamento, expiração e devolução e webhooks de teste. Nenhum dinheiro se move; o código é o mesmo da produção. - **Valores monetários** trafegam em **centavos** na API (ex.: `1000` = R$ 10,00). - **Respostas** usam o envelope `{ "data": {...} }`; erros seguem `{ "error": "...", "message": "..." }`, exceto validação (422, com `errors` por campo) e limite de requisições (429, só `message`). - **Rate limiting por API key** (não por IP): 600 req/min nas criações (`POST /charges` e `POST /subscriptions`), 200 req/min nas consultas e no cancelamento; chaves de teste, 120 req/min. - **Idempotência:** header opcional `Idempotency-Key` no `POST /charges`, `POST /subscriptions`, `POST /withdrawals` e `POST /charges/{id}/refunds` — mesma key + mesmo corpo devolve o objeto original; corpo diferente dá `422 idempotency_key_reused`; escopado por vendedor. - **Webhooks (saída):** o vendedor cadastra até 5 endpoints por ambiente e escolhe os eventos de cada um. Famílias: pagamento (`payment.confirmed`, `payment.refunded`, `payment.expired`), assinatura (`subscription.*`), saque (`withdrawal.*`), devolução (`refund.*`), disputa MED (`dispute.*`) e entrega de produto (`delivery.*`); lista completa em [Eventos](https://botapix.com/docs/webhooks/eventos). Assinado com HMAC-SHA256 (`X-BotaPix-Signature`, secret por ambiente), com até 8 tentativas ao longo de ~33h e `X-BotaPix-Event-Id` estável pra deduplicar. - **Sem exposição de chave Pix:** o pagador nunca vê a chave Pix pessoal do vendedor/streamer — o BotaPix intermedia e credita o saldo, com período de hold configurável antes do saque. - **Assinaturas** usam Pix Automático (recorrência), com tarifa fixa + percentual por cobrança recorrente e mínimo de R$ 10. ## Taxas e limites (valores públicos, verificados em novembro/2026) - **Taxa por transação:** 3% sobre cada pagamento confirmado. Sem mensalidade, sem taxa de adesão, sem custo por inatividade. - **Saque (repasse):** tarifa de 1,5% (mínimo R$ 0,50), deduzida do valor enviado. Saque mínimo de R$ 10,00; até R$ 500,00 o saque é aprovado automaticamente. O saque vai só pra chave Pix do MESMO CPF/CNPJ do titular da conta — repasse pra terceiros não existe, por desenho. - **Assinaturas (Pix Automático):** R$ 3,50 fixo + 3% por cobrança recorrente; valor mínimo de assinatura R$ 10,00. - **Vaquinhas (campanhas de arrecadação):** páginas públicas com meta e prazo, mesma taxa de 3%. - **Integrações de live (setembro/2026):** alertas de sub, bits e raid da Twitch e da Kick no mesmo widget das doações; maratona (subathon) que ganha tempo com Pix, sub e bits; enquetes com Pix; recompensas (link, conteúdo secreto ou cargo no Discord) por doação ou assinatura; controle dos alertas pelo Stream Deck. Nada de dinheiro passa pela Twitch ou pela Kick: só o alerta. - **Maratona (subathon) com Pix:** widget de cronômetro pro OBS (timer de subathon) que ganha tempo sozinho a cada doação em Pix (padrão: 1 minuto por R$ 1), sub (5 min), 100 bits ou 100 Kicks (1 min) e, se ligado, raid por viewer. Teto de horas opcional, pausa, ajuste manual de tempo e controle pelo painel Ao vivo; o widget mostra a última adição ("+10m · Maria · R$ 10,00") e tem cinco estilos: Relógio, Pílula, Notificação (card translúcido como as notificações de jogo, com anel do tempo), Anel e Faixa (tarja para a parte de baixo da tela). Maratona, meta, enquete, ranking, histórico e músicas têm a opção de fundo translúcido. Vaquinha e assinatura mensal também somam tempo. Sem custo extra além dos 3% por doação. Guia: https://botapix.com/blog/maratona-subathon-com-pix-como-configurar - **Alerta de doação (novembro/2026):** leitura de toda doação em voz alta (opcional, sem custo extra, vozes neurais em português do Brasil: Vitória, Camila e Thiago; lê quem mandou, o valor e a mensagem inteira; mensagem barrada pelo filtro de conteúdo vira só "Fulano mandou X reais"); vozes de IA, inclusive de personagens, que quem doa escolhe a partir de R$ 5 (falam no lugar da leitura); áudio de até 20 s gravado por quem doa; estilos (Pílula, Pixel, Monograma, Pílula grande, Balão, Adesivo), temas claro e escuro e cor de destaque; temas com cores próprias na aba Temas (Neon, com estrelas que acendem conforme o valor, e Natal até 06/01/2027); variações de estilo, cor, som e duração por valor; aprovação antes de mostrar e fila controlável pelo Stream Deck. - **App:** BotaPix para Android na Google Play (`com.botapix.app`), com saldo, doações e mapa IRL ao vivo no OBS; iPhone em breve. ## Versões em markdown pra assistentes e crawlers - Toda página de `/docs` e `/blog` tem versão markdown crua: **acrescente `.md` à URL** (ex.: `https://botapix.com/docs/cobrancas/criar.md`). - [llms-full.txt](https://botapix.com/llms-full.txt): este índice + o conteúdo integral das páginas, da documentação, do blog e das perguntas frequentes (home e Central de Ajuda), num arquivo só. ## Gateway de pagamentos (páginas do produto) - [API de pagamentos Pix](https://botapix.com/api) ([markdown](https://botapix.com/api.md)): cobranças, assinaturas por Pix Automático, produtos com entrega automática, saldo, saques, devoluções e webhooks, com ambiente de testes. - [Loja no Discord](https://botapix.com/discord) ([markdown](https://botapix.com/discord.md)): vitrine de produtos no servidor, botão Comprar, Pix numa mensagem que só o comprador vê e entrega automática por mensagem e DM. - [Taxas](https://botapix.com/taxas) ([markdown](https://botapix.com/taxas.md)): todas as tarifas e um simulador de quanto fica com o vendedor. - [Gateway de pagamento Pix: como funciona e como escolher](https://botapix.com/gateway-pix) ([markdown](https://botapix.com/gateway-pix.md)): o que é um gateway Pix, como o dinheiro anda, gateway x PSP, MED e os nove pontos para comparar. - [Condições especiais](https://botapix.com/condicoes-especiais) ([markdown](https://botapix.com/condicoes-especiais.md)): proposta de tarifa para quem recebe a partir de R$ 50 mil por mês. ## Para streamers (páginas de doação e widgets) - [Live de GTA 6 com Pix: maratona (subathon), voz e tema Neon](https://botapix.com/blog/live-de-gta-6-com-pix): Como montar a live de GTA 6 com Pix: maratona (subathon) que ganha tempo a cada doação, alerta que lê toda doação em voz alta e tema Neon. - [Como colocar live pix na sua live: Twitch, Kick, YouTube e OBS](https://botapix.com/blog/como-receber-pix-na-live-guia-streamer): O que é live pix (doação via Pix com alerta na live), quanto custa e o passo a passo pra criar a página `/s/usuario`, ligar o alerta no OBS e divulgar na Twitch, na Kick e no YouTube. - [Sub, bits e raid da Twitch e da Kick no mesmo alerta do Pix](https://botapix.com/blog/alertas-de-sub-bits-e-raid-twitch-e-kick-no-obs): Como conectar as contas e o que aparece no widget. - [Maratona (subathon) com Pix, subs e bits](https://botapix.com/blog/maratona-subathon-com-pix-como-configurar): Regras de tempo, teto, pausa e o widget do cronômetro. - [Recompensas para quem doa ou assina](https://botapix.com/blog/recompensas-para-quem-doa-ou-assina): Link, código ou conteúdo secreto entregue na confirmação do Pix. - [Enquetes com Pix na live](https://botapix.com/blog/enquetes-com-pix-na-live): A audiência vota com Pix e o resultado aparece no widget. - [Stream Deck: pausar, pular e silenciar alertas](https://botapix.com/blog/stream-deck-pausar-pular-e-silenciar-alertas): Token de controle remoto e as URLs de cada tecla. - [App BotaPix para Android e o mapa IRL ao vivo](https://botapix.com/blog/app-botapix-android-mapa-irl-ao-vivo): O que o app faz e como transmitir o trajeto no OBS. - [5 erros que reduzem doações na sua live (e como corrigir)](https://botapix.com/blog/5-erros-que-reduzem-doacoes-na-live): Boas práticas de página de doação, alerta e call-to-action pra converter viewer em doador. - [LivePix, Tipa.ai ou BotaPix? Comparativo de taxas de Pix em live (2026)](https://botapix.com/blog/botapix-vs-alternativas-comparativo-2026): Alternativas ao LivePix comparadas — taxa por doação e por saque de LivePix (5%), Tipa.ai (3,99%) e BotaPix (3%), e quanto sobra de cada R$ 1.000 doado. - [Doação Pix na Twitch: Pix ou bits?](https://botapix.com/blog/doacao-pix-na-twitch-pix-ou-bits): Por que receber por Pix (~3%) em vez de bits/subs da Twitch (que retêm 30–50%, pagam em dólar e demoram no repasse), e como configurar o Pix na sua live da Twitch. - [Pix que roda vídeo na live (media request)](https://botapix.com/blog/pix-que-roda-video-na-live-media-request): Como funciona o Media Share do BotaPix — o doador paga por segundo pra tocar um vídeo do YouTube na live, com preço por segundo, fila de moderação e banimento de vídeo, tudo configurado no OBS. - **Widgets disponíveis** (Browser Source no OBS): Alerta de doação (estilos e temas, som, leitura de toda doação em voz alta, vozes de IA e áudio gravado pelo doador, sub/bits/raid da Twitch e da Kick), QR Code, Ranking de doadores, Meta, Histórico de doações, Enquete, Maratona (subathon) e Media Share (o doador paga por segundo pra tocar um vídeo do YouTube na live, com moderação do streamer). ## API — Introdução e primeiros passos - [Introdução](https://botapix.com/docs): API REST para cobranças Pix, assinaturas via Pix Automático e notificações por webhook. - [Primeiros passos](https://botapix.com/docs/primeiros-passos): Do zero ao webhook no ambiente de testes: credenciais de teste, cobrança, simulação do pagamento e confirmação, e a troca para produção. - [Ambientes e testes](https://botapix.com/docs/ambientes-e-testes): Produção e ambiente de testes: chaves, cobranças, assinaturas, simulações e webhooks de teste, sem movimentar dinheiro. - [Antes de ir para produção](https://botapix.com/docs/antes-de-producao): Lista de verificação para publicar a integração: credenciais, cobranças, webhooks, erros e conciliação. - [Integrando com IA](https://botapix.com/docs/integrando-com-ia): Como usar assistentes de IA na integração: versões em Markdown, llms.txt, especificação OpenAPI e cuidados com credenciais. - [Autenticação](https://botapix.com/docs/autenticacao): Autenticação por API key e limites de requisições. - [Convenções](https://botapix.com/docs/convencoes): Formato de requisições e respostas, valores em centavos, datas em UTC, paginação, identificadores e ambiente. - [Erros](https://botapix.com/docs/erros): Status HTTP, formato das respostas de erro e códigos retornados pela API. - [Changelog](https://botapix.com/docs/changelog): Mudanças da API e dos webhooks, da mais recente para a mais antiga. ## API — Cobranças (Pix avulso) - [Criar cobrança](https://botapix.com/docs/cobrancas/criar): Cria uma cobrança Pix de valor fixo e retorna a URL da página de pagamento. - [Consultar cobrança](https://botapix.com/docs/cobrancas/consultar): Retorna uma cobrança pelo identificador numérico ou pelo reference. - [Listar cobranças](https://botapix.com/docs/cobrancas/listar): Lista as cobranças da conta, da mais recente para a mais antiga, com filtros e paginação. - [Estatísticas](https://botapix.com/docs/cobrancas/estatisticas): Retorna totais agregados e série temporal das cobranças criadas em um período. - [Idempotência](https://botapix.com/docs/cobrancas/idempotencia): Repetição segura de requisições de criação com o header Idempotency-Key. - [Exibir o QR no seu site](https://botapix.com/docs/cobrancas/exibir-qr): QR Code e Pix Copia e Cola na resposta da cobrança, para contas com a exibição liberada. ## API — Assinaturas (Pix Automático) - [Criar assinatura](https://botapix.com/docs/assinaturas/criar): Cria uma assinatura mensal via Pix Automático e retorna o código de autorização para o pagador. - [Consultar e listar](https://botapix.com/docs/assinaturas/consultar): Retorna uma assinatura pelo identificador ou lista as assinaturas da conta. - [Cancelar assinatura](https://botapix.com/docs/assinaturas/cancelar): Cancela uma assinatura e encerra a autorização no banco do pagador. ## API — Dinheiro - [Saldo e extrato](https://botapix.com/docs/dinheiro/saldo-e-extrato): Consulta o saldo da conta e lista os lançamentos que o formam. - [Saques](https://botapix.com/docs/dinheiro/saques): Solicita saques do saldo disponível para a chave Pix cadastrada na conta e consulta os saques. - [Devoluções](https://botapix.com/docs/dinheiro/devolucoes): Devolve ao pagador todo ou parte do valor de uma cobrança paga e consulta as devoluções. - [Disputas (MED)](https://botapix.com/docs/dinheiro/disputas): Consulta as disputas abertas pelo banco do pagador por meio do MED e acompanha o valor bloqueado. ## API — Produtos (entrega automática) - [Catálogo de produtos](https://botapix.com/docs/produtos/catalogo): Cria e mantém produtos com entrega automática por texto, link ou chave de licença, e abastece o estoque de chaves. - [Vender um produto](https://botapix.com/docs/produtos/vender): Cria a cobrança de um produto do catálogo, com estoque reservado e entrega automática, e consulta o que o comprador recebeu. ## API — Webhooks (notificações) - [Visão geral](https://botapix.com/docs/webhooks/visao-geral): Notificações HTTP enviadas ao seu servidor quando pagamentos e assinaturas mudam de status. - [Configurar](https://botapix.com/docs/webhooks/configurar): Cadastro de endpoints, escolha de eventos, secret de assinatura e troca sem interrupção, evento de teste, log de entregas e implementação do endpoint. - [Verificação HMAC](https://botapix.com/docs/webhooks/assinatura-hmac): Verificação do header X-BotaPix-Signature com HMAC-SHA256, com exemplos em PHP, Node.js e Python. - [Eventos](https://botapix.com/docs/webhooks/eventos): Envelope comum dos eventos, lista dos eventos enviados e origem dos pagamentos. - [Retentativas](https://botapix.com/docs/webhooks/retry-policy): Política de novas tentativas para entregas de webhook sem confirmação. - [Testar localmente](https://botapix.com/docs/webhooks/testar-localmente): Receber eventos de webhook num servidor em execução na sua máquina, com Cloudflare Tunnel ou ngrok. - [payment.confirmed](https://botapix.com/docs/eventos/payment-confirmed): Enviado quando um pagamento é confirmado e o valor líquido é creditado no saldo da conta. - [payment.refunded](https://botapix.com/docs/eventos/payment-refunded): Enviado quando o valor integral de um pagamento é devolvido ao pagador, por devolução ou por MED. - [payment.expired](https://botapix.com/docs/eventos/payment-expired): Enviado quando uma cobrança vence sem ser paga. - [subscription.activated](https://botapix.com/docs/eventos/subscription-activated): Enviado quando o pagador autoriza uma assinatura. - [subscription.rejected](https://botapix.com/docs/eventos/subscription-rejected): Enviado quando a autorização de uma assinatura é recusada. - [subscription.canceled](https://botapix.com/docs/eventos/subscription-canceled): Enviado quando uma assinatura é cancelada pela API, pelo pagador ou pela instituição financeira. - [withdrawal.scheduled](https://botapix.com/docs/eventos/withdrawal-scheduled): Enviado quando um saque ganha data de envio: logo após o pedido ou após a aprovação. - [withdrawal.completed](https://botapix.com/docs/eventos/withdrawal-completed): Enviado quando o Pix do saque é enviado para a chave da conta. - [withdrawal.failed](https://botapix.com/docs/eventos/withdrawal-failed): Enviado quando o saque não é realizado. O valor volta para o saldo disponível. - [withdrawal.canceled](https://botapix.com/docs/eventos/withdrawal-canceled): Enviado quando o saque é cancelado antes do envio. O valor volta para o saldo disponível. - [refund.completed](https://botapix.com/docs/eventos/refund-completed): Enviado quando a devolução é concluída e o valor chega ao pagador. - [refund.failed](https://botapix.com/docs/eventos/refund-failed): Enviado quando a devolução não é realizada. O valor volta para o saldo disponível. - [dispute.opened](https://botapix.com/docs/eventos/dispute-opened): Enviado quando o banco do pagador abre uma disputa (MED) sobre um pagamento. O valor contestado é bloqueado no saldo. - [dispute.updated](https://botapix.com/docs/eventos/dispute-updated): Enviado quando a disputa passa para análise. - [dispute.closed](https://botapix.com/docs/eventos/dispute-closed): Enviado quando a disputa é encerrada. O status indica o resultado. - [delivery.completed](https://botapix.com/docs/eventos/delivery-completed): Enviado quando a venda de um produto é entregue ao comprador, depois da confirmação do Pix. - [delivery.failed](https://botapix.com/docs/eventos/delivery-failed): Enviado quando a venda de um produto é paga e faltam chaves no estoque para a entrega completa. - [webhook.test](https://botapix.com/docs/eventos/webhook-test): Evento de teste enviado pelo botão Enviar teste de um endpoint no dashboard. ## API — Streamers (controles do alerta) - [Controles de alerta](https://botapix.com/docs/streamers/controle-de-alertas): Controle remoto do widget de alertas: pausa, repetição, fila e vozes. ## API — Referência - [Especificação OpenAPI 3.1](https://botapix.com/docs/openapi.json): Especificação completa da API pública, dos controles de alerta e dos webhooks, em JSON. - [Explorar API](https://botapix.com/docs/explorar): Referência interativa gerada a partir da especificação OpenAPI. ## Guias (blog) Guias em português pra streamers e integradores. Cada post também existe em `.md` (acrescente `.md` à URL). - [Live de GTA 6 com Pix: maratona (subathon), voz e tema Neon](https://botapix.com/blog/live-de-gta-6-com-pix): Passo a passo da live de GTA 6 com Pix: maratona (subathon) que ganha 1 minuto por real doado, alerta que lê toda doação em voz alta sem custo extra, tema Neon com estrelas pelo valor e enquete para o chat escolher a missão. - [Sub, bits e raid da Twitch e da Kick no mesmo alerta do Pix](https://botapix.com/blog/alertas-de-sub-bits-e-raid-twitch-e-kick-no-obs): Conecte sua conta da Twitch ou da Kick ao BotaPix e cada sub, bits, raid, follow ou Kick vira alerta no mesmo widget das doações, com toggles por tipo e mínimo de bits. - [Stream Deck: pausar, pular e silenciar os alertas com uma tecla](https://botapix.com/blog/stream-deck-pausar-pular-e-silenciar-alertas): Gere um token de controle remoto e ligue cada tecla do Stream Deck a uma ação do widget de alerta: pausar, retomar, pular o alerta atual, silenciar a voz e disparar um teste. O token não acessa saldo nem saques. - [Recompensas: link, código ou conteúdo secreto para quem doa ou assina](https://botapix.com/blog/recompensas-para-quem-doa-ou-assina): Cadastre uma recompensa, defina o valor mínimo ou o gatilho de assinatura, e o apoiador recebe o link ou o conteúdo na tela de confirmação do Pix. Revogação automática se a assinatura cair. - [Maratona (subathon) com Pix, subs e bits: como configurar](https://botapix.com/blog/maratona-subathon-com-pix-como-configurar): Um cronômetro que ganha tempo com cada doação em Pix, sub, bits, Kicks ou raid. Regras por evento, teto de horas, pausa, ajuste manual e widget pronto pro OBS. - [Enquetes com Pix: a audiência decide, e paga por isso](https://botapix.com/blog/enquetes-com-pix-na-live): Crie uma enquete com até seis opções, escolha se cada real vale um voto ou cada doação vale um voto, e mostre o resultado ao vivo no widget. O voto conta quando o Pix é pago. - [App BotaPix para Android: receba Pix na live e acompanhe tudo pelo celular](https://botapix.com/blog/app-botapix-android-mapa-irl-ao-vivo): O app do BotaPix está na Google Play. Saldo, saque, histórico de doações e o mapa IRL ao vivo no OBS, tudo pelo celular. O app de doação para streamer que fecha o ciclo do Pix na live. iPhone em breve. - [Pix que roda vídeo na live: como funciona o media request (e como configurar)](https://botapix.com/blog/pix-que-roda-video-na-live-media-request): Deixe quem doa escolher um vídeo do YouTube pra tocar na sua live. Como funciona o media request no BotaPix: preço por segundo, fila de moderação, banimento de vídeo e configuração no OBS. - [Doação Pix na Twitch: por que streamers preferem Pix aos bits (e como configurar)](https://botapix.com/blog/doacao-pix-na-twitch-pix-ou-bits): Bits e subs deixam 30–50% com a Twitch, pagam em dólar e demoram semanas. Doação via Pix chega em segundos com taxa de ~3%. A matemática lado a lado e o passo a passo pra configurar. - [Assinaturas via Pix Automático: como cobrar todo mês sem o cliente fazer nada](https://botapix.com/blog/assinaturas-pix-automatico-no-botapix): Pix Automático chegou e muda a cobrança recorrente no Brasil: o cliente autoriza uma vez no app do banco e o valor é debitado todo mês, sem cartão e sem ele precisar pagar de novo. Veja como funciona e como ativar no BotaPix — pela dashboard ou via API. - [Como receber Pix na live: passo a passo pro streamer iniciante (2026)](https://botapix.com/blog/como-receber-pix-na-live-guia-streamer): Passo a passo completo pra receber doações Pix na live: escolher a plataforma, configurar o alerta no OBS e testar antes de ir ao ar — tudo em texto, sem precisar assistir 40 minutos de vídeo. - [LivePix, Tipa.ai ou BotaPix? Comparativo de taxas de Pix em live (2026)](https://botapix.com/blog/botapix-vs-alternativas-comparativo-2026): Procurando uma alternativa ao LivePix? Comparamos taxa por doação, taxa de saque e recursos de LivePix, Tipa.ai e BotaPix — e quanto de cada R$ 1.000 doado chega de fato na sua conta. - [MED do Pix: o que é, como funciona e o que acontece com seu saldo se um cliente abrir uma disputa](https://botapix.com/blog/med-do-pix-o-que-e-e-como-protege-vendedor): Mecanismo Especial de Devolução do Pix (MED) explicado pra quem recebe: como funciona, qual o prazo, o que o BACEN avalia e como gateways como o BotaPix protegem seu saldo durante a análise. - [5 erros que reduzem doações na sua live (e como corrigir)](https://botapix.com/blog/5-erros-que-reduzem-doacoes-na-live): Cinco problemas técnicos e de UX que estão custando doações sem você notar — QR Code ilegível, posicionamento do alerta, TTS robotizado, link escondido e ausência de meta visual.