Tipos de Contraparte
Para qué sirve esta pantalla
Un tipo de contraparte es una etiqueta para la clase de organización con la que intercambias: una red de tarjetas, un procesador, un regulador, un banco corresponsal. Esta pantalla es el catálogo del que salen esas etiquetas. Muestra dos clases de fila una junto a otra: los tipos Platform, definidos por el administrador de la plataforma y visibles para todos los tenants, y los tipos Custom, que pertenecen solo a tu tenant. Un tipo tiene un código, un nombre visible y una descripción opcional, y nada más.
Un tipo se elige para una contraparte externa en un extremo de un intercambio criptográfico, y ese es su único uso. La plataforma no autoriza, restringe ni enruta nada según él; es una clasificación para tu propia gobernanza, y su única consecuencia en la plataforma es que un tipo que un intercambio nombra en un extremo no se puede eliminar.
Qué debe existir antes
Esta pantalla es para los tenants que componen la autorización a mano. No se ofrece a los tenants SIMPLE, y el servidor rechaza los cambios de un tenant SIMPLE al catálogo aunque la solicitud llegue hasta él.
Antes de trabajar aquí necesitas:
- El permiso de listado de tipos de contraparte, que es lo que muestra el catálogo. Sin él, la pantalla lo indica y no muestra nada.
- Los permisos de creación, actualización y eliminación de tipos de contraparte, cada uno por separado. Sin el de creación, Nuevo tipo de contraparte aparece deshabilitado e indica qué permiso pedir; sin los otros dos, los controles de editar y eliminar de la fila están deshabilitados. En un tenant RAPIDAPI el control de creación no se muestra.
Nada necesita existir antes que un tipo. Es el extremo del intercambio el que toma el tipo, no al revés.
Decisiones que tomas aquí
Crear un tipo
Nuevo tipo de contraparte pide tres cosas:
- Code, obligatorio: letras mayúsculas, dígitos y guiones bajos, de 1 a 64 caracteres. El campo convierte a mayúsculas lo que escribes. El código es permanente una vez guardado.
- Display Name, obligatorio, hasta 128 bytes de texto. Es lo que el editor de intercambios muestra junto al código cuando se elige un tipo.
- Description, opcional, hasta 4000 bytes de texto (menos caracteres en alfabetos que usan varios bytes por carácter).
El código debe ser único dentro de tu catálogo. La creación se rechaza cuando tu tenant ya tiene ese código o cuando un tipo Platform lo lleva, porque un tipo propio con el código de un tipo Platform lo ocultaría en tu lista. Que otro tenant use el mismo código no es un conflicto y nunca se consulta.
Editar un tipo
El lápiz de una fila Custom cambia su nombre visible y su descripción. El código se muestra como solo lectura y no se puede cambiar por ningún medio: una solicitud que lo incluya se rechaza. El nombre visible no puede quedar en blanco. Vaciar la descripción la borra.
Una fila Platform no se puede editar desde esta pantalla: sus controles están deshabilitados con la nota Managed by platform, y el servidor rechaza el cambio de todos modos. Los tipos Platform los mantiene el administrador de la plataforma en la configuración de la plataforma.
Eliminar un tipo
La papelera de una fila Custom elimina el tipo de forma permanente después de que confirmas. La eliminación se rechaza cuando algún intercambio criptográfico de tu tenant nombra el tipo en un extremo, y el rechazo indica cuántos intercambios lo hacen. Un intercambio conserva sus extremos para siempre, aunque se revoque o se descarte, así que un tipo que un intercambio ha nombrado no se puede eliminar.
Un tipo Platform no se puede eliminar aquí.
Elegir un tipo es una decisión única
El tipo se elige en el paso Extremos del editor de intercambios, a partir de este catálogo, para un extremo que es una contraparte externa, y es opcional. Una vez activo el intercambio, sus extremos son de solo lectura: para cambiar uno, clona el intercambio. La lista de intercambios muestra el nombre de texto libre de la contraparte, no su tipo; la topología muestra el código del tipo bajo ese nombre.
Cómo se relaciona con otras pantallas
Un tipo existe para elegirse en el extremo externo de un intercambio, en el editor de intercambios:
La contraparte que nombra un extremo es texto libre, separado de su tipo. La lista de intercambios filtra por ese texto, y la topología dibuja una tarjeta por cada nombre y tipo de contraparte:
Dónde leer más
Estas páginas están en inglés: