View as Markdown

llms.txt

The API reference isn't available right now

This instance couldn't load its API specification. The reference returns as soon as the specification is readable again.

Back to the API reference

No such model

This instance publishes no model under that name. It may have been renamed, or no operation this installation serves uses it.

Back to the API reference

This reference may be out of date

This instance couldn't reach its API specification on the last attempt, so this page shows the copy fetched before that. Anything added or changed since then is missing here, and the reference updates itself as soon as the specification is readable again. Last fetched 2026-10-23 00:19 UTC.

API reference Models

PaymentTokenUpdateDto

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

Values

Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.

Fields

Field Type Description
numericToken required integer (int64) The numeric representation of the token. nullable
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
cardFormatToken required string The card format representation of the token. nullable
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
transactionId required 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
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
paymentDetails required PaymentDetailSnapshot PaymentDetailSnapshot The payment details snapshot associated with this token. Conditional: When PaymentDetails is not null.
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.

Fields of PaymentDetailSnapshot:

Field Type Description
cardData required CardData CardData Conditional: When CardData is not null.
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
checkData required CheckData CheckData Conditional: When CheckData is not null.
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
tokenData required TokenData TokenData Conditional: When TokenData is not null.
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
processorTokens required array of StoredProcessorToken array of StoredProcessorToken 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
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
networkToken required StoredNetworkToken StoredNetworkToken A stored network token (DPAN) for this payment method. Not populated: network-token acquisition is not yet supported, so this is always absent.
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
paymentMethodType required TokenPaymentMethodType TokenPaymentMethodType read only
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
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.

This body has no documented fields.

type required TokenType TokenType The underlying payment type of the token.
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
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 required TokenCategory TokenCategory The category of the token (e.g., internal, network).
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
Internal
Network
Wallet
merchantId required string (uuid) Id of the related Merchant. nullable
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
label required string Optional human-readable label for the token (e.g. "John's Visa"). nullable
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
customerId required string (uuid) Id of the related Customer. nullable
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
isActive required boolean Gets or sets a value indicating whether this entity is active. nullable
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
status required TokenStatus TokenStatus The status of the token (Active, Inactive, Invalidated, Redacted).
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
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 required string (uuid) The ID of the token that replaced this one (if invalidated and regenerated). nullable
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
replacesTokenId required string (uuid) The ID of the token that this token replaced (if this is a regenerated token). nullable
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
regenerationReason required TokenRegenerationReason TokenRegenerationReason The reason for token regeneration (if applicable). nullable
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
Manual Manually initiated by user.
NearExpiration Automated regeneration due to near expiration.
SuspectedCompromise Suspected compromise or security concern.
Other Other reason.
lastRegeneratedAt required string (date-time) The timestamp when this token was last regenerated. nullable
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.
concurrencyStamp required 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
Values: Values combine: send one or more member names separated by a comma and a space, or the integer sum of their values. Responses carry the names.

This model has no documented fields.

Reconnecting to the server

Could not reconnect

This session has ended

Attempt 1

Your work on this page is still here. Retrying keeps it; reloading starts the page again.

The server no longer holds this page's state, so it has to be loaded again.