Skip to content

Gestionar los tipos de contraparte

Mantén el catálogo de tu tenant de los tipos de organización con los que intercambias datos, como redes de tarjetas, procesadores o reguladores. Un tipo de contraparte clasifica el extremo externo de un intercambio criptográfico.

Quién puede hacerlo

Un administrador del tenant, un gestor de claves del tenant, o un superadministrador de plataforma desde dentro del tenant, donde la consola actúa como administrador del tenant. Crear, cambiar y eliminar un tipo son tres permisos distintos; la consola ofrece Nuevo tipo de contraparte solo con el permiso para crear, y habilita los controles de edición y eliminación de una fila solo con el permiso correspondiente. Los tres roles los tienen.

La pantalla es para los tenants STANDARD: un tenant SIMPLE no la ve y no tiene catálogo propio, y en un tenant RAPIDAPI la consola no ofrece crear un tipo.

Antes de empezar

  • El catálogo muestra dos clases de tipo, en su columna Alcance. Los tipos Personalizado son tuyos. Los tipos Plataforma los publica el administrador de la plataforma para todos los tenants; están marcados como Gestionado por la plataforma y no se pueden cambiar ni eliminar aquí.
  • Elige un código: letras mayúsculas, dígitos y guiones bajos, de 1 a 64 caracteres, por ejemplo REGULATOR_CO. No se puede cambiar después de crear el tipo, y no puede repetir un código que tu tenant ya tiene ni el código de un tipo de la plataforma.
  • Un tipo que nombra el extremo externo de cualquiera de tus intercambios no se puede eliminar, porque un intercambio conserva sus extremos para siempre, incluso después de revocarse o descartarse.

Pasos

  1. Abre Tipos de contraparte desde la navegación del tenant.
  2. Para crear un tipo:
    1. Selecciona Nuevo tipo de contraparte.
    2. Escribe el Código y el Nombre visible, y de forma opcional una Descripción (opcional).
    3. Selecciona Crear.
  3. Para cambiar un tipo, selecciona Editar en su fila, cambia el Nombre visible o la Descripción (opcional), y selecciona Guardar. El código se muestra como Código (solo lectura).
  4. Para eliminar un tipo, selecciona Eliminar en su fila y luego Eliminar en la confirmación.

Qué ves cuando funcionó

La consola lo confirma con Tipo de contraparte creado, Tipo de contraparte actualizado o Tipo de contraparte eliminado, y el Catálogo de tipos de contraparte muestra el cambio. Un tipo nuevo aparece con el alcance Personalizado, y se puede elegir como tipo de una contraparte externa en el paso Extremos del editor de intercambios.

Si falla

Qué ves Causa Qué hacer
Usa letras MAYÚSCULAS, dígitos y guiones bajos (de 1 a 64 caracteres). El código no tiene la forma requerida Corrige el código
Crear sigue sin estar disponible El código no es válido, el nombre visible está vacío, o un campo supera su límite de tamaño Corrige el campo
La creación se rechaza porque el código ya está en uso Tu tenant ya tiene el código, o lo usa un tipo de la plataforma Elige otro código
La eliminación se rechaza porque el tipo es el tipo de extremo de intercambios criptográficos (Counterparty type '<code>' is an endpoint type of <n> Cryptographic Exchanges. …) Intercambios de tu tenant nombran el tipo en un extremo externo Conserva el tipo; no se puede eliminar mientras algún intercambio lo nombre
Editar y eliminar no están disponibles en una fila, con Gestionado por la plataforma Es un tipo de la plataforma Pregunta al administrador de la plataforma

Sin la consola

Superficie Cómo
CLI de gestión de claves Ningún comando crea, cambia ni elimina un tipo de contraparte. ankasecure-km directory list-counterparty-types y directory get-counterparty-type --id <uuid> los leen
Admin SDK Ningún método crea, cambia ni elimina un tipo de contraparte. DirectoryOperations.listCounterpartyTypes() y DirectoryOperations.getCounterpartyType(UUID) los leen
API POST /api/v3/admin/tenants/{tenantId}/counterparty-types (operación createCounterpartyType); PUT /api/v3/admin/tenants/{tenantId}/counterparty-types/{id} (operación replaceCounterpartyType); DELETE /api/v3/admin/tenants/{tenantId}/counterparty-types/{id} (operación deleteCounterpartyType)

Relacionado