Autosync para plataformas P2P
Hoje, os teus investidores descarregam um ficheiro e carregam-no à mão no P2P Dash. Com um token só de leitura e um endpoint do teu lado, as transações deles chegam sozinhas. Sem palavras-passe e sem OAuth. 2100+ investidores acompanham as suas carteiras no P2P Dash.
O que muda
O Autosync ainda não existe. Hoje nenhuma plataforma oferece isto, por isso é o que construiríamos juntos.
Os números deles mantêm-se atualizados
Neste momento, sempre que querem números recentes, têm de entrar, encontrar a exportação, descarregá-la e voltar a carregá-la. Com o Autosync, colam um token uma vez. A rentabilidade, os juros e a liquidez passam a atualizar-se sem mais nenhum ficheiro.
Menos um obstáculo para quem acompanha a tua plataforma
Ninguém tem de procurar a exportação nem de perguntar ao teu apoio ao cliente como funciona. A tua plataforma recebe a etiqueta Autosync na sua página do P2P Dash e na lista de plataformas. As importações regulares também mantêm atualizados os números da comunidade na tua página, porque vêm das transações importadas.
Como funciona
O investidor configura uma vez. Depois disso, funciona sem ele.
O investidor cria um token
Nas definições da conta dele na tua plataforma, atrás do teu login normal. Mostras o token uma única vez.
Cola-o no P2P Dash
Um campo na entrada da tua plataforma, dentro da conta dele no P2P Dash. A configuração é só isto.
O P2P Dash vai buscar as transações
De servidor para servidor, mais ou menos uma vez por dia. Voltamos a ler os últimos dias para apanhar lançamentos tardios.
O investidor mantém o controlo
Revoga o token na tua plataforma ou desliga a ligação no P2P Dash. Em qualquer dos casos, deixamos de ir buscar os dados.
O que terias de construir
Tentámos pedir-te o mínimo possível, porque tens mais que fazer. Para os dados, a tua exportação de transações é um bom ponto de partida.
O que é preciso
- Uma página de definições onde o investidor cria e revoga um token só de leitura. Mostra-o uma vez e guarda apenas um hash.
- Um endpoint GET que devolve as transações desse investidor para um intervalo de datas
- Um limite de pedidos por token. Chamamos cerca de uma vez por dia, por isso um limite baixo chega.
- Uma nota curta sobre o que significam as tuas etiquetas de transação. Basta um email.
O que não é preciso
- OAuth, redirecionamentos ou ecrãs de consentimento
- Webhooks ou tarefas em segundo plano do teu lado
- Um portal de programadores ou uma sandbox
- Dados de empréstimos, mutuários ou pessoais na resposta
Conheces o teu código melhor do que nós, por isso não vamos adivinhar quantos dias isto demora. Se quiseres vê-lo primeiro com os teus programadores, envia-nos as tuas perguntas.
O endpoint
Isto é uma sugestão, não um formato fixo. Se outra coisa for mais fácil para o teu sistema, diz-nos. Um CSV ou Excel com os mesmos campos também serve.
Pedido
GET /v1/transactions?from=2026-10-01&to=2026-10-31
Host: api.yourplatform.com
Authorization: Bearer <token>Resposta
{
"transactions": [
{
"date": "2026-10-02",
"type": "deposit",
"amount": 500.00,
"currency": "EUR"
},
{
"date": "2026-10-15",
"type": "interest",
"amount": 12.34,
"currency": "EUR"
}
]
}Campos
date- ISO 8601, em UTC ou com um desvio horário. Um timestamp também serve, só usamos o dia.
type- As tuas próprias etiquetas servem, nós fazemos o mapeamento. Se estiveres a começar do zero, podes usar os nossos nomes abaixo.
amount- Um número com ponto como separador decimal. Positivo, com o sentido dado pelo tipo. Um estorno é um montante negativo do mesmo tipo.
currency- Código ISO 4217, ou seja, EUR para euros.
Convém saber
- Os dois parâmetros de data são opcionais. Sem eles, devolve o histórico completo. É isso que a primeira sincronização usa.
- Não é preciso paginação. Se uma resposta ficar demasiado grande, diz-nos o teu limite e pedimos intervalos de datas mais pequenos.
- Responde com 401 para um token inválido ou revogado, e com 429 e um cabeçalho Retry-After quando o limite de pedidos for atingido.
Como chamamos aos tipos de transação
Estes são os nomes exatos que usamos internamente. Não tens de os copiar, estão aqui só como inspiração. Quanto mais os teus tipos se aproximarem destes, menos temos de traduzir.
deposit- Dinheiro que entra na plataforma vindo de fora.
withdrawal- Dinheiro que sai da plataforma e volta ao banco do investidor.
investment- Dinheiro colocado num empréstimo ou projeto, incluindo compras no mercado secundário.
interest- Juros ganhos num investimento.
principalRepayment- Capital investido que regressa de um empréstimo ou projeto.
bonus- Cashback, referências, campanhas e outras recompensas.
fee- Tudo o que a plataforma cobra ao investidor.
tax- Impostos pagos ou retidos.
defaultLoss- Capital perdido quando um empréstimo entra em incumprimento e não pode ser recuperado.
internalTransfer- Dinheiro que circula entre contas dentro da plataforma. Não altera o saldo.
Esta lista pode crescer, por exemplo com tipos para o mercado secundário. Se a tua plataforma já tiver mais tipos, envia-os tal como estão. Por agora mapeamo-los para os nomes acima, mas isso pode mudar mais tarde.
Quatro coisas que têm de estar certas
O formato pode adaptar-se. Isto não, porque a rentabilidade que calculamos depende disto.
Todos os movimentos de dinheiro
Depósitos, levantamentos, investimentos, juros, amortizações de principal, bónus, taxas, impostos e perdas por incumprimento. Sem depósitos e levantamentos não conseguimos calcular a rentabilidade, e sem investimentos e amortizações não conseguimos mostrar o capital investido.
Dias completos
Um intervalo de datas devolve todas as transações desses dias. Comparamos e guardamos dias inteiros, e é também por isso que não precisas de IDs de transação.
Acessível por um servidor
O token é a única coisa que este endpoint pede. Sem CAPTCHA, sem desafio antibot, sem cookie de sessão, sem pedido de 2FA. Se o teu site estiver atrás da Cloudflare ou de algo parecido, o caminho precisa de uma exceção.
Alterações com aviso prévio
Avisa-nos antes de alterar etiquetas ou campos, ou usa um caminho com versão. Uma etiqueta nova que não conheçamos aparece como transação não reconhecida até a adicionarmos.
O que o token pode e não pode fazer
É isto que a tua equipa de segurança vai perguntar, por isso fica aqui tudo junto.
Só de leitura, um investidor
Lê as transações do investidor que o criou. Não pode iniciar sessão, investir, levantar dinheiro nem alterar nada.
Sem dados pessoais
A resposta contém data, tipo, montante e moeda. Sem nome, sem morada, sem IBAN, sem mutuário.
Revogável a qualquer momento
O investidor apaga-o nas tuas definições. A chamada seguinte recebe um 401, paramos e avisamo-lo de que a ligação terminou.
Como o trataríamos
Encriptado na nossa base de dados, usado apenas nos nossos servidores em Frankfurt, apagado quando a ligação é desfeita ou a conta é eliminada. Guardamos totais diários por tipo, não as tuas linhas, tal como hoje com um ficheiro carregado.
A etiqueta Autosync
As plataformas que oferecem isto recebem uma etiqueta no P2P Dash. Diz uma só coisa sobre ti: como os teus dados nos chegam.
O que a etiqueta significa
- Os investidores podem ligar esta plataforma com um token em vez de carregar ficheiros
- Aparece na página da tua plataforma e como filtro na lista de plataformas
- É gratuita, com as mesmas condições para todas as plataformas
O que não significa
- Não é um selo de qualidade nem uma recomendação
- Não altera rankings, pontuações nem o que escrevemos sobre ti
- Não se pode comprar e não exige nenhum acordo de afiliação
O P2P Dash é gratuito e ganha dinheiro com links de afiliados. Esses também não alteram nenhum número. Explicamos como funciona na nossa página de transparência: p2pdash.com/pt/transparencia/
Perguntas que podes ter
Se a tua não estiver aqui, pergunta. Quem te responde é a pessoa que constrói isto.
O Autosync já funciona?
Ainda não. Construímos a nossa parte assim que uma primeira plataforma se comprometer, e fazemo-lo em conjunto com ela. De qualquer forma, as importações manuais continuam disponíveis para todos.
Porque não OAuth?
O OAuth implica um servidor de autorização, ecrãs de consentimento e gestão de clientes do teu lado. Para um acesso só de leitura às próprias transações, um token criado pelo investidor consegue o mesmo resultado com muito menos trabalho.
E se um token for exposto?
Quem o tiver pode ler o histórico de transações desse investidor até o token ser revogado. É um risco real, e é por isso que o token só pode ler, a resposta não contém dados pessoais e basta um clique para o revogar. Uma data de validade do teu lado também não é problema: pediríamos um novo token ao investidor.
Isto é só para o P2P Dash?
Não. O token pertence ao investidor, por isso ele pode dá-lo a qualquer ferramenta que escolha. Construirias um endpoint, não uma integração especial para nós.
Quanto custa?
Nada, em nenhum dos sentidos. Não cobramos pelo Autosync e não podes pagar pela etiqueta.
Está de acordo com as regras de proteção de dados?
É o investidor que decide partilhar os seus próprios dados e que cria o token. Não te podemos dar aconselhamento jurídico, por isso o melhor é a tua equipa jurídica dar uma vista de olhos. Respondemos com gosto às perguntas dela, e a nossa política de privacidade vai descrever a recolha de dados antes de isto entrar em funcionamento.
Que moedas são suportadas?
Envia a moeda em cada transação. O P2P Dash tem uma moeda de conta por plataforma e não faz conversões, por isso diz-nos se os teus investidores têm várias moedas na mesma conta e vemos como resolver isso.
Queres ser a primeira plataforma?
Escreve ao Tim, que constrói o P2P Dash. Para começar, basta um «podíamos fazer isto» ou uma lista de perguntas dos teus programadores.
Escreve para tim@newnow.deLemos cada email pessoalmente e costumamos responder em poucos dias.