ZapSign API
Español
Español
  • Información General
  • Antes de empezar
  • Entornos de ZapSign
  • Solicitudes listas para usar
  • Autenticación
    • Token estático
    • Autenticación JWT
      • Obtener el access token
      • Actualizar access token
  • Tipos de Tokens
  • Versiones de la API
  • Políticas de Rate Limit
  • Alertas de Incidentes
  • Cómo Funciona el Pago
  • Códigos de estado
  • Cuenta
    • Información del Plan
    • Listar usuarios de la cuenta
    • Crear usuarios en la cuenta
    • Eliminar usuario de la cuenta
  • Documentos
    • Crear documento via Upload
    • OneClick - Clickwrap
      • Crear documento (OneClick)
    • Crear documento via Plantilla
    • Adicionar documento (sobre)
    • Adicionar documento extra via Plantilla
    • Detalle del documento
    • Listar documentos
    • Eliminar documento
    • Histórico de eventos
    • Posicionar firma (opcional)
    • Rechazar documentos
  • Validación de firmas
  • Firmantes
    • Detalles del firmante
    • Actualizar firmante
    • Adicionar firmante
    • Eliminar firmante
    • Firma en lote via API
    • Rechazar documentos por el usuario
  • Plantillas
    • Crear plantilla DOCX
      • Configurar formulario de plantilla
    • Listar plantillas
    • Actualizar plantilla
    • Eliminar plantilla
  • Aliados / Re-sellers
    • Actualizar estado de pago
    • Crear cuenta
  • Antecedentes
    • Introducción
    • Entendiendo el resultado
  • Crear un consulta (check)
    • Consulta de persona
    • Consulta de empresa
  • Consultar check
  • Detalle del check
  • Webhooks
    • ¿Cómo funcionan los webhooks?
    • Probar webhooks en ZapSign
    • Crear Webhook
    • Registro de Webhooks
    • Eventos
      • De documento
        • Doc creado
        • Doc eliminado
        • Firmante creado
      • De firmantes
        • Solicitud de firma enviada
        • Doc visualizado
        • Confirmación lectura
        • Doc firmado
        • Doc rechazado
        • Email bounce
        • Validación Fallida
      • De antecedentes
        • Consulta completada
    • Reprocesando documentos y webhooks
    • Eliminar Webhook
  • Widget
    • iFrame: ¿cómo funciona?
Powered by GitBook
On this page
  • Cómo funciona
  • Facturación y gestión de cuentas asociadas
  • Crear una cuenta de socio
  • Response

Was this helpful?

  1. Aliados / Re-sellers

Crear cuenta

Este endpoint permite que você crie contas separadas para diferentes clientes ou departamentos da sua empresa, mantendo todos eles sob o controle da sua conta principal (parceira ou reseller).

PreviousActualizar estado de pagoNextIntroducción

Last updated 25 days ago

Was this helpful?

Esta estructura es ideal para socios que desean gestionar múltiples operaciones dentro de una única estructura, manteniendo:

  • Separación de documentos y usuarios por cuenta;

  • Permisos ajustados por equipo o cliente;

  • Informes y consumo organizados por unidad;

  • Integraciones independientes para cada cuenta (con tokens únicos por cuenta).

Importante: Solo las cuentas con esta funcionalidad activa podrán utilizar este endpoint. Si aún no tienes acceso,

Cómo funciona

Al hacer una solicitud a este endpoint:

  1. Se creará una nueva cuenta (organización) dentro de ZapSign.

  2. El propietario de la cuenta principal (quien realiza la solicitud) también será el propietario de la nueva cuenta creada. Esto garantiza control total sobre las cuentas asociadas.

  3. El correo electrónico proporcionado en la solicitud se agregará a la nueva cuenta con el rol de Miembro. En caso de no enviar un correo electrónico, la nueva cuenta sólo tendrá un usuario que es el propietario.

    • Un Miembro puede ver todos los documentos de la cuenta, pero no tiene acceso a la configuración de la plataforma.

  4. En caso de informar un correo electrónico en la requisición, el usuario invitado recibirá un correo electrónico de ZapSign para crear una contraseña y acceder a su cuenta.

Facturación y gestión de cuentas asociadas

⚠️ Atención: Todo el consumo de las cuentas asociadas será responsabilidad de la cuenta principal (socio).

Esto incluye:

  • Creación de documentos;

  • Consultas de antecedentes;

  • Envío de documentos por WhatsApp;

  • Métodos de autenticación avanzada (como reconocimiento facial, certificado digital, etc.).

La cuenta principal tendrá acceso a un panel consolidado con todo el consumo y los documentos generados por las cuentas asociadas.

Si es necesario suspender temporalmente el acceso a una cuenta asociada, puedes utilizar el endpoint Actualizar estado de pago.

Crear una cuenta de socio

POST https://api.zapsign.com.br/api/v1/partner/company/

Headers

Name
Type
Description

Authorization*

string

Token de API precedido por el texto "Bearer". Ejemplo: Bearer c7f35c84-7893-4087-b4fb-d1f06c23

Request Body

Name
Type
Description

email

string

Correo electrónico del nuevo usuario que será añadido como miembro.

country*

string

País de la nueva cuenta. Valores posibles: br, mx, co, pe, cl

lang*

string

Idioma de la nueva empresa. Opciones: "pt-br" (portugués), "es" (español), "en" (inglés). Por defecto: "pt-br"

company_name*

string

Nombre de la nueva empresa.

phone_country

string

Código de país del número de teléfono del nuevo usuario.

phone_number

string

Número de teléfono del nuevo usuario.

{
    "email": "email@email",
    "phone_number": "11111111111",
    "phone_country": "55",
    "country": "co",
    "lang": "es",
    "company_name": "New Company LTDA"
}

Response

{
    "id": 543,
    "name": "New Company LTDA",
    "api_token": "010234xx-23ed-44ab-8b57-9XXXXe03cc5e-cc71-4911-bf29-3bxxxx140540",
    "created_at": "2025-04-04T22:35:16.821400Z",
    "credits_balance": 0,
    "lang": "es",
    "timezone": "America/Bogota"
}
{
    "message": "Invalid Input",
    "data": {
        "email": [
            "Este campo es requerido."
        ],
        "country": [
            "Este campo es requerido."
        ],
        "lang": [
            "Este campo es requerido."
        ],
        "company_name": [
            "Este campo es requerido."
        ]
    }
}
{
    "detail": "No tienes permisos para realizar esta acción."
}
{
    "detail": "Plan necesario para crear empresa parceira."
}
{
    "detail": "Acción no permitida para empresa parceira."
}

Cada cuenta creada puede tener su propia integración independiente con la API de ZapSign, completamente separada de las demás.

ponte en contacto con el equipo comercial.