How to enroll a disposable with an OTP by WhatsApp

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

To enroll a lean disposable and send an OTP via WhatsApp you have to:

• specify the required mobile property in the DisposableContacts object (E.164 format with + prefix)
• specify otpType=WHATSAPP in the DisposableCertificate object

Then use these methods:

• checkData/checkDataWitheIDAssertion (optional) : check the validity of the objects passed to the enroll methods
• getDisposableContract/getDisposableContractWitheIDAssertion (optional)
• an enroll method : enroll the certificate
• sendOtp : send the OTP via WhatsApp
• signPKCS1WithSHA256 in the FRA service or use SWS: sign the document
• uploadDoc to upload the evidence of the OTP or the authentication flow (optional)

WhatsApp template configuration

The whatsappOptions object in sendOtp requires:

Request example

{
  "certIdOtp": 123456,
  "deviceCode": "RHIDP123456",
  "whatsappOptions": {
    "templateId": 1,
    "language": "IT",
    "parameters": [{"text": "$OTP$"}]
  }
}

Validation rules

• parameters must not be empty or null
• parameters must contain at least one element with $OTP$ placeholder
• If templateId does not match a configured template, the API returns error code 99 ("OTP was not sent")