Sobre o produto
O Marketplace da Zipdin é um leilão: conecta solicitações de crédito de trabalhadores a parceiros financeiros que competem em tempo real por cada operação. Diferente do E-Consignado (onde o contratante integra módulos de uma jornada própria), aqui o parceiro não estrutura canal de aquisição — ele só assume o negócio quando vence o leilão. Para quem é: parceiros financeiros que querem originar crédito do trabalhador sem estruturar canal próprio de aquisição.Todos os endpoints requerem autenticação via Bearer token no header
Authorization.
Consulte o guia de autenticação para obter suas credenciais e gerar um token.URL Base
Todas as chamadas ficam sob o prefixo/zipconsig-marketplace:
- Homologação
- Produção
As chamadas exigem autenticação via JWT Bearer (
Authorization: Bearer <token>), exceto a busca
pública de ofertas (POST /offers/search). Este serviço não usa x-api-key nem x-idempotency-key.Como funciona o leilão
O pedido de crédito do trabalhador entra na plataforma Zipdin por uma fila interna de folha de pagamento (sem chamada HTTP externa). A partir daí, o parceiro atua nestas etapas:1
Analisar solicitação
POST /requests/:id/analyzeA Zipdin distribui a solicitação aos parceiros elegíveis; o parceiro aprova ou nega participar.
2
Calcular oferta
POST /offers-calculationSimula/valida as condições em faixa (mín/máx) antes de confirmar — opcional.
3
Criar oferta
POST /offersEnvia a oferta de condições que vai competir no leilão.
4
Acompanhar o leilão
POST /auctions/searchA Zipdin executa a competição entre as ofertas e define a vencedora.
5
Averbar a oferta vencedora
PATCH /offers/:id/endorseO parceiro vencedor assume a operação e averba a oferta.
Mapa de Chamadas
Formato de resposta. O Marketplace usa HATEOAS: respostas trazem
_links e _embedded, e as
listagens paginadas usam total, pageStart, pageSize, totalPages com os itens em _embedded[].