Passer au contenu
Dernière mise à jour

Development and integration guides

Resources for integrating with Namirial Notify programmatically or through a supported no-code integration path.


REST APIs

Namirial Notify exposes REST APIs for certified communication services. You can use these APIs to submit communications, query their status, and retrieve related evidence from your own systems.

See the API reference overview for authentication, environments, service guides, and the unified OpenAPI reference.


Error handling

Use the shared Error handling guide for HTTP status codes, service-specific error payload formats, and production recommendations for client-side error processing.


Callbacks and webhooks

Namirial Notify can send push notifications to your system when a transaction changes state. See Callbacks and webhooks for configuration details.


Integration workflows

See Integration workflows for end-to-end patterns that combine Submit, callback handling, Query or Get reconciliation, and affidavit retrieval.


Security and authentication

See Security and authentication for production guidance on credential handling, callback hardening, and data-minimization practices.


Performance and scaling

See Performance and scaling for guidance on callbacks versus polling, pagination, evidence retrieval, and high-volume usage planning.


API collections

Ready-to-use API client collections are available for testing and exploring the APIs. See API collections for download links and setup instructions.


QeRDS integration

For qualified EviNotice submission, start with Integrate QeRDS notices. It covers issuer credentials and certificate prerequisites, recipient identity, ES/IT request differences and result tracking. See QeRDS with EviNotice for the functional explanation.


QeRDS user registration

A separately enabled registration workflow can start recipient enrollment before a QeRDS EviNotice is sent. It is not required for every QeRDS integration. Confirm availability and prerequisites with Namirial, then see the QeRDS user registration API for its endpoint, request fields, response and return URL guidance. AML ID registration and identity reuse are limited to the Italian qualified variant (QERDS_IT) and to financial institutions with a specific agreement with Namirial; see AML ID eligibility.


Communication templates

Custom email templates created in the admin UI can be referenced in API submissions to replace the default system emails. See Using communication templates from the API for the EviNotice template parameters and examples.


No-code integration

If you prefer to integrate without writing code, Namirial Notify supports integration through certifica.me. See No-code integration for details.