O DL Pay Acquirer é uma plataforma de pagamentos multi-adquirente que agrega diferentes parceiros de processamento por trás de uma única API unificada. Cuida da habilitação de lojistas, transações, splits, recebíveis, assinaturas, bilheteria de eventos, contas virtuais, webhooks de saída e das métricas que acompanham todas essas operações. A plataforma existe para que integradores não precisem conversar com cada rede adquirente diretamente — fazem uma única chamada à API e a plataforma roteia, normaliza, persiste e concilia os dados nos bastidores.

​
Quem utiliza

A plataforma atende três tipos de consumidor:

Usuários do painel

Operadores autenticados em painel.dlpay.cloud — administradores, suporte, distribuidores, agentes. Autenticam-se com JWT.

Backends de lojistas

Integrações servidor-a-servidor que agem em nome de um único lojista. Autenticam-se com chave de API do lojista.

Compradores públicos

Consumidores finais que pagam por meio de uma página de checkout (eventos, assinaturas). Um pequeno conjunto de endpoints é intencionalmente público.
Consulte Autenticação para o detalhamento completo de qual mecanismo se aplica em cada situação.

​
Que problemas resolve

Cada parceiro de processamento tem formatos próprios, esquemas de autenticação distintos e ciclos de vida diferentes. A plataforma expõe um conjunto único de recursos unificados (contas, transações, recebíveis, depósitos, documentos) e traduz tudo isso para cada parceiro nos bastidores.
Os parceiros de processamento enviam eventos; a plataforma enfileira jobs em segundo plano que buscam o dado autoritativo e atualizam tanto os registros específicos do adquirente quanto os modelos unificados. Não há sincronização manual.
Toda conta pode pertencer a um plano de split que distribui comissões para um agente, dois níveis de distribuição (N1, N2), um desenvolvedor e a própria plataforma. Os splits são aplicados automaticamente na captura.
Contagens e totais (vendas por data, recebíveis esperados por conta, vendas de ingressos por hora etc.) são mantidos em tabelas separadas, atualizadas atomicamente quando o status muda. Endpoints de listagem permanecem rápidos mesmo em larga escala.
Bilheteria de eventos, cobrança recorrente por assinatura, contas virtuais e webhooks de saída pertencentes ao lojista são recursos de primeira classe, e não produtos separados.

​
Módulos em um relance

A plataforma é organizada em módulos focados. Cada módulo contribui com URLs, modelos de dados e, quando aplicável, rotinas em segundo plano e ouvintes de webhook. A ordem de inicialização dos módulos é significativa: o módulo de fila de jobs é carregado primeiro e o módulo de webhooks em seguida, pois todos os outros módulos registram, em sua etapa de inicialização, manipuladores de jobs e ouvintes de webhook nesses dois.

​
A forma de um dia típico

1

Um lojista é habilitado

Um usuário do painel (ou um link de convite) cria uma Account unificada. A plataforma envia o cadastro à infraestrutura de processamento em segundo plano, anexa dados bancários e atribui um plano de split padrão.
2

Um comprador paga

Um link de checkout, um checkout de evento ou uma cobrança de assinatura é criado. A plataforma solicita a criação da transação ao parceiro de processamento e armazena tanto o registro específico do adquirente quanto a Transaction unificada.
3

O parceiro de processamento dispara um webhook

Uma chamada POST chega ao endpoint de webhooks. O evento é persistido, despachado para os ouvintes e dispara um job em segundo plano que busca o estado mais recente da transação.
4

Recebíveis, splits e depósitos são atualizados

O job atualiza o registro específico do adquirente, propaga para a camada unificada, atualiza métricas pré-agregadas, aplica splits e emite webhooks de saída para cada lojista que esteja escutando.
5

O painel lê dados unificados

Toda a interface e a geração de relatórios consultam a camada unificada, de modo que a mesma visão funciona independentemente de qual rede adquirente liquidou o pagamento.

​
Características técnicas

  • API REST com respostas em JSON.
  • Autenticação JWT (com refresh rotativo) para usuários do painel e chaves de API para integrações de lojista.
  • Fila de jobs persistente, com bloqueio em nível de linha para execução paralela segura.
  • Conexões seguras com os parceiros de processamento usando autenticação baseada em certificado.
  • Armazenamento de mídia em nuvem.
  • Telemetria de erros centralizada.
  • Idioma e fuso horário: pt-BR, America/Sao_Paulo. Todos os valores monetários são inteiros em centavos de BRL.

​
Para onde ir em seguida

Arquitetura

A arquitetura em camadas, o ciclo de vida das requisições e como o sistema de jobs e o sistema de webhooks se encaixam.

Modelo de dados unificado

O padrão da camada unificada. Por que ela existe e como os dados fluem até ela.

Autenticação

JWT, chaves de API de lojista, permissões e endpoints públicos.

Início rápido

Autentique-se, liste lojistas e faça sua primeira requisição.