> For the complete documentation index, see [llms.txt](https://docs.danaya.africa/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.danaya.africa/documentation/integration-mode/webview-or-iframe.md).

# WebView or iFrame

## 📥 Integration URL

Your integration URL should follow this structure:

```
https://{baseUrl}/v2/onboarding/{uuid}?product=productName&externalId=xxxxxx&partnerName=companyName&type=kyc
```

Parameters:

<table><thead><tr><th>parameters</th><th>Description</th><th width="116.6953125">required</th></tr></thead><tbody><tr><td>uuid</td><td>Unique identifier for the onboarding session, provided by Danaya.</td><td>yes</td></tr><tr><td>product</td><td>The product type</td><td>yes</td></tr><tr><td>type</td><td>The onboarding type: kyc (individual) or kyb (business).</td><td>yes</td></tr><tr><td>externalId</td><td>Your internal user ID — used to match this onboarding session with your user.</td><td>yes</td></tr><tr><td>partnerName</td><td>Your partner identifier — used to verify your access.</td><td>yes</td></tr><tr><td>baseUrl</td><td>prod:app.danaya.africa<br>demo: demo.danaya.africa</td><td>yes</td></tr></tbody></table>

## ✅ Completion Callback

Once the user completes (or cancels) the onboarding flow, we redirect to:

```
https://{baseUrl}/v2/onboarding/end?isSuccess=true&requestId=uuid-verfication-request
```

| parameters | Description                                                                                                                                                                                |   |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | - |
| isSuccess  | **true** is the documents are sent successfully and **false** if not                                                                                                                       |   |
| requestId  | <p>the file-verification-uuid. This will allow you to fetch the documents verification results.<br><br>See this <a href="/pages/yJYQCbKGlBQ20sbFtKlH">page</a> to how to use this id. </p> |   |

## Optional: JavaScript Event

We can also emit a JavaScript event if you’re embedding in an iframe:

```
window.addEventListener("message", (event) => {
  if (event.data === "danaya:onboarding:complete") {
    // Close iframe or take appropriate action
    // do something with event.payload...
  }
});
```

Let us know if you’d like to use this event-based approach.

## 📄 Required Documents

Depending on the onboarding type (kyc or kyb), the user will need to provide specific documents:<br>

**KYC (Individual)**

* Selfie (required)

One of the following:

* National ID (CNI)
* Resident Permit
* Passport

**KYB (Business)**

* Selfie (required)

One of the following:

* National ID (CNI)
* Resident Permit
* Passport

And company document

* RCCM (required)
* DFE (optional)

## 📡 Verification Results

#### 1. Webhook

* We will send verification results to the webhook URL you provided during onboarding setup.

#### 2. API Access

* You can retrieve the verification results using either:
  * The requestId returned upon form submission [here](/documentation/integration-mode/rest-api/retrieve-document-verification-result.md#retrieve-a-kyc-or-kyb-analysis-result-v2)
  * The externalId you used during initialization [here](/documentation/integration-mode/rest-api/retrieve-document-verification-result.md#retrieve-a-kyc-or-kyb-analysis-result-by-externalid)

## 🔁 Handling Duplicates

* You can safely initiate multiple onboarding sessions using the same externalId.
* When retrieving verification results by externalId, we will return only the most recent verification associated with it.

#### 🚫 If a document is reused under a different externalId:

If a user uploads the same identity document with a new externalId, we will return an error when you try to retrieve the results:

```json
{
  "code": "DUPLICATED_EXTERNAL_IDS",
  "duplicatedExternalIds": [
    "externalId-1",
    "externalId-2"
  ]
}
```

This indicates that the same document has already been processed under different externalIds.

##

## ❓Questions ?

If you have any questions or need help with the integration, please reach out to our team at <support@danaya.africa>.