• Getting Started
    • Website Integration
      Mobile Integration (Android/IOS)
      Enterprise Solutions
      Accept Payments
      Process Payments
      Disbursals
      API References
      Webhooks
      Testing
      Refunds
      Guides
      Other Processes

      Send OTP API

      Checksum required: No

      Use Case


      To send OTP to the customer’s mobile number for login into Paytm ecosystem. This OTP is valid for 2 minutes.

      Request Attributes

      API Content format: JSON

      Head

      ATTRIBUTEDESCRIPTIONMANDATORY
      version String (4)Version of the API. Current version is v1.No
      requestTimestamp String (15)UNIX timestamp of the time request is being sentNo
      channelId String (3)For websites, the value is WEB. For Mobile websites/App, the value is WAPYes
      txnToken String (64)Provided in response of Create Subscription/ Initiate Transaction APIYes

      Body

      ATTRIBUTEDESCRIPTIONMANDATORY
      mobileNumber10 digit user mobile NoYes

      Response Attributes

      Head

      ATTRIBUTEDESCRIPTIONMANDATORY
      version String (2)Version of the API passed in the request.No
      responseTimestamp String (15)UNIX Timestamp of the responseYes

      Body

      ATTRIBUTEDESCRIPTIONMANDATORY
      resultInfo ResultInfoResult info of api requestYes
      extraParamsMap Map<String, Object>Map for any Extra informationNo

      ResultInfo

      ATTRIBUTEDESCRIPTIONMANDATORY
      resultCodeStringResult code returned to merchant . Max length of result code can be 64Yes
      resultStatusStringStatus of API call
      (S:Success, F:Failure, U:Unknown)
      Yes
      resultMsgString(256)Result Message contains information about the result.Yes

      Response Codes and Messages

      resultCoderesultStatusresultMsg
      01SSuccess
      02FOtp sent to phone
      202FHTTP Response Code other than 200 received in Generate OTP
      431FInvalid Mobile
      517FYour account is temporarily blocked. Please contact customer care.
      531FOops ! You have reached OTP limit, please raise a query at paytm.com/care.
      434FPlease try again after sometime.
      00000900USystem error

      Endpoints

      Staging: https://securegw-stage.paytm.in/login/sendOtp?mid={mid}&orderId={order-id}

      Production: https://securegw.paytm.in/login/sendOtp?mid={mid}&orderId={order-id}

      Request CodeResponse JSON
      curl -X POST 'https://securegw-stage.paytm.in/login/sendOtp?mid={mid}&orderId={order-id}' --header 'Content-Type: application/json' --data '{"head":{"txnToken":"{transaction-token}"},"body":{"mobileNumber":"{mobile-number}"}}'