• 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

      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 format: JSON

      ParameterDescriptionRequiredExample Value
      emailEmail id of end userNoabc@gmail.com
      phonePhone number of end userYes5558889990
      clientIdClientId by which key checksum is created, required to validate the checksum. Eg C11Nomerchant-ABC
      scopeName of the resource for which token is required(will be shared by Paytm)Yeswallet, paytm
      responseTypeOauth 2 tokenYestoken

      Response Attributes

      Success:

      ParameterDescriptionExample Value
      statusRequest statusSUCCESS/FAILURE
      messageMessage of the RequestOtp sent to phone
      responseCodeResponse code01 / 02 (Note: 01-login, 02-Register)
      stateReference guid to be used while submitting otp65cb6680-29f6-11e4-aad2-3c970ea8b87f

      Error Responses:

      ParameterDescriptionExample Value
      statusResponse statusFAILURE
      responseCodeResponse code434
      messageError reason"Bad Request"

      ERROR CODES

      430Invalid Authorization
      431Invalid Mobile
      432Login Failed
      433Account Blocked
      434Bad Request
      465Invalid Email

      Endpoints

      Staging: https://accounts-uat.paytm.com/signin/otp

      Production: https://accounts.paytm.com/signin/otp

      Request CodeResponse JSON
      curl -X POST 'https://accounts-uat.paytm.com/signin/otp' --header 'Content-Type: application/json' --data '{"phone":"{mobile-number}","clientId":"{client-id}","scope":"{scope}","responseType":"Token"}'