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

      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
      emailoptional Email id of end user
      phonemandatory Phone number of end user
      clientId mandatory Paytm use the merchant key on the basis of clientId parameter value. It requires only if the merchant has more than one key.
      scopemandatory Name of the resource for which token is required(will be shared by Paytm)
      responseTypemandatory Oauth 2 token

      Response Attributes


      API Content Type: JSON

      Success Response

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

      Error Response

      PARAMETER DESCRIPTION
      status Response status
      Example: FAILURE
      responseCode Response code
      Example: 434
      message Error reason
      Example: "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"}'