---
title: "POST /token/activate"
method: POST
path: "/token/activate"
tags: ["Token Activate"]
---

# POST /token/activate

`POST /token/activate`

Used to activate a token for a digitization that has been approved and provisioned, but requires additional cardholder authentication prior to activation. If the provisioning was not completed successfully, activation cannot be accomplished using Customer Service API. It is expected that a cardholder will complete the authentication process using an issuer's call center or using an issuer-supplied mobile application, and only then should the issuer use this API to activate the token.

## Request body

- TokenActivateRequestSchema
  - `TokenActivateRequest` TokenActivateRequest
    - `AccountPan` string, integer — The Account PAN of the token to be activated. Conditional field, must be present when PaymentAppInstanceId is present, must not be present when TokenUniqueReference is present.
    - `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, integer — Comment related to activating this token.
    - `PaymentAppInstanceId` string, integer — Identifier of the Payment App instance within a device that will be provisioned with a token. <br><br>_Note:_ This may contain the identifier of the Secure Element or a mobile device for some programs. Conditional field, must be present when AccountPan is present. Must not be present when TokenUniqueReference is present.
    - `ReasonCode` string, required — Reason for the activation. Valid values:<br /> "A" = Cardholder successfully authenticated prior to activation.<br /> "C" = Cardholder successfully authenticated with a customer service agent prior to activation.
    - `TokenUniqueReference` string — TokenUniqueReference for the token to be activated. Conditional field, present when AccountPan and PaymentAppInstanceId are not present.

## Response `200`

Contains the details of the response message.

- TokenActivateResponseSchema
  - `TokenActivateResponse` 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)