POSTNative Fetch User PayMode Status API
Use Case
API to fetch User PayMode Status in native flow. This API can be used to determine if a user has an active postpaid account or not with their phone number.
Request Attributes
Head
| Attribute | Description |
|---|---|
version string optional | Version of the API. Example: v1 |
channelId string optional | Channel through which call initiated Possible Values: WEB, WAP |
requestTimestamp string optional | Unix Timestamp of request |
tokenType string mandatory | Authorization method for this request |
token string mandatory | Authorization string corresponding to the tokenType used |
Body
| Attribute | Description |
|---|---|
mid string mandatory | Paytm provides MID as a unique identifier to each merchant. For your staging MID, click here. You get the production MID post the account activation. Example: INTEGR7769XXXXXX9383 |
mobileNo string optional | Example: 7777777777 |
userId string optional | paytm userId Example: 1000943226 |
referenceId string conditional | unique reference id and should have same value as used in create ACCESS token(v1/token/create) Example: ref_987654321 |
paymentMode string mandatory | List of paymodes |
Response Attributes
Head
| Attribute | Description |
|---|---|
responseTimestamp string | Example: 1525344042691 |
version string | Application version Example: v1 |
Body
| Attribute | Description | ||||||||
|---|---|---|---|---|---|---|---|---|---|
resultInfo Object | resultInfo Object | ||||||||
resultInfo +
| |||||||||
payModeStatus Object | List of user payMode status | ||||||||
payModeStatus +
| |||||||||
Response Codes & Messages
| resultCode | resultStatus | resultMsg |
|---|---|---|
| 1006 | F | Your Session has expired |
| 2004 | F | SSO Token is invalid |
| 2005 | F | Checksum provided is invalid |
| 2021 | F | Invalid token type |
| 1001 | F | Request parameters are not valid |
| 1007 | F | Missing mandatory element |
| 9999 | F | SYSTEM ERROR |
| 0000 | S | Success |
curl --location --request POST 'https://securegw-stage.paytm.in/theia/api/v1/fetchUserPaymentModeStatus' \
--header 'Content-Type: application/json' \
--data-raw '{"head": {"tokenType": "CHECKSUM","token": "ePFv9Ec2N9C5/UfwTae3uowxNnF5OszxF1YIIzL9Ze7Htc5bA6QnJziNSmz3Ut0uktX0CKDghMGbiFUVllmOut0hk39ta8mCscx0XKhAjmw="},"body": {"mid": "k1G7l346739004133410","mobileNo": "7777777777","paymentMode": ["PAYTM_DIGITAL_CREDIT"]}}'
