{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/leandisposable/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","tabs","tab"]},"type":"markdown"},"seo":{"title":"Lean - sendOtpDisposable","description":"Integration and usage documentation.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"lean---sendotpdisposable","__idx":0},"children":["Lean - sendOtpDisposable"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this method to send an otp by sms."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"DEPRECATED API"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["This method is deprecated. You should replace it with the"]}," ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/leandisposable/enterprise-documentation/developer-documentation/api-references/lean-send-otp/lean-sendotp-method"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["sendOtp"]}]},"  ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["method."]}]}]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"REST API","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["no REST API"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"SOAP API","disable":false},"children":[{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The SOAP interface is deprecated. Use the REST API instead."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Method:"]}," sendOtpDisposable"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parameter"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["certIdOtp"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["the identification of the otp associate to the disposable"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["YES"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["deviceCode"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["the device code of the issued certificate"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["YES"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["textSms"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The text of the sms. With the addition of tag ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$OTP$"]}," inside the field textSMS the otp code is inserted in the desired position, while in the absence of this tag it will be inserted at the end."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["YES"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["sendSms_test"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["it is considered only in test environment and allow to not send an sms when the function is called.  ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"  ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Use false to not send the sms.  ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Default value is true."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["NO"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["lraid"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The LRA identification code"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["NO"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only in test environment this function returns in the output header the otp code generated by the function."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"request-example","__idx":1},"children":["Request example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"xml","header":{"controls":{"copy":{}}},"source":"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<soapenv:Envelope xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\" xmlns:ser=\"http://service.ws.nam/\">\n   <soapenv:Header />\n   <soapenv:Body>\n      <ser:sendOtpDisposable>\n         <certIdOtp>226762</certIdOtp>\n         <deviceCode>RHILN00000040</deviceCode>\n         <textSMS>COMPANY_NAME: otp code to sign:</textSMS>\n         <lraid>111</lraid>\n      </ser:sendOtpDisposable>\n   </soapenv:Body>\n</soapenv:Envelope>\n","lang":"xml"},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["‌"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"error-codes","__idx":2},"children":["Error codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The main errors that can be found within this function are (all return HTTP ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500"]},"):"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Error code"},"children":["Error code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/leandisposable/enterprise-documentation/developer-documentation/integration-guide/lean-ig-how-to-handle-errors#error-2-empty-field"},"children":["2"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Some required fields are missing"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/leandisposable/enterprise-documentation/developer-documentation/integration-guide/lean-ig-how-to-handle-errors#error-6-generic-exception---internal-exception"},"children":["6"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Generic exception — internal exception"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["62"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["certIdOtp"]}," is not valid"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["66"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The device OTP is not active"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["71"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The device OTP is disabled"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/leandisposable/enterprise-documentation/developer-documentation/integration-guide/lean-ig-how-to-handle-errors#error-85-device-type-missing-or-not-allowed"},"children":["85"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deviceCode"]}," is not valid"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/leandisposable/enterprise-documentation/developer-documentation/integration-guide/lean-ig-how-to-handle-errors#error-99-otp-was-not-sent"},"children":["99"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OTP was not sent"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/leandisposable/enterprise-documentation/developer-documentation/integration-guide/lean-ig-how-to-handle-errors#error-100-the-mobile-phone-number-is-not-valid"},"children":["100"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The mobile phone number is not valid"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/leandisposable/enterprise-documentation/developer-documentation/integration-guide/lean-ig-how-to-handle-errors#error-101-sms-blocked-by-the-watchlist"},"children":["101"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["SMS blocked by the watchlist"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/leandisposable/enterprise-documentation/developer-documentation/integration-guide/lean-ig-how-to-handle-errors#error-102-the-email-address-is-not-valid"},"children":["102"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The email address is not valid"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/leandisposable/enterprise-documentation/developer-documentation/integration-guide/lean-ig-how-to-handle-errors#error-103-the-otp-service-has-exceeded-the-timeout"},"children":["103"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The OTP service has exceeded the timeout"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["138"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The device OTP is not an SMS OTP device"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/leandisposable/enterprise-documentation/developer-documentation/integration-guide/lean-ig-how-to-handle-errors#error-231-otp-is-blocked"},"children":["231"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OTP is blocked"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/leandisposable/enterprise-documentation/developer-documentation/integration-guide/lean-ig-how-to-handle-errors#error-241-lra-not-authorized-to-use-this-type-of-otp"},"children":["241"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["LRA not authorized to use this OTP type"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For authentication errors, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/leandisposable/enterprise-documentation/developer-documentation/authentication"},"children":["Authentication"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For details on how to handle errors, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/leandisposable/enterprise-documentation/developer-documentation/integration-guide/lean-ig-how-to-handle-errors"},"children":["How to handle errors"]},"."]}]},"headings":[{"value":"Lean - sendOtpDisposable","id":"lean---sendotpdisposable","depth":1},{"value":"Request example:","id":"request-example","depth":4},{"value":"Error codes","id":"error-codes","depth":4}],"frontmatter":{"seo":{"title":"Lean - sendOtpDisposable"}},"lastModified":"2026-03-08T10:26:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/leandisposable/enterprise-documentation/developer-documentation/api-references/lean-send-otp/lean-sendotpdisposable-method","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}