A API permite criar transações?

Não. A API é de leitura. Doações offline são registradas pelo painel.

Tem endpoints de assinaturas e doadores?

Sim, com o mesmo padrão: /v1/assinaturas e /v1/doadores, com os campos das telas correspondentes e as permissões do token.

Qual o limite de requisições?

600 por minuto por token. Acima disso, a API responde 429; espere e tente de novo.

Os valores vêm com ponto ou vírgula?

Ponto decimal, padrão JSON: 60.00. Formate na exibição.

Posso ter mais de um token?

Sim, um por sistema, para revogar um sem afetar os outros.

API de Doações: referência do JSON

API de transações: referência do JSON

A API de transações entrega, em JSON, o que a tela de Transações mostra: cada doação com doador, valores, forma, origem e recorrência. Serve para alimentar um ERP, um painel no Power BI ou Looker, uma planilha viva, ou qualquer sistema da organização. Este artigo é a referência: como autenticar, como consultar e o que significa cada campo.

8 min de leituraAtualizado em 7 de setembro de 2026Documentação Técnica

Gerar o token

painel.doare.org/dashboard/integrations

Instituto Semear

doare

Dashboard

Gestão

Captação

Relacionamento

Finanças

Análise

Configurações

Personalizar Remetente

Usuários

Bloqueio de usuários

Integrações

Dados da Organização

Planos

Ajuda

Dashboard›Integrações

PTMarinaM

Integrações

O card da API em Integrações: o token, as permissões, o uso recente e as ações.

Em Configurações › Integrações, abra Credenciais para integração com a API de Transações
Só administradores ou usuários com permissão de Configurações.
Gere o token e copie
Ele aparece uma vez inteiro. Guarde num cofre de segredos; nunca no código-fonte nem em planilha.
Escolha as permissões
Só leitura, por escopo: transações, assinaturas, doadores, campanhas.
Use no cabeçalho Authorization
Authorization: Bearer dr_live_…. Vazou? Revogue e gere outro; o antigo morre na hora.

Consultar transações

Exemplo de requisição

GET /v1/transacoes?data_inicio=2026-08-01&data_fim=2026-08-31&status=pago&pagina=1
Authorization: Bearer dr_live_8f3k…
Accept: application/json

Parâmetro	O que faz
`data_inicio`, `data_fim`	Período pela data da transação (AAAA-MM-DD).
`status`	pago, pendente, cancelado, reembolsado, falhou.
`campanha`	Id ou slug da campanha.
`forma_pagamento`	pix, boleto, cartao_credito, paypal…
`tipo_captacao`	link_doacao, crowdfunding, evento, rifa, leilao.
`recorrente`	true ou false.
`atualizado_desde`	Só o que mudou depois de uma data e hora: para sincronizações incrementais.
`pagina`	Paginação em 100 itens; a resposta traz `total` e `proxima_pagina`.

Para manter um sistema sincronizado, consulte com atualizado_desde a cada hora, ou use os webhooks para ser avisado na hora e a API só para conferir.

Quais campos o JSON traz?

Campo	Descrição	Formato
`id`	Identificador único da transação na Doare.	inteiro
`doador_id`	Identificador único do doador no CRM.	inteiro
`doador_nome`	Nome do doador conforme cadastrado.	texto
`doador_email`	E-mail informado no momento da doação.	texto
`data`	Data e hora da transação, com fuso horário.	ISO 8601
`status`	Situação da doação: pago, pendente, cancelado, reembolsado e demais.	texto
`moeda`	Moeda da transação: BRL, USD, EUR ou GBP.	ISO 4217
`valor_bruto`	Valor pago pelo doador, antes das taxas.	decimal
`valor_liquido`	Valor após a dedução das taxas de processamento.	decimal
`forma_pagamento`	Meio utilizado: pix, boleto, cartao_credito, paypal e demais.	texto
`gateway`	Provedor que processou o pagamento.	texto
`tipo_captacao`	Origem da doação: link_doacao, crowdfunding, evento, rifa, leilao.	texto
`recorrente`	Indica se a doação faz parte de uma assinatura.	booleano
`id_assinatura`	Identificador da assinatura vinculada. Nulo em doação única.	inteiro ou nulo
`campanha`	Campanha à qual a doação pertence. Nulo quando não houver.	texto ou nulo
`utm_source`	Origem de tráfego registrada no momento da doação.	texto
`utm_medium`	Meio de tráfego registrado.	texto
`utm_campaign`	Campanha de tráfego registrada.	texto

Exemplo de payload

Uma doação recorrente de R$ 60,00 no cartão de crédito, originada de um link de doação divulgado na bio do Instagram:

Uma transação

{
  "id": 4831207,
  "doador_id": 90214,
  "doador_nome": "Helena M. Vasques",
  "doador_email": "helena@exemplo.com.br",
  "data": "2026-07-14T10:32:08-03:00",
  "status": "pago",
  "moeda": "BRL",
  "valor_bruto": 60.00,
  "valor_liquido": 56.94,
  "forma_pagamento": "cartao_credito",
  "gateway": "principal",
  "tipo_captacao": "link_doacao",
  "recorrente": true,
  "id_assinatura": 7712,
  "campanha": null,
  "utm_source": "instagram",
  "utm_medium": "bio",
  "utm_campaign": "mensal-2026"
}

campanha nulo e tipo_captacao link_doacao: veio do link institucional.
recorrente true com id_assinatura: é uma cobrança de assinatura; consulte a assinatura pelo id.
valor_liquido é o que entrou no saldo; a diferença para o bruto é a taxa.

Artigo relacionadoWebhooks: ser avisado em vez de consultar

API de transações: referência do JSON

Gerar o token

Consultar transações

Quais campos o JSON traz?

Exemplo de payload

Perguntas frequentes

Pronto para captar mais com a Doare?

Gerar o token

Consultar transações

Quais campos o JSON traz?

Exemplo de payload

Perguntas frequentes

Continue por aqui

Pronto para captar mais com a Doare?

Demonstração agendada!

Pronto para profissionalizar sua captação?