> ## 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.

# Initiate External KYC Provider

> Registers an external KYC provider session with RemitJunction and returns a reference to embed in the provider session.

Use this endpoint when your client uses their own KYC provider instead of RemitJunction's built-in provider.

Calling this endpoint creates a compliance tracking record on our side and returns a unique `reference`. Your client must pass this reference to their KYC provider as the external user identifier (e.g. `externalUserId`, `correlationId`, or equivalent) when starting the verification session.

When the customer completes verification, the provider sends a webhook to RemitJunction. We use the `reference` echoed back in that webhook to match the result to the correct customer record and close the outstanding KYC rule.

## Request Body

| Field           | Type   | Required | Description                                                         |
| --------------- | ------ | -------- | ------------------------------------------------------------------- |
| `userId`        | string | Yes      | The customer's user ID returned from the register-customer endpoint |
| `customerEmail` | string | Yes      | The customer's email address                                        |
| `ruleId`        | string | Yes      | The eKYC rule ID from the awaiting compliance requirements list     |

## Response

The response `data` object contains a `reference` field — a UUID generated by RemitJunction. Pass this value to your KYC provider as the external user identifier. Do not generate your own reference.