Consent-API: Send and verify OTP

XMLWordPrintable

    • Type: Task
    • Resolution: Unresolved
    • Priority: High
    • 3.14
    • Affects Version/s: None

      What this is
      Send an OTP to a phone and check it. Used when a guardian gives consent for a child, and when a patient approves doctor access.

      APIs

      • Send OTP: POST /consent/v1/otp/challenges
      • Verify OTP: POST /consent/v1/otp/challenges/ {id}

        /verify

      Steps

      1. Send an OTP to the phone number given (for example, the guardian's phone).
      2. Check the OTP the person enters.
      3. When it is correct, save the OTP verified time and the masked number as proof.
      4. If the guardian has no phone or the OTP fails, use the fallback in decision D-03: ID seen by staff, or witness + signature. Save the guardian as "ID sighted" or "Unverified" and flag it for follow-up.

      Done when

      • A correct OTP is accepted and the verified time and masked number are saved.
      • A wrong OTP is refused.
      • The fallback saves the guardian as "ID sighted" or "Unverified" and flags it.

      Source: DPDPA Compliance Proposal v14, sections 3.1 (rule 7), 3.2.2, 6 (C6, C7)

              Assignee:
              Vanitha S
              Reporter:
              Shivani Garg
              Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

                Created:
                Updated: