> For the complete documentation index, see [llms.txt](https://docs.emudhradigital.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.emudhradigital.com/api-reference/remote-key-storage-api/rks-initiate-signing.md).

# RKS Initiate Signing

```xml
<Esign ver="1.0" signerid="rkumar" ts="2026-10-12T10:15:30" txn="ASP-RKS-000789"
       maxWaitPeriod="30" aspId="ASPXXXX0001"
       responseUrl="https://asp.example.com/rks/callback"
       redirectUrl="https://asp.example.com/rks/done">
  <Docs>
    <InputHash id="1" hashAlgorithm="SHA256" docInfo="Form AOC-4"
               docUrl="https://asp.example.com/d/1" responseSigType="PKCS7pdf">…hex…</InputHash>
  </Docs>
  <Signature>…</Signature>
</Esign>
```

| Attribute               | Required | Values / rules                  |
| ----------------------- | -------- | ------------------------------- |
| `ver`                   | Yes      | API version                     |
| `signerid` / `username` | No       | Subscriber KYC username         |
| `ts`                    | Yes      | ISO 8601 IST, ±30 min           |
| `txn`                   | Yes      | Unique per ASP–ESP pair per day |
| `maxWaitPeriod`         | Yes      | Minutes (default 1440)          |
| `aspId`                 | Yes      | Issued by eMudhra               |
| `responseUrl`           | Yes      | Final result endpoint           |
| `redirectUrl`           | No       | Browser return URL              |

`InputHash`: `id` 1–10, `hashAlgorithm` `SHA256`, `docInfo` ≤ 50 chars, `docUrl`, `responseSigType` (`raw`, `PKCS7`, `PKCS7pdf`, `PKCS7complete`).

{% hint style="warning" %}
The CCA document shows `ver="1.0"` on `<Esign>` and `ver="3.3"` on `<EsignResp>` / `<EsignStatus>`, and uses both `signerid` and `username`. Confirm the values in the Swagger definition.
{% endhint %}