Receive the shared-token handoff verdict

Async mirror of a shared-token handoff attempt's verdict, carrying the same conclusion as the synchronous reuse-share-token response and the check endpoints. Sent for passed and incomplete verdicts; terminal verdicts are not webhooked in v1. Partners that only act on remediation may ignore passed events.

Header parameters

X-Webhook-Event-TypestringRequired

The event type, matching the event field in the body.

X-Webhook-Request-IdstringRequired

Idempotency id. Fixed for the lifetime of a message and repeated on every retry; deduplicate on this value.

X-Webhook-TimestampstringRequired

Delivery timestamp in Unix seconds.

X-Webhook-AttemptstringRequired

1-indexed delivery attempt counter.

X-Api-SignaturestringRequired

EIP-191 signature V1 over the raw body. Verify before processing.

X-Api-Signature-V2stringRequired

EIP-191 signature V2 over timestamp + "." + requestId + "." + body.

Payload

Envelope for the fma.kyc.reuse_check.result webhook, the async mirror of a shared-token handoff attempt's verdict. Idempotency business key: {urId}:kyc:reuse_check:{attempt}.

eventconst: fma.kyc.reuse_check.resultRequired

timestampinteger · int64Required

Delivery timestamp, Unix seconds.

Responses

200

Acknowledge receipt with HTTP 200. UR retries non-2xx responses with exponential backoff and the same X-Webhook-Request-Id.

No content

Payload

{
  "event": "fma.kyc.reuse_check.result",
  "timestamp": 1784218179,
  "data": {
    "urId": 6233490772,
    "partnerId": "8208",
    "sessionId": "1c1f3904-6f2a-4c1e-9b7d-2f3a4b5c6d7e",
    "attempt": 1,
    "status": "incomplete",
    "missingFields": [
      "nfc_data",
      "registerRequest.address.addressProof"
    ],
    "requiredLevels": [
      {
        "levelName": "<your NFC level>",
        "action": "RERUN_LEVEL",
        "fields": [
          "nfc_data"
        ]
      }
    ],
    "occurredAt": 1784218179,
    "correlationId": "c514d9ea-6f2a-4c1e-9b7d-2f3a4b5c6d7e"
  }
}