LacunaSoftware · samuelb-lacuna · Feb 4, 2026 · Feb 4, 2026
diff --git a/docs.en-us/articles/rest-pki/core/changelog.md b/docs.en-us/articles/rest-pki/core/changelog.md
@@ -1,6 +1,98 @@
 # Rest PKI Core changelog
 
 <!--<a name="vnext" />-->
+<a name="v4-0-0" />
+## 4.0.0 (2026-02-XX)
+
+> [!WARNING]
+> See [Update Rest PKI Core from 3.x to 4.0](on-premises/update-40.md)
+
+Updates database model: **yes**
+
+### New features
+
+RPNG-273 Create a billing flow for a subscription
+
+RPNG-347, RPNG-497 Improvements to FaceTec transactions
+
+RPNG-484 Option to use biometric sessions with URL return, similar to signature sessions
+
+RPNG-488 Add timeout configuration for biometric sessions
+
+RPNG-505 List of accepted ReturnUrls for BioSession
+
+RPNG-511 Video Identification – Receive expected document values (type/number)
+
+### Improvements
+
+RPNG-270 Added signature session list page
+
+RPNG-405 Improvements to the biometric sessions home screen and customizations
+
+RPNG-430 Add timestamp marks in Spanish
+
+RPNG-435 Biometrics Dashboard – Add visualization of biometric session images
+
+RPNG-443, RPNG-448, RPNG-450 Updated Angular to version 19
+
+RPNG-472 Add AgentId that created the BioSession
+
+RPNG-474 Add Swagger fields for biometric sessions
+
+RPNG-481 Add button to copy generated API key
+
+RPNG-486 Display user-friendly error messages in biometric sessions
+
+RPNG-490 Customization of colors and logo of biometric sessions per subscription
+
+RPNG-507 Video identification information via API
+
+RPNG-509 Improvements to OCR templates for passports
+
+RPNG-515 FaceTec SDK updates
+
+RPNG-508 Add success field in the FaceTec section of the dashboard
+
+### Bug fixes
+
+RPNG-258 Fields from PadesSignaturePostRequestBase being ignored
+
+RPNG-487 Biometric session starts as "Failed" on the dashboard
+
+RPNG-512 Video Identification – Fix success condition in video identification
+
+RPNG-525 Video Identification – Issue when recording/sending video
+
+RPNG-527 Sessions stuck in "loading" on iOS 26.2 devices
+
+
+
+<a name="v3-7-0" />
+## 3.7.0 (2025-11-26)
+
+Updates database model: **yes**
+
+### Improvements
+
+RPNG-453 Improved FortFace liveness enrollment images
+
+
+<a name="v3-6-2" />
+## 3.6.2 (2025-11-24)
+
+Updates database model: no
+
+### New features
+
+RPNG-394 Biometrics dashboard - Bio subject details page
+
+### Improvements
+
+RPNG-428 Updated FortFace SDKs
+
+RPNG-454 Add InteractionMethod to BioSessionModel on BioDashBoard
+
+
 <a name="v3-6-1" />
 ## 3.6.1 (2025-11-20)
 

diff --git a/docs.en-us/articles/rest-pki/core/on-premises/update-40.md b/docs.en-us/articles/rest-pki/core/on-premises/update-40.md
@@ -0,0 +1,111 @@
+# Update Rest PKI Core from 3.x to 4.0
+
+## 1. Decide if you need to create indexes manually
+
+If your instance has a **large number of Signature Sessions or Transactions (millions)**, it is recommended to manually create some of the indexes required for version 4.0 **before updating**, proceeding to step 2.
+
+If your instance **does not meet these conditions**, you may skip step 2 and **proceed directly to step 3**.
+
+## 2. Create the indexes manually
+
+### Using SQL Server
+
+Execute the following commands on your SQL Server database one at a time, ensuring that each command completes successfully before running the next one.
+
+```SQL
+IF NOT EXISTS (
+	SELECT 1 
+	FROM sys.columns 
+	WHERE [name] = 'DateSignaturesStartedUtc'
+	  AND [object_id] = OBJECT_ID('SignatureSessions')
+)
+BEGIN
+	ALTER TABLE [SignatureSessions] 
+	ADD [DateSignaturesStartedUtc] datetime2 NULL;
+END
+
+IF NOT EXISTS (
+	SELECT 1 FROM sys.indexes 
+	WHERE name = 'IX_SignatureSessions_DateCompletedUtc_DateSignaturesStartedUtc'
+	  AND object_id = OBJECT_ID('dbo.SignatureSessions')
+)
+CREATE INDEX [IX_SignatureSessions_DateCompletedUtc_DateSignaturesStartedUtc]
+ON [SignatureSessions] ([DateCompletedUtc], [DateSignaturesStartedUtc]);
+
+IF NOT EXISTS (
+	SELECT 1 FROM sys.indexes 
+	WHERE name = 'IX_SignatureSessions_DateCreatedUtc_DateCompletedUtc'
+	  AND object_id = OBJECT_ID('dbo.SignatureSessions')
+)
+CREATE INDEX [IX_SignatureSessions_DateCreatedUtc_DateCompletedUtc]
+ON [SignatureSessions] ([DateCreatedUtc], [DateCompletedUtc]);
+
+IF NOT EXISTS (
+	SELECT 1 FROM sys.indexes 
+	WHERE name = 'IX_SignatureSessions_StatusCode_DateCreatedUtc'
+	  AND object_id = OBJECT_ID('dbo.SignatureSessions')
+)
+CREATE INDEX [IX_SignatureSessions_StatusCode_DateCreatedUtc]
+ON [SignatureSessions] ([StatusCode], [DateCreatedUtc]);
+
+IF NOT EXISTS (
+	SELECT 1 FROM sys.indexes 
+	WHERE name = 'IX_SignatureSessions_SubscriptionId_DateCreatedUtc'
+	  AND object_id = OBJECT_ID('dbo.SignatureSessions')
+)
+CREATE INDEX [IX_SignatureSessions_SubscriptionId_DateCreatedUtc]
+ON [SignatureSessions] ([SubscriptionId], [DateCreatedUtc]);
+
+IF NOT EXISTS (
+	SELECT 1 FROM sys.indexes 
+	WHERE name = 'IX_SignatureSessions_SubscriptionId_StatusCode_DateCreatedUtc'
+	  AND object_id = OBJECT_ID('dbo.SignatureSessions')
+)
+CREATE INDEX [IX_SignatureSessions_SubscriptionId_StatusCode_DateCreatedUtc]
+ON [SignatureSessions] ([SubscriptionId], [StatusCode], [DateCreatedUtc]);
+
+IF NOT EXISTS (
+	SELECT 1 FROM sys.indexes 
+	WHERE name = 'IX_Documents_DateCreatedUtc'
+	  AND object_id = OBJECT_ID('dbo.Documents')
+)
+CREATE INDEX [IX_Documents_DateCreatedUtc]
+ON [Documents] ([DateCreatedUtc]);
+
+IF NOT EXISTS (
+	SELECT 1 FROM sys.indexes 
+	WHERE name = 'IX_Documents_SubscriptionId_DateCreatedUtc'
+	  AND object_id = OBJECT_ID('dbo.Documents')
+)
+CREATE INDEX [IX_Documents_SubscriptionId_DateCreatedUtc]
+ON [Documents] ([SubscriptionId], [DateCreatedUtc]);
+```
+
+### Using Postgres
+
+Execute the following commands on your PostgreSQL database one at a time, ensuring that each command completes successfully before running the next one.
+
+```SQL
+
+ALTER TABLE "SignatureSessions" ADD COLUMN IF NOT EXISTS "DateSignaturesStartedUtc" timestamptz DEFAULT NULL;
+
+CREATE INDEX IF NOT EXISTS "IX_SignatureSessions_DateCompletedUtc_DateSignaturesStartedUtc" ON "SignatureSessions" ("DateCompletedUtc", "DateSignaturesStartedUtc");
+
+CREATE INDEX IF NOT EXISTS "IX_SignatureSessions_DateCreatedUtc_DateCompletedUtc" ON "SignatureSessions" ("DateCreatedUtc", "DateCompletedUtc");
+
+CREATE INDEX IF NOT EXISTS "IX_SignatureSessions_StatusCode_DateCreatedUtc" ON "SignatureSessions" ("StatusCode", "DateCreatedUtc");
+
+CREATE INDEX IF NOT EXISTS "IX_SignatureSessions_SubscriptionId_DateCreatedUtc" ON "SignatureSessions" ("SubscriptionId", "DateCreatedUtc");
+
+CREATE INDEX IF NOT EXISTS "IX_SignatureSessions_SubscriptionId_StatusCode_DateCreatedUtc" ON "SignatureSessions" ("SubscriptionId", "StatusCode", "DateCreatedUtc");
+
+CREATE INDEX IF NOT EXISTS "IX_Documents_DateCreatedUtc" ON "Documents" ("DateCreatedUtc");
+
+CREATE INDEX IF NOT EXISTS "IX_Documents_SubscriptionId_DateCreatedUtc" ON "Documents" ("SubscriptionId", "DateCreatedUtc");
+```
+
+## 3. Update Rest PKI Core
+
+Proceed with the standard update instructions:
+- [Docker](docker.md): Update to `lacunasoftware/restpkicore:4.0` image.
+- [Linux](linux/update.md)
diff --git a/docs.en-us/articles/toc.md b/docs.en-us/articles/toc.md
@@ -132,6 +132,7 @@
 #### [Creating a subscription](rest-pki/core/on-premises/create-sub.md)
 #### [Checking the installed version](rest-pki/core/on-premises/check-version.md)
 #### [Update to 3.0](rest-pki/core/on-premises/update-30.md)
+#### [Update to 4.0](rest-pki/core/on-premises/update-40.md)
 #### [Logging](rest-pki/core/on-premises/logging.md)
 #### [Vulnerability checks](rest-pki/core/on-premises/vulnerabilities.md)
 ### [Operation guide](rest-pki/core/operation/index.md)

diff --git a/docs.pt-br/articles/rest-pki/core/changelog.md b/docs.pt-br/articles/rest-pki/core/changelog.md
@@ -1,6 +1,99 @@
 # Histórico de versões - Rest PKI Core
 
 <!--<a name="vnext" />-->
+<a name="v4-0-0" />
+## 4.0.0 (2026-02-XX)
+
+> [!WARNING]
+> Veja [Atualizando o Rest PKI Core da versão 3.x para 4.0](on-premises/update-40.md)
+
+Atualiza modelo do banco de dados: **sim**
+
+### Novas funcionalidades
+
+RPNG-273 Criar fluxo de faturamento para uma subscription
+
+RPNG-347, RPNG-497 Melhorias nas transações FaceTec
+
+RPNG-484 Opção de utilizar sessões de biometria com retorno de URL assim como nas de assinatura
+
+RPNG-488 Adicionar configuração de Timeout para sessão de biometria
+
+RPNG-505 Lista de ReturnUrl aceitas para BioSession
+
+RPNG-511 Vídeo Identificação - Receber valores esperados do documento (tipo/número)
+
+### Melhorias
+
+RPNG-270 Interface com listagem das sessões de assinatura
+
+RPNG-405 Melhorias na tela inicial das sessões de biometria e customizações
+
+RPNG-430 Marcas de carimbo de tempo em espanhol
+
+RPNG-435 Dashboard de Biometria - Adicionar visualização de imagens das sessões biométricas
+
+RPNG-443, RPNG-448, RPNG-450 Atualizações do Angular para versão 19
+
+RPNG-472 Adicionar AgentId que criou a BioSession
+
+RPNG-474 Campos Swagger para sessões de biometria
+
+RPNG-481 Adicionar botão de copiar chave de API gerada
+
+RPNG-486 Apresentar mensagem de erro amigável nas sessões de biometria
+
+RPNG-490 Customização das cores e logo da sessão de biometria por subscription
+
+RPNG-507 Informações da vídeo identificação via API
+
+RPNG-509 Melhorias nos templates OCR para passaporte
+
+RPNG-515 Atualizações dos SDKs da FaceTec
+
+RPNG-508 Adicionar campo de sucesso na seção FaceTec no dashboard
+
+### Correções de bugs
+
+RPNG-258 Campos do PadesSignaturePostRequestBase sendo ignorados
+
+RPNG-487 Sessão de biometria começa como "Falha" no dashboard
+
+RPNG-512 Vídeo Identificação - Correção da condição de sucesso na vídeo identificação
+
+RPNG-525 Vídeo Identificação - Problema ao gravar/enviar vídeo
+
+RPNG-527 Sessões ficam presas em "loading" em dispositivos IOS 26.2
+
+
+
+<!-- TODO -->
+<a name="v3-7-0" />
+## 3.7.0 (2025-11-26)
+
+Atualiza modelo do banco de dados: **sim**
+
+### Melhorias
+
+RPNG-453 Melhorar fotos de enrollment com liveness FortFace
+
+
+<a name="v3-6-2" />
+## 3.6.2 (2025-11-24)
+
+Atualiza modelo do banco de dados: não
+
+### Novas funcionalidades
+
+RPNG-394 Dashboard de Biometria - Tela de detalhamento de BioSubjects
+
+### Melhorias
+
+RPNG-428 Atualizar SDKs da FortFace
+
+RPNG-454 Adicionar InteractionMethod no BioSessionModel para BioDashBoard
+
+
 <a name="v3-6-1" />
 ## 3.6.1 (2025-11-20)
 

diff --git a/docs.pt-br/articles/rest-pki/core/on-premises/update-40.md b/docs.pt-br/articles/rest-pki/core/on-premises/update-40.md
@@ -0,0 +1,4 @@
+# Atualizando o Rest PKI Core da versão 3.x para 4.0
+
+<!-- link to version in English -->
+<div data-alt-locales="en-us"></div>
diff --git a/docs.pt-br/articles/toc.md b/docs.pt-br/articles/toc.md
@@ -135,6 +135,7 @@
 #### [Criando uma organização](rest-pki/core/on-premises/create-sub.md)
 #### [Verificando a versão instalada](rest-pki/core/on-premises/check-version.md)
 #### [Atualizando para 3.0](rest-pki/core/on-premises/update-30.md)
+#### [Atualizando para 4.0](rest-pki/core/on-premises/update-40.md)
 #### [Logs](rest-pki/core/on-premises/logging.md)
 #### [Verificações de vulnerabilidades](rest-pki/core/on-premises/vulnerabilities.md)
 ### [Guia de Operação](rest-pki/core/operation/index.md)