1. Tercero Vinculado
Firmasegura
  • Inicio
    • Introducción
    • Autenticación
  • Firmas Regulares
    • Firmas Regulares
    • Registrar solicitud
      POST
    • Consulta de estado de solicitud
      GET
    • Corrección de código dactilar y/o adjuntos
      PATCH
    • Schemas
      • RequestResult
      • RequestStatusValidation
      • RevocationRequest
  • Firmas Transaccionales
    • Firmas Transaccionales
    • Eventos webhook
    • Registrar solicitud
      POST
    • Consulta estado de validación
      GET
    • Obtención de certificado y resultados
      GET
    • Schemas
      • TransactionalSignatureValidationStatus
      • TransactionalSignatureProcessResult
  • Tercero Vinculado
    • Tercero Vinculado
    • Eventos webhook
    • Registrar solicitud
      POST
    • Reintentar proceso de generación
      POST
    • Cancelación de solicitud
      POST
    • Reenviar correo para reclamar certificado
      POST
    • Consultar estado de solicitud
      GET
    • Schemas
      • LinkedPartnerRequest
      • LinkedPartnerResult
      • linkedPartnerRequest
      • RAIZ
  • Flujo simplificado
    • Introducción
    • Eventos Webhook
    • Registrar solicitud
      POST
    • Consultar estado
      GET
  • Flujo por API
    • Flujo Por API
    • Consulta de TyC
    • Solicitud de Firma
    • Validación de Identidad
    • Solicitud de FaceLiveness
    • FaceLiveness
    • Emisión
    • Schemas
      • ApiError
  • Recursos Adicionales
    • Lista de ciudades y provincias
    • Lista de periodos de firmas
    • Lista de estados de revocación
    • Lista de estados de solicitud FR
    • Lista de tipos de solicitud FR
    • Estados de validación de solicitudes FR
    • Tipos de validación de solicitudes FR
    • Códigos de error de validación FR
    • Lista de estados de solicitud FT
    • Lista de estados de validacion FT
    • Lista de tipos de validación FT
    • Lista de tipos de Certificado TV
    • Lista de estados de solicitud TV
    • Tipo de Evidencias TV
    • Lista de Estados de FS
    • Tipos de Solicitudes
  1. Tercero Vinculado

Registrar solicitud

POST
https://api.dev-firmaseguraec.com/collector/linked-partner/request
Última modificación:2026-05-20 20:49:06
Este método permite crear una solicitud de firma tanto transaccional como tradicional, dentro del flujo de solicitudes de terceros vinculados.

Observaciones#

El envío del campo password, NO es OBLIGATORIO solo sí se ha comunicado que se utilizará la configuración de OTP de FirmaSeguraEC, en caso de tener su propio proceso de recepción de firma, debe comunicarlo a FirmaSeguraEC, para que se use la configuración normal, recibiendo el password en la solicitud.

Casos Especiales#

En el caso de que se emita una Firma Tradicional para Representante Legal, los campos companyRuc, positionCompany, companySocialReason y expirationDateAppointment son OBLIGATORIOS.
Si el campo certificateType es TRANSACTIONAL_SIGNATURE, el campo applicationType solo puede ser NATURAL_PERSON y además no es necesario enviar el campo Period.
Si el certificateType es TRANSACTIONAL_SIGNATURE el campo period solo puede ser ONE_WEEK.
El campo password es OBLIGATORIO, solo cuando el campo certificateType es TRADITIONAL_SIGNATURE, y cuando se cumple con la configuración.

Solicitud

Autorización
Proporciona tu token bearer en el encabezado
Authorization
al realizar solicitudes a recursos protegidos.
Ejemplo:
Authorization: Bearer ********************
Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟠409Error de solicitud existente
application/json
Indica que la solicitud no pudo completarse debido a un conflicto con el estado actual del recurso, esto suele pasar cuando se envía una solicitud con referenceTransaction repetida.
Bodyapplication/json

🟢200Solicitud Correcta
🟢200Solicitud con errores
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.dev-firmaseguraec.com/collector/linked-partner/request' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "identificationNumber": "1023456101",
    "applicantName": "John",
    "applicantLastName": "Doe",
    "applicantSecondLastName": "Doe",
    "fingerCode": "V4444V4448",
    "email": "example@example.com",
    "secondEmail": "backup.mail@example.com",
    "cellphoneNumber": "+593998598514",
    "city": "Salcedo",
    "address": "Av. Amazonas 123 y Colón, Edif. Torre Azul",
    "documentType": "CI",
    "applicationType": "NATURAL_PERSON",
    "referenceTransaction": "TRADI-TEST-00003",
    "period": "FOUR_YEARS",
    "certificateType": "TRADITIONAL_SIGNATURE",
    "evidences": [
        {
            "evidenceFile": "ewogICJpZGVudGlmaWNhdGlvbk51bWJlciI6ICIxMjM0NTY3ODkwIiwKICAiYXBwbGljYW50TmFtZSI6ICJKb3N1ZSIsCiAgImFwcGxpY2FudExhc3ROYW1lIjogIk1vcmFsZXMiLAogICJhcHBsaWNhbnRTZWNvbmRMYXN0TmFtZSI6ICJMbGFuZ2FuYXRlIiwKICAiZmluZ2VyQ29kZSI6ICJGSU5HRVItMDAxIiwKICAiZW1haWwiOiAiam9zdWUubW9yYWxlc0BleGFtcGxlLmNvbSIsCiAgImNvbXBhbnlSdWMiOiAiMDU5MDAxMjM0NTAwMSIsCiAgInBvc2l0aW9uQ29tcGFueSI6ICJEZXNhcnJvbGxhZG9yIGRlIFNvZnR3YXJlIiwKICAiY29tcGFueVNvY2lhbFJlYXNvbiI6ICJNaSBlbXByZXNhIFMuQS4iCn0K",
            "validatorUrl": "link-validacion.com"
        }
    ],
    "password": "test123",
    "callbackUrl": "https://play.svix.com/in/e_msAhdrcE7oslKrfJ1YoHB5shn4d/"
}'
Respuesta Ejemplo de Respuesta
409 - Éxito
{
    "timestamp": "2025-12-11 09:24:42",
    "status": 409,
    "error": "Conflict",
    "message": "Ya existe una solicitud con id de transacción: TRADI-LEGAL-10000",
    "path": "/linked-partner/request"
}
Modificado en 2026-05-20 20:49:06
Anterior
Eventos webhook
Siguiente
Reintentar proceso de generación
Built with