search

POSTgetUserInfo API

Use Case

This API gives a merchant the Paytm's user details (Profile Name, Email and Phone Number) corresponding to an access token. This should be used to facilitate seamless Login in the merchant's system.

Request Attributes

Content Type : JSON

Head

AttributeDescription
verification_type
string
mandatory

This is verification type like "oauth_token"

data
string
mandatory

Auth Token you received via S2S call in getAccessToken API

Authorization
string
mandatory

This will be a base64 encoded string of client_id:client_secret

Response Attributes

Content Type : JSON

Head

AttributeDescription
status
string

status of response

Example: 200

Success:

PARAMETER DESCRIPTION
email

Email Id of the user

Example: abc@xyz.com

profileInfo.displayName

Display name of the user

Example: Shaurya

phoneInfo.countryCode

Users country code

Example: 91

phoneInfo.phoneNumber

Phone number of the user

Example: 9878654532

Error Codes

RESPONSE CODE STATUS MESSAGE
401 Failure Unauthorized Request
434 Failure Bad Request
530 Failure Insufficient parameters
827 Failure There was issue in processing request
514 Failure User Not Found
827 Failure There was issue in processing request
1301 Failure Client does not have permission to fetch
3005 Failure Blocked due to security reasons
⇾
UAT
Production
https://accounts-uat.paytm.com/v2/user?fetch_strategy=profile_info,phone_number,emailcopy icon
REQUEST
RESPONSE
CURL
JAVASCRIPT
curl -X GET 'https://accounts.paytm.com/v2/user?fetch_strategy=profile_info,phone_number,email' \
--header 'verification_type: oauth_token' \
--header 'data: asdf-fdsf-werw-gdfg' \
--header 'cache-control: no-cache' \
--header 'Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l'
copy icon