---
title: "POST /token/resetmobilepin"
method: POST
path: "/token/resetmobilepin"
tags: ["Token Reset Mobile PIN"]
---

# POST /token/resetmobilepin

`POST /token/resetmobilepin`

Used to request that the Mobile PIN for a Mastercard Cloud-Based Payment token in a single issuer wallet is reset. The request is passed to the Credential Management System for processing. When the Mobile PIN is a token-level PIN (as opposed to a wallet-level PIN), the cardholder must choose a new PIN within 10 minutes of a Reset Mobile PIN action. Otherwise, the reset will need to be re-requested.

## Request body

- TokenResetMobilePinRequestSchema
  - `TokenResetMobilePinRequest` TokenResetMobilePinRequest
    - `AuditInfo` AuditInfo, required
      - `Organization` string, required — Name of the Issuer or Processor to which the Customer Service Representative who triggered the API request belongs.
      - `Phone` string — Phone Number of the Customer Service Representative who triggered the API request.
      - `UserId` string, required — User ID (as assigned by the Issuer/Processor) of the Customer Service Representative who triggered the API request.
      - `UserName` string, required — User Name of the Customer Service Representative who triggered the API request.
    - `CommentText` string — Comment related to the token mobile PIN reset.
    - `ReasonCode` string, required — The reason for the action. Valid values:<br /> "N" - Cardholder requested new Mobile PIN<br /> "R" ? Mobile PIN try counter violation
    - `TokenUniqueReference` string, required — The TokenUniqueReference of the token.

## Response `200`

Contains the details of the response message.

- TokenResetMobilePinResponseSchema
  - `TokenResetMobilePinResponse` SimpleTokenResponse
    - `Token` SimpleTokenCommentResponse
      - `CommentId` string — Identifier of the comment added. Only present when comment text was provided in the request.
      - `TokenUniqueReference` string, required — Unique reference to the Token.

## Other responses

- `default` — unexpected error

---

[API](https://skmtc.net/mastercard/apis/mdes.md) · [All operations](https://skmtc.net/mastercard/apis/mdes/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mastercard/mdes/versions/b04397d12c87/schema)
