POSTGenerate OTP API

Use Case

Once user logins through the registered mobile number, generate OTP API call is made to the router domain,to send the OTP to the customer’s mobile number so that the user can access Paytm Wallet

Request Attributes

Content Type : JSON

Head

Attribute	Description
requestTimeStamp string optional	EPOCH timestamp of the time at which request is being sent. Example: 1588402269
tokenType string mandatory	Token Type (Eg. TXN_TOKEN)
token string mandatory	Transaction Token

Body

Attribute	Description
mobileNumber string mandatory	10 digit user mobile No Example: 7777777777
autoReadHash string optional	Hash of app for auto reading of msgs

Response Attributes

Content Type : JSON

Head

Attribute	Description
responseTimestamp string	EPOCH timestamp of the time at which response is being sent.

Body

Attribute

Description

resultInfo

object

This parameter gives the information about the result of the API response

resultInfo

Attribute	Description
resultStatus string	This parameter is the result specific to the phase of the transaction mentioned in the txnType field
resultCode string	This is the resultCode corresponding to a particular message and is returned to the merchant. It's maximum length is 64.
resultMsg string	This parameter is the result message which contains information about the result.

Response Codes & Messages

resultCode	resultStatus	resultMsg
0000	S	Success
501	F	System error
531	F	Oops ! You have reached OTP limit, please raise a query at paytm.com/care.
1012	F	param missing
1011	F	Parameter illegal
827	F	This operation is not supported on mid
1006	F	Your Session has expired.
2014	F	OrderId in the query param doesn't match with the OrderId send in the request
2013	F	Mid in the query param doesn't match with the Mid send in the request
401	F	Authorization Failed
827	F	There was some issue in processing this request.
434	F	Bad Request
431	F	Invalid Mobile
435	F	User preference for network OTP is disabled.
433	F	Account Blocked
2222	F	Invalid request body

⇾

Staging

Production

https://stage-router.paytm.in/aoa-pay-option-service/v2/otp/generate?mid={mid}&orderId={orderId} copy icon

REQUEST

RESPONSE

CURL

JAVA

NODE

PHP

PYTHON

DOTNET

curl -X POST ‘https://stage-router.paytm.in/aoa-pay-option-service/v2/otp/generate?mid={mid}&orderId={orderId}’\
--header 'Content-Type: application/json' \
--data‘{"head": {"token": "{{txnToken}}","tokenType":"TXN_TOKEN"},"body": {"mobileNumber": "5909031804","autoReadHash": "hash"}}