Skip to main content

Documentation Index

Fetch the complete documentation index at: https://transfiya.me/llms.txt

Use this file to discover all available pages before exploring further.

​
Introducción

La gestión de llaves en los Sistemas de Pago de Bajo Valor Inmediatos (SPBVI) constituye un elemento esencial para garantizar la seguridad, la interoperabilidad y la trazabilidad de las operaciones financieras entre clientes y participantes. En este marco, la funcionalidad de bloqueo de llaves se establece como un mecanismo preventivo que permite suspender temporalmente el uso de una llave asociada a un medio de pago, con el fin de mitigar riesgos asociados a fraude, suplantación, inactividad del medio de pago u otras situaciones que puedan comprometer la confianza del ecosistema. De acuerdo con la Circular Reglamentaria Externa DSP-465 del Banco de la República, el bloqueo puede ser solicitado directamente por el cliente o ejecutado por el participante únicamente en los casos autorizados: suspensión del medio de pago por riesgos de seguridad o cuando este sea clasificado como inactivo. En ambos escenarios, los participantes tienen la obligación de informar a la Entidad Administradora del Sistema de Pago de Bajo Valor Inmediato (EASPBVI), la cual debe reflejar en tiempo real la novedad en el Directorio Federado y posteriormente en el Directorio Centralizado, asegurando así la consistencia y disponibilidad de la información en todo el sistema. En este sentido, el participante adquiere responsabilidades claras:
  • Adecuar sus canales de servicio para permitir al cliente el ejercicio pleno de la funcionalidad de bloqueo y reactivación de sus llaves.
  • Informar de manera oportuna y transparente al cliente sobre las implicaciones del bloqueo, su alcance y los procedimientos asociados.
  • Cumplir estrictamente con las normas de seguridad y protección de datos personales previstas en la Ley 1581 de 2012 y sus reglamentos.
  • Reportar de inmediato a la EASPBVI las novedades generadas en los procesos de gestión de llaves, en cumplimiento de los tiempos y lineamientos operativos definidos por el Banco de la República.
De esta forma, la implementación del bloqueo de llaves no solo contribuye a la protección de los usuarios, sino que refuerza la responsabilidad de los participantes en la administración segura y transparente de los medios de pago dentro de los SPBVI, fortaleciendo la confianza en la infraestructura de pagos inmediata del país.

​
Ejemplo de bloqueo de llaves por participante

A continuación se presenta un ejemplo de bloqueo de una llave por entidad participante: 
curl -X PUT \
  -H "x-api-key: <API_KEY>" \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "status": "SUSPENDED_BY_PARTICIPANT"
      
    }
  }' "URL/v1/signer/wRFmYXS2sP9ho9VCZ3j4FuP1j55ABeFvsF"

​
Ejemplo de bloqueo de llaves por cliente

A continuación se presenta un ejemplo de bloqueo de una llave por cliente: 
curl -X PUT \
  -H "x-api-key: <API_KEY>" \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "status": "SUSPENDED_BY_CLIENT"
      
    }
  }' "URL/v1/signer/wRFmYXS2sP9ho9VCZ3j4FuP1j55ABeFvsF"