Saltar al contingut principal
PATCH
curl

Descripció general

Canvia una entitat empresarial entre ACTIVE, FLAGGED i BLOCKED. Consulta el cicle de vida de l’entitat per veure la màquina d’estats completa.

Quan s’ha d’utilitzar

  • Bloquejar una empresa sancionada o amb frau confirmat.
  • Marcar una empresa pendent de revisió manual.
  • Desbloquejar una empresa després de les mesures correctores.
  • Propagar senyals externs des dels teus propis sistemes de compliment.

Notes

  • Valors vàlids: ACTIVE, FLAGGED, BLOCKED.
  • Pots passar un reason opcional (fins a 1000 caràcters) per registrar el motiu del canvi d’estat. Didit el guarda a l’entrada del canvi d’estat a Activitat de l’empresa a la Business Console. Només es registra quan l’estat canvia de veritat.
  • Les empreses BLOCKED tenen totes les sessions noves de verificació d’empreses (KYB) rebutjades automàticament i totes les transaccions noves rebutjades automàticament, també quan apareixen com a contrapart.
  • Emet business.status.updated amb previous_status i status. El webhook no inclou reason.

Aplicació

Permisos

La clau secreta principal i les claus d’API amb accés complet sempre poden cridar aquest endpoint. Una clau amb accés personalitzat necessita permís d’escriptura per a Empreses (businesses). Una clau limitada a alguns fluxos de treball o només a sessions aprovades no pot accedir a aquest endpoint. Els rols i permisos de la Console determinen què pot fer un membre de l’equip a la Console. No s’avaluen per a les sol·licituds amb clau d’API.

Relacionat

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Paràmetres de ruta

vendor_data
string
requerit

El teu identificador únic per a l'empresa (cadena de text lliure, NO un UUID).

Cos

application/json
status
enum<string>
requerit

Nou estat del cicle de vida. BLOCKED també afegeix el vendor_data a la llista de bloqueig del sistema.

Opcions disponibles:
ACTIVE,
FLAGGED,
BLOCKED
reason
string | null

Per què ha canviat l'estat. Es registra a l'entrada de canvi d'estat de l'apartat Activitat de l'empresa a la Business Console, només quan l'estat canvia realment. Els webhooks no l'inclouen.

Maximum string length: 1000

Resposta

Estat de l'empresa actualitzat. Es retorna el registre complet de l'empresa.

Detall complet de l'empresa. Amplia BusinessListItem amb metadades i updated_at.

didit_internal_id
string<uuid>

UUID intern estable de Didit per a aquesta empresa.

vendor_data
string | null

El teu identificador únic per a aquesta empresa (passat en crear sessions). Pot ser nul quan no s'ha proporcionat cap identificador de proveïdor.

display_name
string | null

Nom visible personalitzat definit per tu

Nom legal oficial obtingut del registre mercantil o introduït manualment

registration_number
string | null

Número de registre o de constitució de l'empresa

country_code
string | null

País de constitució (ISO 3166-1 alpha-2, p. ex. GB, US).

effective_name
string | null

Millor nom disponible: display_name si està definit, en cas contrari legal_name

status
enum<string>

Estat del cicle de vida del registre d'empresa (NO és un estat de la sessió). ACTIVE és el valor per defecte, FLAGGED el marca per a atenció manual, BLOCKED impedeix noves sessions per a aquest vendor_data.

Opcions disponibles:
ACTIVE,
FLAGGED,
BLOCKED
session_count
integer

Nombre total de sessions de verificació per a aquesta empresa

approved_count
integer

Nombre de sessions aprovades

declined_count
integer

Nombre de sessions rebutjades

in_review_count
integer

Nombre de sessions en revisió

features
object

Estat agregat per funcionalitat a totes les sessions de KYB d'aquesta empresa. Actualment l'única clau és KYB (l'estat de la comprovació de l'empresa al registre). Valors possibles: Approved, Declined, In Review, Not Finished, Resub Requested.

features_list
object[]

Les mateixes dades que features, com una llista ordenada d'objectes {feature, status}.

last_session_at
string<date-time> | null

Marca de temps de la sessió més recent

first_session_at
string<date-time> | null

Marca de temps de la primera sessió

last_activity_at
string<date-time> | null

Marca de temps de l'activitat més recent (canvi d'estat, actualització de la sessió, etc.)

tags
object[]

Etiquetes assignades a aquesta empresa

created_at
string<date-time>
metadata
object

JSON de metadades personalitzades que has adjuntat a aquesta empresa. Per defecte és {}.

updated_at
string<date-time>
Darrera modificació el 7 de novembre del 2026