Receive Result Notification

If a callbackUrl was provided when creating the verification, PCI Booking will send a POST request to that URL when the session reaches a terminal state (Verified, NotVerified, Failed, or Expired).

Your endpoint must be publicly accessible and should return a 2xx HTTP status code to acknowledge receipt.

📘 Callback payload mirrors the status response

The body of the callback POST uses the same structure as the Get Verification Status response.

📘 Metadata

The metadata field in the callback payload will contain the value provided in the original Create request, making it easy to correlate the notification with your own internal records.

Callback Payload

FieldTypeDescription
verifyIdstringThe unique ID of the verification session.
statusstringThe terminal status. Possible values: Verified, NotVerified, Failed, Expired.
completedAtdatetimeThe UTC datetime at which the session reached its terminal status.
metadatastringThe metadata string provided in the original request. Returns null if not provided.
{
    "verifyId": "xLoat3F385vvFRbgI2usOeuXKXQoB8kv",
    "status": "Verified",
    "completedAt": "2026-03-15T18:47:10Z",
    "metadata": "MY-REFERENCE_098"
}