• Callback Response
  • Getting Started
    • Mobile Integration (Android/IOS)
      Enterprise Solutions
      Retail Solutions
      Accept Payments
      Process Payments
      Disbursals
      API References
      Refunds
      Guides
      Other links
      Mini Program Platform
  • Features for Investments PG
  • 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"}'