{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/leandisposable/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Send OTP methods","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":"send-otp-methods","__idx":0},"children":["Send OTP methods"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use these methods to send an OTP code to the holder after enrollment."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The OTP delivery channel depends on the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["otpType"]}," set during enrollment:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SMS"]}," — OTP sent via SMS to the holder's mobile number"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["EMAIL"]}," — OTP sent via email"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["WHATSAPP"]}," — OTP sent via WhatsApp to the holder's mobile number (requires LRA authorization and template configuration)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Methods:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$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"]}]}," — standard method"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/leandisposable/enterprise-documentation/developer-documentation/api-references/lean-send-otp/lean-sendotpdisposable-method"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["sendOtpDisposable"]}]}," — deprecated, use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sendOtp"]}," instead"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response","__idx":1},"children":["Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both methods return an empty body on success."]},{"$$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":"HTTP Status"},"children":["HTTP Status"]},{"$$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":"code","attributes":{},"children":["200"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OTP sent successfully. Response body is empty"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"errors","__idx":2},"children":["Errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All errors below 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":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["240"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No email template configured for this LRA"]}]}]}]}]},{"$$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":"br","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":"Send OTP methods","id":"send-otp-methods","depth":1},{"value":"Response","id":"response","depth":2},{"value":"Errors","id":"errors","depth":2}],"frontmatter":{"seo":{"title":"Send OTP methods"}},"lastModified":"2026-05-07T07:59:26.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/leandisposable/enterprise-documentation/developer-documentation/api-references/lean-send-otp","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}