---
title: "Notify Token Creation"
method: POST
path: "/notify-token-creation"
tags: ["Token Management"]
---

# Notify Token Creation

`POST /notify-token-creation`

Notify the token requestor about a token creation.

The notification shares the same 'x-correlation-id' as in the create token request.

If the tokenization failed, the notification only contains information about the error. No token data is provided.

In case of retryable error returned by the token requestor, the notification will be resent periodically with exponential backoff.

## Parameters

- `#/parameters/authorization` — unresolved $ref
- `#/parameters/xCorrelationId` — unresolved $ref

## Request body

- object
  - `tokenId` string — Identifier of the token
  - `merchantId` string, required — Identifier of the merchant provided by Thales at on-boarding.
  - `cardBin` string — The card bin returned by the scheme, just available for VISA and Mastercard SCOF.
  - `cardLastDigits` string — The card last digits.
  - `cardExpiryDate` string — Expiry date of the card in MMYY format
  - `tokenLastDigits` string — The token last digits.
  - `tokenExpiryDate` string — The token expiry date in format MMYY. This information can be missing. It is intended for display only at this step.<br>Rely on token expiry date in create transaction response for storage.
  - `par` string — Payment Account Reference returned by the Scheme TSP.
  - `vProvisionedTokenId` string — Specific to Visa. Another token identifier that shall be used only with Visa Cloud Token Framework.
  - `cardProduct` CardProduct — Information about the card product.
    - `issuerName` string — The card issuer name.
    - `cardType` 'CREDIT' | 'DEBIT' | 'PREPAID' | 'UNKNOWN', required — The card type.
    - `scheme` 'MASTERCARD' | 'VISA' | 'AMEX', required — The card scheme
    - `supportVisaCTF` boolean — Indicate if Visa Cloud Token Framework is available.
    - `cardDescription` string — The card description.
    - `cardArts` CardArts
      - `foregroundColor` string — Color used for the text displayed on the card (last digits, expiry date). Hexadecimal RGB color format.
      - `backgroundColor` string — Color used for card background. Hexadecimal RGB color format.
      - `cardBackgroundImageId` string — Asset identifier of the card background image. It doesn't contain the issuer/brand/co-brand logo.
      - `issuerLogoId` string — Asset identifier of the issuer logo.
      - `brandLogoId` string — Asset identifier of the primary brand logo.
      - `cobrandLogoId` string — Asset identifier of the cobrand logo.
      - `completeCardImageId` string — Asset identifier of the complete card image. Shall be preferred over the other assets when present.
      - `cardIconId` string — Asset identifier of the card icon.
      - `cardImageUrl` string — HTTP location of the card image. If present, no other identifier is provided and getAsset operation is not needed.
    - `termsAndConditionsUrl` string — Card issuer terms and conditions URL.
    - `privacyPolicyUrl` string — Card issuer privacy policy URL.
  - `error` Error — An error occurred
    - `error` string — Detailed description of the error that occurred.
  - `creationTimestamp` string — Token or binding creation timestamp compliant with ISO 8601.

## Other responses

- `204` — unresolved $ref
- `400` — unresolved $ref
- `401` — unresolved $ref
- `404` — unresolved $ref
- `429` — unresolved $ref
- `500` — unresolved $ref
- `503` — unresolved $ref

---

[API](https://skmtc.dev/thalescloud/apis/d1-oauth-api.md) · [All operations](https://skmtc.dev/thalescloud/apis/d1-oauth-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thalescloud/d1-oauth-api/revisions/96089514858c/schema)