---
title: "Integrations"
space: "Lending"
url: "https://docs.frappe.io/lending/e-signing"
updated: "2026-06-08"
---

# eKYC India

The **eKYC India** app provides India-focused identity verification and electronic signing integration for Frappe applications.

It supports a complete two-way integration with Digio:

- **Frappe to Digio**: Sends eKYC and eSign requests.
- **Digio to Frappe**: Receives webhook events and automatically updates request status.

This integration is designed to work with any Frappe DocType, not only loan documents.

**GitHub:** [https://github.com/frappe/ekyc_india](https://github.com/frappe/ekyc_india)

## Digio Integration

[Digio](https://www.digio.in/) is an Indian regulatory-compliant platform for Aadhaar-based identity verification (eKYC) and electronic signatures (eSign).

### Digio Documentation

| Topic                               | Link                                                                                                                                                                                             |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Environments (Sandbox / Production) | [https://documentation.digio.in/digienvironments/](https://documentation.digio.in/digienvironments/)                                                                                             |
| eSign Webhook Events                | [https://documentation.digio.in/digisign/api_integration/webhooks/#webhook-events-for-digi-sign](https://documentation.digio.in/digisign/api_integration/webhooks/#webhook-events-for-digi-sign) |
| eKYC Webhooks                       | [https://documentation.digio.in/digistudio/integration/webhooks/](https://documentation.digio.in/digistudio/integration/webhooks/)                                                               |
| Webhooks General Reference          | [https://documentation.digio.in/webhooks/](https://documentation.digio.in/webhooks/)                                                                                                             |


---

### Setup

- Go to **Digio Settings** in the Frappe Desk to configure the integration.

**General Settings**

- Request Expiry In Days: How many days before an unanswered request expires on the Digio side.
- Generate Access Token: Returns a one-time token in the response (needed for Web SDK flows).
- Send Sign Link: Digio emails a direct signing link to the customer.
- Notify Customers: Digio sends email/SMS updates to the customer at each status change.

**Environment — Sandbox / Production**

Digio provides two environments. Use **Sandbox** for testing and **Production** for live transactions. Only one can be active at a time.

For each environment, fill in the URL and the API Client ID / Secret obtained from the Digio dashboard.

> Sandbox credentials must be requested directly from the Digio team.

![](/files/image805ead.png)

**Enable e-Sign for Document**

- Document Type: The Frappe DocType to enable (e.g., Loan Application).
- Send Request: How the request is delivered to the customer — Email or Mobile.
- Request Recipient By Document Field: The field on the document that holds the customer's email or mobile number. The dropdown auto-fills with eligible fields from the selected DocType.

Example: Loan Application sent via email to the applicant:

![](/files/image0ec627.png)

---

### eKYC & eSign Flows

**Setting up the Workflow**

1. Create a Workflow for your DocType (e.g., Loan Application) from the Desk.
2. When adding a Transition, choose the appropriate action from the dropdown:
  - Send eKYC Request — for identity verification
  - Make eSignature Request — for electronic signing

Both actions are pre-created when the app is installed.

![](/files/imagea3cdec.png)



**How each flow works**

eKYC Flow:

- A workflow action triggers an eKYC request
- Frappe sends the request to Digio using the Aadhaar / PAN / DigiLocker template
- Customer receives an email/SMS with a verification link
- Customer completes verification on Digio-hosted page

eSign Flow:

- A workflow action triggers an eSign request
- Frappe generates a PDF of the document and sends it to Digio with signer details
- Customer receives an email with a signing link
- Customer completes Aadhaar-based electronic signing

---

### Webhooks

Digio sends status updates to Frappe automatically after each customer action. The webhook URL to register in the Digio dashboard is:

```
https://<your-frappe-site>/api/method/ekyc_india.ekyc_india.doctype.digio_settings.digio_settings.handle_webhook
```

Please follow the steps of [Webhooks General Reference](https://documentation.digio.in/webhooks)

![](/files/image5715dc.png)

---

### Digio Request Log

Every request sent to Digio and every webhook received is logged in **Digio Request Log**. Each log entry shows:

- The Digio request ID
- Whether it is an eSign or eKYC request
- The current status
- Which Frappe document it is linked to
- The full response from Digio and the latest webhook payload

![](/files/image6fff0b.png)