Updated Journey Webhook

🔄 Updated Journey Webhook

This webhook is triggered only after a journey is completed, when there is a change in the system decision or a compliance-driven update part of the manual review. It keeps your system in sync with important post-verification decision changes.

Webhook Trigger

Each time an update occurs in the journey's system, IDWise sends an HTTP POST request to your configured webhook URL with the following JSON payload:

{  
  "event": "Updated Journey",  
  "body": {
    "eventId":"4****-****-****-*********7", 
    "journeyId": "6720***********22e",
    "referenceNo": "840...........23",  
    "systemDecision": "<SYSTEM_DECISION>",  
    "manualDecision": "<MANUAL_DECISION>",  
    "finalDecision": "<FINAL_DECISION>",
    "action": "<ACTION>"
  }  
}

📘

Note

The payload structure may be extended in the future. Ensure your webhook handler can safely ignore unknown fields to maintain compatibility.

Payload Description

  • event: Always set to "Updated Journey" for this webhook.

  • body:

    • eventId: Unique identifier for the webhook event. It remains the same across retries to help you avoid duplicate processing.

    • journeyId: Unique ID for the verification journey.

    • referenceNo: Your internal reference number for the journey.

    • systemDecision: The automated decision made by IDWise. See decision values.

    • manualDecision: The decision made during manual review, if any. See decision values.

    • finalDecision: Reflects the final decision for the journey. If a manual review is performed, this mirrors the manual decision; otherwise, it matches the system decision.

    • action: Describes what triggered the update. Possible values included in the table below

      ActionDescription
      Step UpdateA step was re-submitted or updated after journey completion—typically due to a resubmission request during manual review.
      AML AmendTriggered when an AML record is manually amended or a new AML check is initiated by the compliance team.
      AML OGM UpdateAn update occurred in ongoing AML monitoring.
      AML Match UpdateTriggered when an AML match is either whitelisted or its status is changed during AML review.