​
Introducción

En Transfiya, las llaves o credenciales de pago (signers) no se eliminan físicamente del sistema. En su lugar, se utiliza un enfoque de desactivación lógica para mantener la trazabilidad e integridad histórica de las operaciones.

Para cancelar una llave, se debe actualizar el valor del campo status en el objeto del signer y asignarle el valor INACTIVE. Esto marca la llave como inactiva, evitando que pueda ser utilizada para nuevas operaciones, sin eliminar su existencia dentro del sistema.

Este enfoque garantiza que la plataforma mantenga un historial completo de las llaves utilizadas, cumpliendo con los lineamientos regulatorios y de auditoría.

Este proceso no solo marca la llave como inactiva en Transfiya, sino que también la desactiva automáticamente en el DICE. De esta manera, se asegura que el estado de la llave quede sincronizada en todo el ecosistema.

​
Ejemplos de API

​
Cancelacion de una llave

Para cancelar una llave se realiza actualizando el estado de un signer a INACTIVE.

HTTP
PUT /v1/signer/{handle}
ParameterTypeDescription
handlestring26-35 characters Alphanumeric characters allowed base58 structure
labelsobjectMetadata describing the status to cancel the key
ccurl -X PUT \
    -H "x-api-key: <API_KEY>" \
    -H "Authorization: Bearer <TOKEN>" \
    -H "Content-Type: application/json" \
    -d '{
    "labels": { 
        "status": "INACTIVE",
        "allowImmediateReuse":true
    }
    }' "URL/v1/signer/wRFmYXS2sP9ho9VCZ3j4FuP1j55ABeFvsF"

​
Códigos de Error

Error CodeDescriptionHTTP Status
99Unexpected server error400
100You don’t have permissions to access this method403
102Invalid labels400
118Resource schema validation error400
121Signer not found in database400