> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fincode.technology/llms.txt
> Use this file to discover all available pages before exploring further.

# External Screening Webhook

> Receives verification results from an external KYC provider and closes the outstanding compliance rule.

Configure this URL as the webhook callback endpoint in your KYC provider account settings. This is a one-time setup, not per customer.

When the customer completes verification, your provider calls this endpoint. RemitJunction reads the reference you embedded in the verification session and uses it to locate the correct customer record and close the outstanding KYC rule.

## Behaviour

| Provider Decision    | Outcome                                                                           |
| -------------------- | --------------------------------------------------------------------------------- |
| `APPROVED`           | KYC rule is marked as submitted and the compliance record is updated              |
| `DECLINED`           | KYC rule is reset so the customer can retry verification                          |
| `PENDING` / `REVIEW` | Event is acknowledged but no action is taken — only final decisions are processed |

## Requirements

The webhook payload must echo back the reference UUID returned by the [Initiate External KYC Provider](/api/ciam/initiate-external-provider) endpoint, in the external reference field your provider uses for correlation IDs. Without it, the result cannot be matched to a customer and will be rejected.