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

      post Send OTP API

      Use Case


      This API is used to send the OTP to user's mobile. Paytm will send OTP to the mobile number passed in the request.

      Request Attributes


      API Content Type: JSON

      ATTRIBUTE DESCRIPTION MANDATORY
      email Email id of end user optional
      phone Phone number of end user mandatory
      clientId Paytm use the merchant key on the basis of clientId parameter value. It requires only if the merchant has more than one key. mandatory
      scope Name of the resource for which token is required(will be shared by Paytm) mandatory
      responseType Oauth 2 token mandatory

      Response Attributes


      API Content Type: JSON

      Success Response

      ATTRIBUTE DESCRIPTION EXAMPLE VALUE
      status Request status SUCCESS/FAILURE
      message Message of the Request Otp sent to phone
      responseCode Response code 01 / 02 (Note: 01-login, 02-Register)
      state Reference guid to be used while submitting otp 65cb6680-29f6-11e4-aad2-3c970ea8b87f

      Error Response

      PARAMETER DESCRIPTION EXAMPLE VALUE
      status Response status FAILURE
      responseCode Response code 434
      message Error reason "Bad Request"

      Response Codes and Messages


      ERROR CODES

      responseCodemessage
      430Invalid Authorization
      431Invalid Mobile
      432Login Failed
      433Account Blocked
      434Bad Request
      465Invalid Email
      StagingProduction
      REQUESTRESPONSE
      curl -X POST 'https://accounts-uat.paytm.com/signin/otp' \
      --header 'Content-Type: application/json' \
      --data '{"phone":"7777777777","clientId":"merchant-XXXXX","scope":"wallet","responseType":"Token"}'