# PaymentTokenUpdateDto

A model the API reference uses in a request or a response. The operation pages link every field typed as this model here.

## Fields
- `numericToken` (integer(int64)): The numeric representation of the token. (nullable)
- `cardFormatToken` (string): The card format representation of the token. (nullable)
- `transactionId` (string(uuid)): The unique identifier of the transaction that minted the token, when one did. Stored as  supplied on create; a token created with it reads as transaction-created, and one created  without it as standalone. (nullable)
- `paymentDetails` ([PaymentDetailSnapshot](https://devportal.demo.winkpg.io/docs/api/models/PaymentDetailSnapshot.md)): The payment details snapshot associated with this token. Conditional: When PaymentDetails is not null.
  Fields:
  - `cardData` ([CardData](https://devportal.demo.winkpg.io/docs/api/models/CardData.md)): Conditional: When CardData is not null.
  - `checkData` ([CheckData](https://devportal.demo.winkpg.io/docs/api/models/CheckData.md)): Conditional: When CheckData is not null.
  - `tokenData` ([TokenData](https://devportal.demo.winkpg.io/docs/api/models/TokenData.md)): Conditional: When TokenData is not null.
  - `processorTokens` (array<[StoredProcessorToken](https://devportal.demo.winkpg.io/docs/api/models/StoredProcessorToken.md)>): Processor-issued reusable tokens (e.g. TSYS `RequestToken`) captured at auth time  and stored alongside the card. Keyed by processor + processor profile; a repeat sale  prefers a matching token at the rail and falls back to the PAN. An empty list when no  processor token is held. (nullable)
  - `networkToken` ([StoredNetworkToken](https://devportal.demo.winkpg.io/docs/api/models/StoredNetworkToken.md)): A stored network token (DPAN) for this payment method. Not populated: network-token  acquisition is not yet supported, so this is always absent.
  - `paymentMethodType` ([TokenPaymentMethodType](https://devportal.demo.winkpg.io/docs/api/models/TokenPaymentMethodType.md)): (read only)
    Values:
    - `Unknown`: Not classified.
    - `Card`: A card, keyed or read.
    - `Check`: A bank account debited over ACH, or a check.
    - `DigitalWallet`: A digital wallet (Apple Pay, Google Pay, Paze), which rides the card networks.
    - `AlternativePayment`: An alternative payment method approved inside a provider and presented as an approval reference.
- `type` ([TokenType](https://devportal.demo.winkpg.io/docs/api/models/TokenType.md)): The underlying payment type of the token.
  Values:
  - `Card`: A card, keyed or read.
  - `Check`: A bank account debited over ACH, or a check.
  - `Cash`: Cash, which carries no instrument block of its own.
  - `DigitalWallet`: A digital wallet (Apple Pay, Google Pay, Paze), which rides the card networks.
  - `AlternativePayment`: An alternative payment method approved inside a provider (PayPal, Venmo, Pay Later, Affirm, Klarna, Afterpay) and presented to the gateway as an approval reference.
- `category` ([TokenCategory](https://devportal.demo.winkpg.io/docs/api/models/TokenCategory.md)): The category of the token (e.g., internal, network).
  Values:
  - `Internal`
  - `Network`
  - `Wallet`
- `merchantId` (string(uuid)): Id of the related Merchant. (nullable)
- `label` (string): Optional human-readable label for the token (e.g. "John's Visa"). (nullable)
- `customerId` (string(uuid)): Id of the related Customer. (nullable)
- `isActive` (boolean): Gets or sets a value indicating whether this entity is active. (nullable)
- `status` ([TokenStatus](https://devportal.demo.winkpg.io/docs/api/models/TokenStatus.md)): The status of the token (Active, Inactive, Invalidated, Redacted).
  Values:
  - `Active`: Token is active and can be used for transactions.
  - `Inactive`: Token is inactive but can be reactivated.
  - `Invalidated`: Token has been invalidated and replaced by a new token. Cannot be used for new transactions and cannot be reactivated.
  - `Redacted`: The vaulted account data has been wiped at the owner's request, leaving an audit shell: the last four, brand, BIN metadata, expiry, customer, merchant and lifecycle history survive, and the card number, cardholder name, bank account / routing / MICR values and any stored processor or network token do not.
- `invalidatedByTokenId` (string(uuid)): The ID of the token that replaced this one (if invalidated and regenerated). (nullable)
- `replacesTokenId` (string(uuid)): The ID of the token that this token replaced (if this is a regenerated token). (nullable)
- `regenerationReason` ([TokenRegenerationReason](https://devportal.demo.winkpg.io/docs/api/models/TokenRegenerationReason.md)): The reason for token regeneration (if applicable). (nullable)
  Values:
  - `Manual`: Manually initiated by user.
  - `NearExpiration`: Automated regeneration due to near expiration.
  - `SuspectedCompromise`: Suspected compromise or security concern.
  - `Other`: Other reason.
- `lastRegeneratedAt` (string(date-time)): The timestamp when this token was last regenerated. (nullable)
- `concurrencyStamp` (string): The concurrency stamp read from the token being updated. When supplied, the update is  rejected with a conflict if the stored token has since changed. Omit it to accept  last-write-wins. (nullable)

## See also

- [All documentation](https://devportal.demo.winkpg.io/llms.txt): the machine-readable index of every public page on this site.