# CreateStandaloneTokenResponseDto

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

## Fields
- `id` (string(uuid)): The internal vault record id of the minted token. Deprecated for external use: charge with `publicReference` instead.
- `numericToken` (integer(int64)): Legacy numeric form of the token, retained for existing internal callers and back-compat. Not the preferred external handle: use `publicReference`. (nullable)
- `cardFormatToken` (string): Legacy card-format (PAN-shaped) form of the token, retained for existing internal callers and back-compat. Not the preferred external handle: use `publicReference`. (nullable)
- `publicReference` (string): The chargeable public reference of the minted token (the opaque `pt_`-prefixed handle). (nullable)
- `maskedPaymentDetails` ([PaymentDetailSnapshot](https://devportal.signapay-sbx.winkpg.io/docs/api/models/PaymentDetailSnapshot.md))
  Fields:
  - `cardData` ([CardData](https://devportal.signapay-sbx.winkpg.io/docs/api/models/CardData.md)): Conditional: When CardData is not null.
  - `checkData` ([CheckData](https://devportal.signapay-sbx.winkpg.io/docs/api/models/CheckData.md)): Conditional: When CheckData is not null.
  - `tokenData` ([TokenData](https://devportal.signapay-sbx.winkpg.io/docs/api/models/TokenData.md)): Conditional: When TokenData is not null.
  - `processorTokens` (array<[StoredProcessorToken](https://devportal.signapay-sbx.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.signapay-sbx.winkpg.io/docs/api/models/StoredNetworkToken.md)): The network token (DPAN) provisioned for this payment method, when one exists. On a read it carries only non-sensitive metadata: state, network, token suffix, expiry and timestamps. The token number and the provider identifiers are never returned.
  - `paymentMethodType` ([TokenPaymentMethodType](https://devportal.signapay-sbx.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.signapay-sbx.winkpg.io/docs/api/models/TokenType.md)): Defines the supported token types used in transaction-related models. Also aliased as the platform's payment-method category (`InitializeContext` imports it as `PaymentMethodCategory`), which is what the processor-profile pre-filter narrows on.
  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.signapay-sbx.winkpg.io/docs/api/models/TokenCategory.md)): Defines the category of a token used in transaction processing.
  Values:
  - `Internal`
  - `Network`
  - `Wallet`
- `idempotencyStatus` ([StandaloneTokenCreateIdempotencyStatus](https://devportal.signapay-sbx.winkpg.io/docs/api/models/StandaloneTokenCreateIdempotencyStatus.md)): What create idempotency did to the request that produced this response.
  Values:
  - `NotRequested`: The request carried no idempotencyKey, so there was nothing to deduplicate. A repeat send mints a second token for the same card.
  - `KeyAccepted`: The request carried an idempotencyKey and this request claimed it. This is the original create; a repeat send of the same request inside the deduplication window returns this token instead of minting another.
  - `Replayed`: The idempotencyKey matched a create that had already produced a token for this merchant and credential, so nothing was minted. The response body is that original token exactly as it stands, with its original identifiers and public reference.
- `storedCredentialConsentId` (string(uuid)): The id of the stored-credential consent recorded by a token create whose request carried one (a standalone create or a mint from a transaction); null otherwise. A later merchant-initiated charge on the token resolves the consent automatically, so sending this id as `storedCredentialConsentId` is optional. (nullable)
- `consentedCardPrice` ([ConsentedCardPriceDto](https://devportal.signapay-sbx.winkpg.io/docs/api/models/ConsentedCardPriceDto.md)): The dual pricing card price the stored-credential consent recorded, as the platform priced it from the merchant's configuration. Read-only: never taken from the request. Null when the request carried no consent, or when the consent recorded no card price.
  Fields:
  - `rate` (number(double)): The card price rate the consent recorded, as a decimal fraction of each payment's cash price (`0.04` is 4 percent). Read-only and priced by the platform. Null when the consent recorded an amount instead. (nullable)
  - `amount` (number(double)): The flat card price uplift the consent recorded for each payment, in the merchant's currency (the unit of the enrollment terms' `fixedAmount`). Read-only and priced by the platform. Null when the consent recorded a rate instead. (nullable)

## See also

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