PLATAFORMA ABERTA
APIs e eventos para construir sobre o ecossistema
Comandos imediatos por API síncrona; propagação de factos por eventos assíncronos. Tudo idempotente, versionado e observável.
PRINCÍPIOS
Integração previsível
APIs versionadas
Campos novos são opcionais; o que sai fica @deprecated com janela clara de descontinuação.
Idempotência
Idempotency keys em encomendas, bilhetes e pagamentos — repetir não duplica.
Webhooks fiáveis
Retries com backoff, dead-letter queue e reconciliação.
CONTRATOS CANÓNICOS
O catálogo de eventos
Factos do ecossistema, propagados de forma consistente entre produtos.
Identidade & organizações
identity.linkedUma identidade ligada a um registo existente.organization.createdUma nova organização criada.membership.changedFunção ou estado de um membro alterado.
Subscrições & acesso
subscription.activatedContrato ativado para uma organização.entitlement.changedDireito de acesso a produto ou módulo alterado.usage.recordedMétrica contabilizável registada.
Clientes
customer.createdNovo cliente, com source_system e source_id.customer.updatedPerfil de cliente atualizado.customer.mergedPerfis deduplicados e fundidos.
Vifkart
order.createdEncomenda criada.order.paidEncomenda paga e confirmada.order.cancelledEncomenda cancelada.order.refundedEncomenda reembolsada.
Ventus
ticket.reservedBilhete reservado, capacidade retida.ticket.issuedBilhete emitido, com QR.ticket.validatedBilhete validado no check-in.ticket.cancelledBilhete cancelado.
Pagamentos
payment.pendingPagamento pendente de liquidação.payment.succeededPagamento concluído.payment.failedPagamento falhado.settlement.completedLiquidação concluída pelo parceiro.
Inventário
inventory.reservedStock reservado, com versão e motivo.inventory.adjustedStock ajustado.inventory.releasedReserva libertada.
VENDASOS LAB
Um lab para experimentar sem medo.
Sandboxes por organização, com dados fictícios e chaves de teste — constrói e testa integrações contra o ecossistema inteiro sem tocar em produção.
Sandbox por organização
Ambiente isolado com a tua loja, eventos e clientes fictícios — um espelho seguro da produção.
Chaves e modos de teste
Credenciais de teste com os mesmos contratos de API e eventos; trocar para produção é trocar a chave.
Pagamentos simulados
Fluxos de pagamento, disputa e reembolso simulados de ponta a ponta — sem dinheiro real.
Replay de webhooks
Reenvia eventos, inspeciona payloads e testa idempotência sem esperar por tráfego real.
Anti-corruption layer
Adapters traduzem os modelos atuais da Vifkart e do Ventus para contratos canónicos — o modelo novo fica protegido das particularidades dos sistemas existentes.
Constrói com contratos estáveis
Fala connosco sobre acesso a APIs, eventos e ambientes de teste.