{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/namirialnotify/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"EviNotice","description":"Integration and usage documentation.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"evinotice","__idx":0},"children":["EviNotice"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["EviNotice is the Namirial Notify certified hosted notice service. When you submit a notice, Namirial Notify sends a delivery notification to the recipient via email, SMS, RCS, or WhatsApp, and hosts the certified content on a secure platform page. Every step — delivery, access, reading, acceptance, rejection, or refusal — is recorded as evidence and optionally generates a signed affidavit."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the API reference, see the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/apis/evinotice-api"},"children":["EviNotice API"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-to-use-evinotice","__idx":1},"children":["When to use EviNotice"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use EviNotice when:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["You need controlled access to the content"]}," — the recipient must authenticate before reading, using a challenge question, a mobile PIN, or an email PIN."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["You need acceptance or rejection on record"]}," — the recipient can explicitly accept, reject, or refuse the notice, generating legally binding evidence of their decision."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["You need to certify what the recipient saw"]}," — the notice content is hosted on Namirial Notify and certified there, so the evidence covers both delivery of the notification and the recipient's interaction with the content."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["You need recipient identity verification"]}," — QERDS-level certifications can require government-issued identity verification before the recipient can read the notice."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/services/evimail"},"children":["EviMail"]}," instead when the certified content should arrive directly in the recipient's inbox without requiring them to follow a link. Use ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/services/evisms"},"children":["EviSMS"]}," when the certified communication is the SMS message itself rather than a hosted document."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-the-pieces-fit-together","__idx":2},"children":["How the pieces fit together"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An EviNotice involves two distinct layers:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The notification channel"]}," — how the platform alerts the recipient. This can be email, SMS, RCS, or WhatsApp. The notification contains a secure link to the hosted notice."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The hosted notice"]}," — the actual certified content, living on Namirial Notify. The recipient clicks through to read it, and all on-platform interactions are recorded as evidence."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This separation is why EviNotice has more lifecycle states than EviMail or EviSMS: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]}," refers to the notification reaching the recipient's device; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Received"]}," refers to the recipient following the link; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}," refers to the recipient opening the content on the platform."]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#E4F2F2', 'primaryBorderColor': '#006660', 'primaryTextColor': '#0A1111', 'lineColor': '#047C76', 'secondaryColor': '#CDDBDB', 'tertiaryColor': '#f5fafa', 'edgeLabelBackground': '#f5fafa', 'transitionColor': '#047C76'}}}%%\nflowchart LR\n A[Your system] -->|Submit| B[Namirial Notify]\n B -->|\"Notification
email / SMS / RCS / WhatsApp\"| C[Recipient]\n C -->|Clicks secure link| D[Hosted notice page]\n D -->|Reads, accepts, rejects, or refuses| E[Evidence chain]\n E --> F[Affidavits]\n","diagramHtml":"

Submit

Notification
email / SMS / RCS / WhatsApp

Clicks secure link

Reads, accepts, rejects, or refuses

Your system

Namirial Notify

Recipient

Hosted notice page

Evidence chain

Affidavits

"},"children":["%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#E4F2F2', 'primaryBorderColor': '#006660', 'primaryTextColor': '#0A1111', 'lineColor': '#047C76', 'secondaryColor': '#CDDBDB', 'tertiaryColor': '#f5fafa', 'edgeLabelBackground': '#f5fafa', 'transitionColor': '#047C76'}}}%%\nflowchart LR\n A[Your system] -->|Submit| B[Namirial Notify]\n B -->|\"Notification
email / SMS / RCS / WhatsApp\"| C[Recipient]\n C -->|Clicks secure link| D[Hosted notice page]\n D -->|Reads, accepts, rejects, or refuses| E[Evidence chain]\n E --> F[Affidavits]\n"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-evinotice-works","__idx":3},"children":["How EviNotice works"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"lifecycle-overview","__idx":4},"children":["Lifecycle overview"]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#E4F2F2', 'primaryBorderColor': '#006660', 'primaryTextColor': '#0A1111', 'lineColor': '#047C76', 'secondaryColor': '#CDDBDB', 'tertiaryColor': '#f5fafa', 'edgeLabelBackground': '#f5fafa', 'transitionColor': '#047C76'}}}%%\nstateDiagram-v2\n [*] --> Submitted : Submit accepted\n Submitted --> Processed : Validation passed, content certified\n Submitted --> Failed : Invalid attachment\n Processed --> Dispatched : Notification queued for dispatch\n Dispatched --> Sent : Delivery channel accepted the notification\n Sent --> Delivered : Delivery confirmation received\n Delivered --> Received : Recipient follows hosted notice link\n Received --> Read : Recipient opens notice content\n Read --> Replied : Recipient accepts or rejects\n Read --> Closed : Lifecycle complete (no commitment configured)\n Replied --> Closed : Lifecycle complete\n Dispatched --> Closed : Refused without opening\n Sent --> Closed : Refused without opening\n Delivered --> Closed : Refused without opening\n Received --> Closed : Refused without opening\n Sent --> Closed : TimeToLive elapsed\n Failed --> Closed : Closed after failure\n","diagramHtml":"

Submit accepted

Validation passed, content certified

Invalid attachment

Notification queued for dispatch

Delivery channel accepted the notification

Delivery confirmation received

Recipient follows hosted notice link

Recipient opens notice content

Recipient accepts or rejects

Lifecycle complete (no commitment configured)

Lifecycle complete

Refused without opening

Refused without opening

Refused without opening

Refused without opening

TimeToLive elapsed

Closed after failure

Submitted

Processed

Failed

Dispatched

Sent

Delivered

Received

Read

Replied

Closed

"},"children":["%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#E4F2F2', 'primaryBorderColor': '#006660', 'primaryTextColor': '#0A1111', 'lineColor': '#047C76', 'secondaryColor': '#CDDBDB', 'tertiaryColor': '#f5fafa', 'edgeLabelBackground': '#f5fafa', 'transitionColor': '#047C76'}}}%%\nstateDiagram-v2\n [*] --> Submitted : Submit accepted\n Submitted --> Processed : Validation passed, content certified\n Submitted --> Failed : Invalid attachment\n Processed --> Dispatched : Notification queued for dispatch\n Dispatched --> Sent : Delivery channel accepted the notification\n Sent --> Delivered : Delivery confirmation received\n Delivered --> Received : Recipient follows hosted notice link\n Received --> Read : Recipient opens notice content\n Read --> Replied : Recipient accepts or rejects\n Read --> Closed : Lifecycle complete (no commitment configured)\n Replied --> Closed : Lifecycle complete\n Dispatched --> Closed : Refused without opening\n Sent --> Closed : Refused without opening\n Delivered --> Closed : Refused without opening\n Received --> Closed : Refused without opening\n Sent --> Closed : TimeToLive elapsed\n Failed --> Closed : Closed after failure\n"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["State: Failed"]}," is recoverable and does not make the notice final. Wait for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," and inspect the final ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Outcome"]},"; permanent failure is represented by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Outcome: Failed"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"key-state-transitions","__idx":5},"children":["Key state transitions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Submitted → Processed"]}," — Namirial Notify validates the attachments, certifies the content, and prepares the notice for dispatch. If an attachment is invalid (corrupted or password-protected), the notice transitions directly to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]}," then ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," without being dispatched."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Processed → Dispatched → Sent"]}," — Once processing is complete, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Dispatched"]}," marks the point where the platform has run all its checks and accepted responsibility for the communication; the notification is not yet sent, so ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DispatchedOn"]}," typically matches ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ProcessedOn"]}," to the second. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sent"]}," is recorded once transmission is confirmed by the remote system, so ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SentOn"]}," is always equal to or later than ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DispatchedOn"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sent → Delivered"]}," — A delivery confirmation is received from the channel. For email this is a delivery notification from the recipient's mail server; for SMS, RCS, and WhatsApp this is an operator acknowledgement."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Delivered → Received"]}," — The recipient clicks the secure link in the notification. This fires before the recipient has authenticated or read the content. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Received"]}," is specific to EviNotice — it does not exist in EviMail or EviSMS."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Received → Read"]}," — The recipient completes any required authentication and opens the notice content on the hosted page."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Read → Replied"]}," — If commitment is configured, the recipient accepts or rejects the notice. When the lifecycle closes, the final outcome is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accepted"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Rejected"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Any state ≥ Dispatched → Closed (Refused)"]}," — When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AllowRefusal"]}," is enabled, the recipient can refuse the notice without opening the hosted content. The lifecycle ends immediately with outcome ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Refused"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Comparing lifecycle timestamps"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When recorded, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["*On"]}," timestamps in the Query response follow the lifecycle order above: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SubmittedOn"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ProcessedOn"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DispatchedOn"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SentOn"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliveredOn"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ReceivedOn"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ReadOn"]},". A milestone can be absent when the corresponding external signal was not received; for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ReceivedOn"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ReadOn"]}," can be present while ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliveredOn"]}," is absent. Note that ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DispatchedOn"]}," precedes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SentOn"]}," — dispatch is the hand-off to the sending process, not acceptance by the remote system. Timestamps recorded within the same second come from independent processing steps and should not be order-compared."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"submit-a-certified-notice","__idx":6},"children":["Submit a certified notice"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /v2/EviNotice/Submit\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{ \"Id\": \"\" }"]}," on success. Note that ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Id"]}," is PascalCase, unlike the camelCase ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eviId"]}," returned by EviMail and EviSMS v1 endpoints."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"required-fields","__idx":7},"children":["Required fields"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Subject"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Subject line of the certified notice. Shown to the recipient in the delivery notification."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Body"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["HTML content of the hosted notice. This is the certified content the recipient reads on the platform."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientAddress"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recipient's email address or mobile phone number in E.164 format. Determines the primary notification channel."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For Standard and Advanced notices, the API requires only ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Subject"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Body"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientAddress"]},". When you omit other fields, the platform applies site or account defaults — for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Language"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitLanguage"]}," follow your site's configured language, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TimeToLive"]}," uses the account-configured value. QERDS notices have additional mandatory conditions; see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#qerds-recipient-identity"},"children":["QERDS recipient identity"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"useful-fields-you-should-configure","__idx":8},"children":["Useful fields you should configure"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LookupKey"]}]}," — your own correlation key, filterable in Query. No uniqueness enforced server-side — make it unique within your domain."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IssuerLegalName"]}]}," — the legal name of the sending organisation, recorded in the certification evidence."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientDisplayName"]}]}," — the display name shown to the recipient in the delivery notification."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientLegalName"]}]}," — the legal name of the recipient, recorded in the evidence."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CertificationLevel"]}]}," — the legal framework applied. Supported values include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Standard"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Advanced"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDS"]},", and regional variants such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Standard_EU"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Advanced_EU"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDS_ES"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDS_IT"]},". Available levels depend on your account subscription — submitting an unsupported level returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]},". See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/user-guides/certification-levels"},"children":["Certification levels"]}," for the full list and QERDS profile details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TimeToLive"]}]}," — minutes the platform will attempt delivery and keep the notice accessible. Range: 60–86,400 (1 hour to 60 days). Defaults to the account-configured value when omitted."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Language"]}]}," — language for the delivery notification and hosted notice UI. Accepted values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ca"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["de"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["en"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["es"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fr"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["it"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pt"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pt-BR"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ro"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitLanguage"]}]}," — language for generated affidavit PDFs. Accepts ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["el"]}," (Greek) in addition to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Language"]}," values."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NotificationLayout"]}]}," — visual layout of the hosted notice page: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Certified"]}," (default, Namirial Notify branded) or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AsIs"]}," (plain, without certification branding). EviMail exposes the same concept through ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliveryAppearance"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OnlineRetentionPeriod"]}]}," — number of years the notice and its evidence remain accessible online. Valid values depend on your subscription."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LandingPageInfoText"]}]}," — additional text shown on the EviNotice landing page before the recipient opens the hosted content."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"notification-channels","__idx":9},"children":["Notification channels"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NotificationChannels"]}," controls which channels are used to alert the recipient. Supported values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SMS"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WhatsApp"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RCS"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Email"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientAddress"]}," is an email address, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Email"]}," is the default channel. When it is a mobile number, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SMS"]}," is the default. Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NotificationChannels"]}," to add or override channels."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"recipient-authentication","__idx":10},"children":["Recipient authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignMethod"]}," controls how the recipient authenticates before accessing the hosted notice content."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"How the recipient accesses the notice"},"children":["How the recipient accesses the notice"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WebClick"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No authentication is required by the sign method itself. The recipient clicks the link and accesses the notice directly unless another step such as captcha or QERDS legal-ID verification also applies. Lowest friction."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Challenge"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A challenge question is shown before access. The recipient must provide the correct answer. Requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignChallenge"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignChallengeResponse"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MobilePin"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A one-time PIN is sent via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MobilePinChannels"]},". The recipient enters the PIN to access the notice. Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignFixedMobile"]}," if the PIN delivery number differs from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientAddress"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EmailPin"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A one-time PIN is sent to an email address. Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignFixedEmail"]}," if the PIN delivery address differs from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientAddress"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MobilePinChannels"]}]}," configures PIN delivery attempts as an array of arrays. Each outer element is one attempt; all channels in the inner array are tried simultaneously for that attempt:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"MobilePinChannels\": [\n [\"SMS\", \"RCS\", \"WhatsApp\"],\n [\"SMS\", \"RCS\", \"WhatsApp\"],\n [\"SMS\", \"RCS\", \"WhatsApp\"]\n]\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Supported channel values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SMS"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RCS"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WhatsApp"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"qerds-recipient-identity","__idx":11},"children":["QERDS recipient identity"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For QERDS-certified EviNotices, recipient legal-ID verification is required before the hosted notice is shown. QERDS submissions also require the issuer account and site to be provisioned for the QERDS API flow, including the required client-certificate or two-factor authentication configuration. Send QERDS API calls to the Namirial Notify API host for the environment, not to the customer's site host."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientLegalIdRequired"]}]}," — must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," for QERDS notices."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientLegalIdKind"]}]}," / ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientLegalIdValue"]}]}," — optionally predefine the legal document type and value the recipient must confirm."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDSEnrollmentAllowed"]}]}," — when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", recipients without a registered identity can complete enrollment during the same notice flow."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDSEnrollmentProfile"]}]}," — selects the enrollment profile to use for in-flow registration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDSIdentityTenant"]}]}," — identifies the tenant or identity context used by the QERDS verification flow."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDS_ES"]},", the delivery sign method must match the recipient address channel: email recipients use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EmailPin"]}," and mobile recipients use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MobilePin"]},", with the fixed PIN destination matching ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientAddress"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDS_IT"]},", the issuer must have the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDS_IT"]}," identity-verification schema enabled. Email recipients must use a mobile PIN destination (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignMethod: MobilePin"]}," plus ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignFixedMobile"]},"), while mobile recipients must use an email PIN destination (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignMethod: EmailPin"]}," plus ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignFixedEmail"]},"). ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientLegalIdKind"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientLegalIdValue"]}," are required and must validate together."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the recipient is not yet registered, the platform redirects them to the enrollment flow only when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDSEnrollmentAllowed"]}," is enabled and the supplied ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QERDSEnrollmentProfile"]}," is configured on the site. Otherwise, access is blocked until the issuer resolves the identity requirement."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"commitment-and-refusal","__idx":12},"children":["Commitment and refusal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentChoice"]}]}," controls whether the recipient can accept or reject the notice. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cannot be changed after submission."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Effect"},"children":["Effect"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Disabled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No commitment action. The recipient reads the notice but cannot accept or reject."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accept"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The recipient can only accept."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Reject"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The recipient can only reject."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AcceptOrReject"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The recipient can accept or reject."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Additional commitment fields:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentCommentsAllowed"]}]}," — when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", the recipient can add a free-text comment with their decision."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AcceptReasons"]}]}," / ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RejectReasons"]}]}," — predefined reasons the recipient can select from."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RequireAcceptReason"]}]}," / ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RequireRejectReason"]}]}," — force the recipient to select or enter a reason before committing."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["EviMail and EviSMS expose the same concept through a field named ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentOptions"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AllowRefusal"]}]}," is separate from commitment. When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", the recipient can refuse the notice without opening the hosted content after following the secure link. In standard non-QERDS flows, refusal is presented on the landing step before the content is shown. Refusal closes the notice immediately with outcome ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Refused"]}," and generates a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Refused"]}," affidavit if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Refused"]}," is included in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"affidavit-configuration","__idx":13},"children":["Affidavit configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]}," selects which evidence events generate affidavits. For the full catalog and the lifecycle moment each kind is tied to, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#evidence-and-affidavits"},"children":["Evidence and affidavits"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"callbacks","__idx":14},"children":["Callbacks"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationUrl"]}]}," — HTTPS endpoint to receive state callbacks. Must be publicly reachable from Namirial Notify infrastructure."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationFilter"]}]}," — state transitions that trigger a callback. Valid values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Processed"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Dispatched"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sent"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Received"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]},". ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}," is a platform meta-event that fires when affidavit generation completes — it is not a lifecycle state. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Received"]}," is unique to EviNotice."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationExtraData"]}]}," — arbitrary string echoed back in every callback for this notice. Use it to embed a routing key or internal record ID so your callback handler can route the event without a separate lookup."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"idempotency","__idx":15},"children":["Idempotency"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Evi-IdempotencyToken"]}," on every Submit. Use a UUID and keep it constant across retries. A replay of a previously ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200 OK"]}," submission returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["202 Accepted"]},"; the notice is not resubmitted."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"attachments","__idx":16},"children":["Attachments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include files in the hosted notice via the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Attachments"]}," array. Each attachment requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Filename"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MimeType"]},", and base64-encoded ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Data"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Limits: maximum 15 attachments per submission; maximum 8 MB per attachment; maximum 25 MB total across all attachments."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ContentId"]}," to reference an attachment inline in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Body"]}," HTML using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cid:"]}," syntax. Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IncludeOnAffidavits: true"]}," to include the attachment reference in generated affidavits."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"reminders","__idx":17},"children":["Reminders"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["EviNotice supports automatic reminder notifications sent to the recipient if the notice has not been acted on. Configure via the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Reminders"]}," object:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Initial"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 8601 duration after submission before the first reminder fires (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["P2D"]}," = 2 days)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Repeat"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 8601 duration between subsequent reminders (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["P1D"]}," = daily)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Days"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Days of the week on which reminders may be sent."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TimeRange"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Time-of-day windows: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FROM08TO10"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FROM10TO12"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FROM12TO15"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FROM15TO19"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Max"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Maximum total reminders to send."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Stop"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 8601 duration after submission beyond which no further reminders fire (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["P15D"]},")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TimeZone"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["IANA time zone identifier used to interpret ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Days"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TimeRange"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-the-recipient-sees","__idx":18},"children":["What the recipient sees"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The recipient's experience depends on the configured ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignMethod"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"webclick","__idx":19},"children":["WebClick"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The recipient receives a notification (email, SMS, RCS, or WhatsApp) containing a secure link. Clicking the link opens the hosted notice page directly when no additional access step is configured. Appropriate for non-sensitive communications where you need evidence of delivery and access but not identity verification."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"challenge","__idx":20},"children":["Challenge"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After clicking the link, the recipient is presented with a challenge question configured in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignChallenge"]},". They must provide the correct answer (configured in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignChallengeResponse"]},") before the notice content is revealed. Use when you need to confirm the recipient's identity using information only they would know — a contract reference, last four digits of a document, or similar."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"mobilepin","__idx":21},"children":["MobilePin"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After clicking the link, the recipient is prompted to enter a one-time PIN delivered to their mobile device via the channels configured in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MobilePinChannels"]},". If the mobile number for PIN delivery differs from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientAddress"]},", configure it in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignFixedMobile"]},". Each element of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MobilePinChannels"]}," is one attempt; all channels in that element are tried simultaneously."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"emailpin","__idx":22},"children":["EmailPin"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After clicking the link, the recipient is prompted to enter a one-time PIN sent to an email address. If the PIN delivery address differs from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientAddress"]},", configure it in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignFixedEmail"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"captcha-and-qerds-specific-checks","__idx":23},"children":["Captcha and QERDS-specific checks"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Depending on tenant configuration, the recipient can also encounter a captcha step before the content is displayed."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For QERDS-certified notices with legal-ID verification, the recipient can be asked to confirm a government-issued document number before any other access step. If no verified identity is already registered and in-flow enrollment is enabled, the recipient is redirected to the identity provider and then returned to the notice."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"commitment-actions-on-the-hosted-page","__idx":24},"children":["Commitment actions on the hosted page"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentChoice"]}," is not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Disabled"]},", the hosted notice page displays the configured action buttons after the recipient has opened the content. If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentCommentsAllowed"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", a comment field is shown alongside the buttons. If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AcceptReasons"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RejectReasons"]}," are configured, the recipient selects from those predefined options rather than typing freely. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentChoiceButtonText"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentChoiceButtonOnly"]}," further customize how the commitment control is presented."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"callbacks-and-what-you-receive","__idx":25},"children":["Callbacks and what you receive"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a state in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationFilter"]}," is reached, Namirial Notify sends an HTTP POST to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationUrl"]}," with the following JSON payload."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"base-payload","__idx":26},"children":["Base payload"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Identifier"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unique ID of this callback delivery. Use it to deduplicate — the platform retries on non-2xx and on timeouts, so the same event may be delivered more than once."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kind"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The state or event that triggered this callback (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sent"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Received"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]},")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Date"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["datetime"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Timestamp of the state transition that fired this callback."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EvidenceId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["UUID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Id"]}," of the EviNotice, as returned at submission."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EvidenceType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Always ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eviNotice"]}," for EviNotice callbacks."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EvidenceState"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Current state of the notice at the time the callback was sent."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Owner"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifier of the account that submitted the notice."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OwnerEmail"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Email address of the submitting account."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Event-specific fields. Always includes the fields listed below."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additionaldata-fields--always-present","__idx":27},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData"]}," fields — always present"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Subject"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The subject of the notice."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LookupKey"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The integrator-assigned lookup key set at submission."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["State"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Current lifecycle state."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CreationDate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Timestamp when the notice was submitted."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["From"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Notification sender address."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["To"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recipient address the notification was sent to."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ExtraData"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationExtraData"]}," value set at submission, if provided."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additionaldata-fields--per-event","__idx":28},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData"]}," fields — per event"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Callback Kind"},"children":["Callback ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kind"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Extra fields"},"children":["Extra fields"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Comments"]}," — the free-text comment left by the recipient, if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentCommentsAllowed"]}," was ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Outcome"]}," — the final outcome (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accepted"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Rejected"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Refused"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]},", etc.). ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OutcomeDescription"]}," — human-readable description of the outcome."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitId"]}," — unique ID of the generated affidavit. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKind"]}," — the kind that was generated. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitName"]}," — filename of the affidavit PDF."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"callback-reliability","__idx":29},"children":["Callback reliability"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Make your callback handler idempotent, keyed on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Identifier"]}," — duplicate deliveries will occur. Return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2xx"]}," promptly; the platform interprets timeouts as failures and retries. Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationExtraData"]}," to embed a routing key so your handler can correlate the callback to your internal records without a separate API call."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"securing-your-callback-endpoint","__idx":30},"children":["Securing your callback endpoint"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/dev/security-best-practices"},"children":["Security and authentication"]}," for callback hardening guidance including signature verification and IP allowlisting."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"states-reference","__idx":31},"children":["States reference"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"State"},"children":["State"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Draft"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Notice has been staged but not yet submitted."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Submitted"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Notice has been accepted by the platform."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Processed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Attachments validated, content certified, notice ready for dispatch."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Dispatched"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Notification queued; delivery to the recipient's channel is starting."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The selected delivery channel accepted the notification."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delivery confirmation received from the channel."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Received"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recipient followed the hosted notice link. The recipient has not yet read the content. Unique to EviNotice."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recipient opened and read the hosted notice content."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recipient accepted or rejected the notice. When the lifecycle closes, the final outcome is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accepted"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Rejected"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Notice lifecycle is complete."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A recoverable processing or delivery failure occurred. The platform may retry or advance to a later state."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["On ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]},":"]}," by default, the notice closes immediately after the commitment is recorded. Some configurations keep tracking open until the TTL elapses. Subscribe to both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," if you need to react to the recipient's answer and then mark the lifecycle as final."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["On ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Received"]}," vs ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]},":"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Received"]}," fires when the recipient clicks the link; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}," fires when they open the content. A recipient can click the link and abandon the page without reading — both events are recorded independently."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["On refusal:"]}," when a notice is refused, the state moves directly to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," with outcome ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Refused"]},". ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Refused"]}," does not appear as a lifecycle state — it only surfaces as an outcome value."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"evidence-and-affidavits","__idx":32},"children":["Evidence and affidavits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]}," selects which evidence events generate signed affidavit PDFs. Generation is asynchronous; you receive an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}," callback when each affidavit is ready (if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}," is in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationFilter"]},")."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"when-each-affidavit-is-generated","__idx":33},"children":["When each affidavit is generated"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"AffidavitKinds value"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]}," value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Triggers at"},"children":["Triggers at"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Submitted"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Processed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certifies the notice content at submission time."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SubmittedAdvanced"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Processed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Advanced variant with extended content certification."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Dispatched"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Dispatched"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certifies that the notification was queued for dispatch."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TransmissionResult"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certifies the outcome of the notification send attempt via the delivery channel."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliveryResult"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certifies delivery confirmation from the channel."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Received"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Received"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certifies that the recipient followed the hosted notice link."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certifies that the recipient opened and read the hosted notice content."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Committed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certifies the recipient's acceptance or rejection decision."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommittedAdvanced"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Advanced variant of the commitment affidavit."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Refused"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," (outcome ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Refused"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certifies that the recipient refused the notice without opening it."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certifies the end of the notice lifecycle."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ClosedAdvanced"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Advanced variant of the closure affidavit."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Complete"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certifies the full chain from submission to closure (only generated when the notice was processed)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CompleteAdvanced"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Advanced variant of the complete lifecycle affidavit."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Event"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Various technical events"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Internal technical record for events without a more specific affidavit kind."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OnDemand"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["On request"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Requires a separate ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/EviNotice/Affidavits/Request"]}," call while the notice is still eligible."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ContentDownload"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Content download"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certifies that the recipient downloaded the notice content or an attachment. Requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EnforceTrackingUntilTimeToLive: true"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Terminal failure"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certifies a permanent delivery failure."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the legal implications and cross-service comparison of each affidavit type, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/user-guides/evidences-affidavits"},"children":["Evidence and affidavits"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"querying-status","__idx":34},"children":["Querying status"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the Query endpoint as a fallback when callbacks lag, for point-in-time snapshots, or for batch reconciliation."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /v2/EviNotice/Query\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["EviNotice Query uses ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["cursor-based pagination"]},", unlike the offset-based pagination in EviMail and EviSMS. Pass ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Cursor"]}," from the previous response to retrieve the next page. When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Cursor"]}," is absent from the response, there are no further results."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response field names are PascalCase"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Cursor"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Results"]},") rather than the camelCase used by EviMail and EviSMS v1 query endpoints. Deserialise accordingly if sharing response models across services."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Common filters:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LookupKeys: [\"your-key\"]"]}," — fetch by your correlation key."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["State: \"Closed\""]}," — fetch only closed notices."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Outcome: \"Refused\""]}," — fetch by final outcome."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Limit"]}," — maximum results per page (1–100, default 100)."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To retrieve affidavit or attachment metadata, use the Get endpoint (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/EviNotice/{Id}"]},") with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IncludeAffidavits=true"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IncludeAttachments=true"]},". To download all affidavits or attachments as a ZIP file, use the dedicated download endpoints."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"first-call-walkthrough","__idx":35},"children":["First-call walkthrough"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"what-you-need","__idx":36},"children":["What you need"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Namirial Notify credentials (username and password)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A recipient email address or mobile number for testing"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An HTTPS endpoint to receive callbacks (or use a tool like ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://webhook.site"},"children":["Webhook.site"]}," for initial testing)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1--submit-your-first-notice","__idx":37},"children":["Step 1 — Submit your first notice"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v2/EviNotice/Submit\nAuthorization: Basic \nContent-Type: application/json\nX-Evi-IdempotencyToken: \n\n{\n \"Subject\": \"Test certified notice\",\n \"Body\": \"

This is a test certified notice. Please read and acknowledge.

\",\n \"RecipientAddress\": \"recipient@example.com\",\n \"LookupKey\": \"test-001\",\n \"CertificationLevel\": \"Standard_EU\",\n \"DeliverySignMethod\": \"WebClick\",\n \"NotificationLayout\": \"Certified\",\n \"Language\": \"en\",\n \"AffidavitKinds\": [\"Submitted\", \"DeliveryResult\", \"Read\", \"Closed\"],\n \"PushNotificationUrl\": \"https://your-endpoint.example.com/callbacks\",\n \"PushNotificationFilter\": [\"Sent\", \"Delivered\", \"Received\", \"Read\", \"Closed\", \"AffidavitPublished\"]\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200 OK"]}," response contains ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{ \"Id\": \"\" }"]},". Store the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Id"]}," — you will use it to poll status and retrieve evidence."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2--verify-the-notice-progresses","__idx":38},"children":["Step 2 — Verify the notice progresses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Query by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Id"]}," to confirm the notice moves through ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Submitted"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Processed"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Dispatched"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sent"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v2/EviNotice/Query\nAuthorization: Basic \nContent-Type: application/json\n\n{\n \"LookupKeys\": [\"test-001\"]\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Or retrieve it directly:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /v2/EviNotice/\nAuthorization: Basic \n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-3--follow-the-notice-as-the-recipient","__idx":39},"children":["Step 3 — Follow the notice as the recipient"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open the delivery email in the recipient's inbox, click the secure link, and read the notice. Verify that:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Received"]}," callback fires when the link is clicked"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}," callback fires when the notice is opened"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The notice state in Query advances to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-4--confirm-closure-and-download-the-affidavit","__idx":40},"children":["Step 4 — Confirm closure and download the affidavit"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the notice closes, retrieve the affidavit:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /v2/EviNotice//Affidavits\nAuthorization: Basic \n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This returns a ZIP file containing all generated affidavit PDFs. Verify the affidavit content covers the lifecycle events you configured in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-5--test-the-failure-path","__idx":41},"children":["Step 5 — Test the failure path"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Submit a notice with an invalid or encrypted PDF attachment and set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IncludeOnAffidavits"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," for that attachment. Confirm that:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The notice reaches ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]}," then ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Outcome: Failed"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Failed"]}," callback fires to your endpoint"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," callback includes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Outcome: Failed"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AdditionalData"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"integration-checklist","__idx":42},"children":["Integration checklist"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LookupKey"]}," on every Submit and persist ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Id"]}," from the response."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Evi-IdempotencyToken"]}," (UUIDv4) on every Submit. Treat ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["202 Accepted"]}," as success."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliverySignMethod"]}," deliberately — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WebClick"]}," for low-friction; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MobilePin"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Challenge"]}," for sensitive content."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Subscribe only to the callback kinds you act on. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Received"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}," are unique to EviNotice — include them if your flow depends on distinguishing link-click from content-open."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Make your callback handler idempotent, keyed on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Identifier"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Store the raw callback body before parsing."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationFilter"]}," if you download affidavits programmatically — it tells you exactly when each affidavit is ready."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentChoice"]},", test both the accept and reject paths in pre-production."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AllowRefusal"]},", subscribe to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Closed"]}," with outcome ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Refused"]}," and handle it as a terminal negative result."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OnDemand"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]}," at submit time if you plan to call the affidavit request endpoint later — this cannot be added retroactively."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Remember that EviNotice query responses use PascalCase field names (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Cursor"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Results"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Id"]},") — deserialise separately from EviMail/EviSMS if sharing models."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/EviNotice/{Id}/Affidavits"]}," endpoint to download affidavit ZIPs rather than requesting them one at a time."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting","__idx":43},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Symptom"},"children":["Symptom"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Likely causes"},"children":["Likely causes"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What to check"},"children":["What to check"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What to do"},"children":["What to do"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No callbacks received"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationUrl"]}," missing or HTTP (not HTTPS); ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationFilter"]}," omits the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Kind"]}," you expect; endpoint returned non-2xx and retries exhausted"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query the notice state directly; check your server access logs for the callback ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Identifier"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Confirm filter and URL; switch to HTTPS; use Query polling as fallback"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Notice stays in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Dispatched"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Notification channel slow or unavailable; recipient MTA greylisting (email); SMS operator delay"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Timestamps in Query response: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DispatchedOn"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SentOn"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliveredOn"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wait; do not resubmit"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recipient says they did not get the notification"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Spam filter caught the email; wrong address or number; SMS delivery failure"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Delivered"]}," callback and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliveredOn"]}," timestamp; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TransmissionResult"]}," affidavit if generated"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Confirm address; check spam folder; resubmit with corrected address and a new idempotency token"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Received"]}," callback fired but ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}," never fires"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recipient clicked the link but abandoned the page without opening the content"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ReceivedOn"]}," timestamp present; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ReadOn"]}," absent in Query"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Normal — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Received"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Read"]}," are independent events; wait for TTL or contact the recipient"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Notice closed with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Outcome: Failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A permanent processing or transmission failure was recorded before closure"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FailedOn"]},", callback payloads, and failure details"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Correct the payload or address; resubmit with a new idempotency token only after the cause is fixed"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Commitment callback not received"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentChoice"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Disabled"]},"; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Replied"]}," not in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PushNotificationFilter"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submit request at creation time"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cannot change ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CommitmentChoice"]}," after submission; resubmit with the correct setting and a new idempotency token"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Affidavit not available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Generation is asynchronous; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}," has not fired yet; the relevant kind was not included in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]}," at submission"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IncludeAffidavits=true"]},"; check ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitKinds"]}," on the Get response"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wait for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AffidavitPublished"]}," callback; if the kind is missing, it cannot be added retroactively — resubmit"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submit → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400 Bad Request"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Missing required field (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Subject"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Body"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientAddress"]},"); invalid ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CertificationLevel"]}," for your account; attachment too large or count exceeded"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Problem+JSON body: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Detail"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["InvalidValues"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fix the flagged field; retry with a new idempotency token"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submit → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401 Unauthorized"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wrong environment base URL; credentials rotated"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}," header; confirm target environment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Re-issue credentials through your Namirial Notify contact"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submit → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["403 Forbidden"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Account not provisioned for EviNotice; insufficient credit balance"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Account permissions and credit balance"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact your Namirial Notify account manager"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related","__idx":44},"children":["Related"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/apis/evinotice-api"},"children":["EviNotice API"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/issuer/create-evinotice"},"children":["How to create a new EviNotice"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/recipient/receive-evinotice"},"children":["How a recipient receives an EviNotice"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/services/evimail"},"children":["EviMail"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/services/evisms"},"children":["EviSMS"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/dev/api-documentation"},"children":["API documentation"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/dev/callbacks"},"children":["Callbacks and webhooks"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/dev/security-best-practices"},"children":["Security and authentication"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/user-guides/states-outcomes"},"children":["States and outcomes"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/namirialnotify/user-guides/evidences-affidavits"},"children":["Evidence and affidavits"]}]}]}]},"headings":[{"value":"EviNotice","id":"evinotice","depth":1},{"value":"When to use EviNotice","id":"when-to-use-evinotice","depth":2},{"value":"How the pieces fit together","id":"how-the-pieces-fit-together","depth":2},{"value":"How EviNotice works","id":"how-evinotice-works","depth":2},{"value":"Lifecycle overview","id":"lifecycle-overview","depth":3},{"value":"Key state transitions","id":"key-state-transitions","depth":3},{"value":"Submit a certified notice","id":"submit-a-certified-notice","depth":2},{"value":"Required fields","id":"required-fields","depth":3},{"value":"Useful fields you should configure","id":"useful-fields-you-should-configure","depth":3},{"value":"Notification channels","id":"notification-channels","depth":3},{"value":"Recipient authentication","id":"recipient-authentication","depth":3},{"value":"QERDS recipient identity","id":"qerds-recipient-identity","depth":3},{"value":"Commitment and refusal","id":"commitment-and-refusal","depth":3},{"value":"Affidavit configuration","id":"affidavit-configuration","depth":3},{"value":"Callbacks","id":"callbacks","depth":3},{"value":"Idempotency","id":"idempotency","depth":3},{"value":"Attachments","id":"attachments","depth":3},{"value":"Reminders","id":"reminders","depth":3},{"value":"What the recipient sees","id":"what-the-recipient-sees","depth":2},{"value":"WebClick","id":"webclick","depth":3},{"value":"Challenge","id":"challenge","depth":3},{"value":"MobilePin","id":"mobilepin","depth":3},{"value":"EmailPin","id":"emailpin","depth":3},{"value":"Captcha and QERDS-specific checks","id":"captcha-and-qerds-specific-checks","depth":3},{"value":"Commitment actions on the hosted page","id":"commitment-actions-on-the-hosted-page","depth":3},{"value":"Callbacks and what you receive","id":"callbacks-and-what-you-receive","depth":2},{"value":"Base payload","id":"base-payload","depth":3},{"value":"AdditionalData fields — always present","id":"additionaldata-fields--always-present","depth":3},{"value":"AdditionalData fields — per event","id":"additionaldata-fields--per-event","depth":3},{"value":"Callback reliability","id":"callback-reliability","depth":3},{"value":"Securing your callback endpoint","id":"securing-your-callback-endpoint","depth":3},{"value":"States reference","id":"states-reference","depth":2},{"value":"Evidence and affidavits","id":"evidence-and-affidavits","depth":2},{"value":"When each affidavit is generated","id":"when-each-affidavit-is-generated","depth":3},{"value":"Querying status","id":"querying-status","depth":2},{"value":"First-call walkthrough","id":"first-call-walkthrough","depth":2},{"value":"What you need","id":"what-you-need","depth":3},{"value":"Step 1 — Submit your first notice","id":"step-1--submit-your-first-notice","depth":3},{"value":"Step 2 — Verify the notice progresses","id":"step-2--verify-the-notice-progresses","depth":3},{"value":"Step 3 — Follow the notice as the recipient","id":"step-3--follow-the-notice-as-the-recipient","depth":3},{"value":"Step 4 — Confirm closure and download the affidavit","id":"step-4--confirm-closure-and-download-the-affidavit","depth":3},{"value":"Step 5 — Test the failure path","id":"step-5--test-the-failure-path","depth":3},{"value":"Integration checklist","id":"integration-checklist","depth":2},{"value":"Troubleshooting","id":"troubleshooting","depth":2},{"value":"Related","id":"related","depth":2}],"frontmatter":{"title":"EviNotice","description":"End-to-end integration guide for EviNotice — certified hosted notices through Namirial Notify.","layout":"doc","outline":"deep","keywords":["evinotice","certified notice","hosted notice","recipient authentication","commitment workflow","affidavit","delivery evidence","namirial notify"],"seo":{"title":"EviNotice"}},"lastModified":"2026-08-03T09:35:33.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/namirialnotify/services/evinotice","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}