mutation VerifyAccount($verifyAccountInput: VerifyAccountInput!) {
verifyAccount(verifyAccountInput: $verifyAccountInput) {
errors {
... on InternalServiceError {
dateTimeUtc
errorDateTime
message
processorResponseCode
transactionId
}
... on AcceptorNotFoundError {
dateTimeUtc
errorDateTime
message
organizationId
presenterId
}
... on RuleInViolationError {
advice
dateTimeUtc
errorDateTime
explanationOfRule
message
}
... on SyntaxOnNetworkResponseError {
attemptedNetwork
dateTimeUtc
errorDateTime
message
processorResponseCode
}
... on TimeoutOnNetworkResponseError {
attemptedNetwork
dateTimeUtc
errorDateTime
message
processorResponseCode
}
... on ValidationFailureError {
dateTimeUtc
errorDateTime
fieldName
fieldPath
message
}
... on UnknownCardError {
dateTimeUtc
errorDateTime
message
processorResponseCode
transactionId
}
... on TokenNotFoundError {
dateTimeUtc
errorDateTime
message
processorResponseCode
transactionId
}
... on InvalidTokenError {
dateTimeUtc
deTokenizedPaymentMethodType
errorDateTime
expectedPaymentMethodType
message
}
... on RouteNotFoundError {
boardedPaymentBrandsForAcceptor
dateTimeUtc
errorDateTime
message
paymentBrand
}
}
verifyAccountResponse {
activityDate
advice {
networkAdviceCode
}
avsResponseDetails {
avsResponseCode
networkCode
responseType
}
businessApplicationId
cardDetails {
last4
paymentBrand
}
cardSecurityCodeResponseDetails {
networkCode
processorCode
}
duration
isDuplicateRequest
message
nameVerificationResponseDetails {
processorCode
}
networkResponseDetails {
networkResponseCode
processorResponseCode
}
networkTransactionId
paymentId
processorResponseCode
sanitizedFields {
fieldName
fieldPath
originalValue
reason
sanitizedValue
}
systemTraceAuditNumber
timestampUtc
tokenDetails {
token
tokenizedPan
}
transactionId
}
}
}
{
"data": {
"verifyAccount": {
"errors": [
{
"__typename": "InternalServiceError",
"dateTimeUtc": "2026-01-15T14:30:00Z",
"errorDateTime": "2026-01-15T14:30:00Z",
"message": "example",
"processorResponseCode": "A0000",
"transactionId": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
}
],
"verifyAccountResponse": {
"activityDate": "2026-01-15",
"advice": {
"networkAdviceCode": "example"
},
"avsResponseDetails": {
"avsResponseCode": "ADDRESS_MATCHED_POSTALCODE_MATCHED",
"networkCode": "example",
"responseType": "FULL_MATCH"
},
"businessApplicationId": "CB",
"cardDetails": {
"last4": "1234",
"paymentBrand": "VISA"
},
"cardSecurityCodeResponseDetails": {
"networkCode": "example",
"processorCode": "MATCH"
},
"duration": 0,
"isDuplicateRequest": true,
"message": "example",
"nameVerificationResponseDetails": {
"processorCode": "MATCH"
},
"networkResponseDetails": {
"networkResponseCode": "example",
"processorResponseCode": "A0000"
},
"networkTransactionId": "example",
"paymentId": "c9a1e2d3-4b5f-6789-0abc-def123456789",
"processorResponseCode": "A0000",
"sanitizedFields": [
{
"fieldName": "example",
"fieldPath": "example",
"originalValue": "example",
"reason": "example",
"sanitizedValue": "example"
}
],
"systemTraceAuditNumber": "example",
"timestampUtc": "2026-01-15T14:30:00Z",
"tokenDetails": {
"token": "example",
"tokenizedPan": "example"
},
"transactionId": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901"
}
}
}
}
Transaction Processing
verifyAccount
Run an account verification request and return a payload that includes details of the resulting transaction.
mutation VerifyAccount($verifyAccountInput: VerifyAccountInput!) {
verifyAccount(verifyAccountInput: $verifyAccountInput) {
errors {
... on InternalServiceError {
dateTimeUtc
errorDateTime
message
processorResponseCode
transactionId
}
... on AcceptorNotFoundError {
dateTimeUtc
errorDateTime
message
organizationId
presenterId
}
... on RuleInViolationError {
advice
dateTimeUtc
errorDateTime
explanationOfRule
message
}
... on SyntaxOnNetworkResponseError {
attemptedNetwork
dateTimeUtc
errorDateTime
message
processorResponseCode
}
... on TimeoutOnNetworkResponseError {
attemptedNetwork
dateTimeUtc
errorDateTime
message
processorResponseCode
}
... on ValidationFailureError {
dateTimeUtc
errorDateTime
fieldName
fieldPath
message
}
... on UnknownCardError {
dateTimeUtc
errorDateTime
message
processorResponseCode
transactionId
}
... on TokenNotFoundError {
dateTimeUtc
errorDateTime
message
processorResponseCode
transactionId
}
... on InvalidTokenError {
dateTimeUtc
deTokenizedPaymentMethodType
errorDateTime
expectedPaymentMethodType
message
}
... on RouteNotFoundError {
boardedPaymentBrandsForAcceptor
dateTimeUtc
errorDateTime
message
paymentBrand
}
}
verifyAccountResponse {
activityDate
advice {
networkAdviceCode
}
avsResponseDetails {
avsResponseCode
networkCode
responseType
}
businessApplicationId
cardDetails {
last4
paymentBrand
}
cardSecurityCodeResponseDetails {
networkCode
processorCode
}
duration
isDuplicateRequest
message
nameVerificationResponseDetails {
processorCode
}
networkResponseDetails {
networkResponseCode
processorResponseCode
}
networkTransactionId
paymentId
processorResponseCode
sanitizedFields {
fieldName
fieldPath
originalValue
reason
sanitizedValue
}
systemTraceAuditNumber
timestampUtc
tokenDetails {
token
tokenizedPan
}
transactionId
}
}
}
{
"data": {
"verifyAccount": {
"errors": [
{
"__typename": "InternalServiceError",
"dateTimeUtc": "2026-01-15T14:30:00Z",
"errorDateTime": "2026-01-15T14:30:00Z",
"message": "example",
"processorResponseCode": "A0000",
"transactionId": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
}
],
"verifyAccountResponse": {
"activityDate": "2026-01-15",
"advice": {
"networkAdviceCode": "example"
},
"avsResponseDetails": {
"avsResponseCode": "ADDRESS_MATCHED_POSTALCODE_MATCHED",
"networkCode": "example",
"responseType": "FULL_MATCH"
},
"businessApplicationId": "CB",
"cardDetails": {
"last4": "1234",
"paymentBrand": "VISA"
},
"cardSecurityCodeResponseDetails": {
"networkCode": "example",
"processorCode": "MATCH"
},
"duration": 0,
"isDuplicateRequest": true,
"message": "example",
"nameVerificationResponseDetails": {
"processorCode": "MATCH"
},
"networkResponseDetails": {
"networkResponseCode": "example",
"processorResponseCode": "A0000"
},
"networkTransactionId": "example",
"paymentId": "c9a1e2d3-4b5f-6789-0abc-def123456789",
"processorResponseCode": "A0000",
"sanitizedFields": [
{
"fieldName": "example",
"fieldPath": "example",
"originalValue": "example",
"reason": "example",
"sanitizedValue": "example"
}
],
"systemTraceAuditNumber": "example",
"timestampUtc": "2026-01-15T14:30:00Z",
"tokenDetails": {
"token": "example",
"tokenizedPan": "example"
},
"transactionId": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901"
}
}
}
}
Documentation Index
Fetch the complete documentation index at: https://docs.tesouro.com/llms.txt
Use this file to discover all available pages before exploring further.
Mutation
Arguments
Show child attributes
Show child attributes
A unique, 36 character identifier created by Tesouro and assigned to the entity providing the goods or services to the cardholder, such as a Merchant, a Submerchant of a Payment Facilitator, a Seller within a Marketplace, or a Biller of a Consumer Bill Payment Service Provider (CBPS). Historically, processors have called this identifier the Merchant ID (or MID), Outlet ID, or Customer number.
The billing address associated with the payment method used on the transaction.See AddressDetailsInput
How the consumer interacts with the acceptor. Defaults to ECOMMERCE if not provided.See PaymentChannel
Details pertaining to the customer’s order.See OrderDetailsInput
Details regarding the payment method.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The two-digit month (MM) of the card’s expiration date.
The four-digit year (YYYY) of the card’s expiration date.
The 3 digit number (or 4 digit if American Express) found on the customer’s card, or the specific reason if the security code is omitted from the request.See SecurityCodeInput
The value of the acquirer token.
The value of the acquirer token.Deprecated: Use token instead.
The wallet provider for this payment method. Null if not applicable.See WalletType
Show child attributes
Show child attributes
The card number used in processing the transaction. This is a full PAN.
The two-digit month (MM) of the card’s expiration date.
The four-digit year (YYYY) of the card’s expiration date.
[DEPRECATED: Use root level channel instead] The card-present or card-not-present channel from which the customer makes a payment, e.g., In-store using a physical card terminal, online, or over the phone or through mail orderDeprecated: Use root level Channel instead.See PanEntryChannel
The means by which the card number was entered.See PanEntryMode
The 3 digit number (or 4 digit if American Express) found on the customer’s card, or the specific reason if the security code is omitted from the request.See SecurityCodeInput
Optional field to be used on customer initiated transactions. Indicates that the presenter intends to store this payment method on file to be used with future merchant initiated transactions.
Show Possible enum values
Show Possible enum values
The presenter has received consent from the cardholder to store their card details on file.
The wallet provider for this payment method. Null if not applicable.See WalletType
Show child attributes
Show child attributes
The cryptogram generated by the token provider to be used on the transaction.
Ecommerce indicator provided by the wallet provider.
The two-digit month (MM) of the card’s expiration date.
The four-digit year (YYYY) of the card’s expiration date.
[DEPRECATED: Network tokens do not have security codes, so this will be removed.] The 3 digit number (or 4 digit if American Express) found on the customer’s card, or the specific reason if the security code is omitted from the request.Deprecated: Network tokens do not have security codes, so this will be removed.See SecurityCodeInput
The value of the network token.
The wallet provider for this payment method. Null if not applicable.See WalletType
A unique identifier created by the entity holding the direct relationship with the Acceptor, and used by that entity for reconciliation and transaction search. Tesouro uses this identifier to manage idempotency.
Return type
VerifyAccountPayload!
Show Possible types
Show Possible types
Show InternalServiceError
Show InternalServiceError
The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.Deprecated: Use errorDateTime instead.
The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.
A human readable description of the error.
Tesouro response code indicating the error.See ProcessorResponseCode
Unique ID for the transaction assigned by Tesouro.
Show AcceptorNotFoundError
Show AcceptorNotFoundError
This occurs when an acceptor cannot be found because it does not exist or because it is not presented by the submitted presenter.
The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.Deprecated: Use errorDateTime instead.
The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.
A human readable description of the error.
The organization Id presented with this transaction.
The presenter Id presented with this transaction.
Tesouro response code indicating the error.See ProcessorResponseCode
Unique ID for the transaction assigned by Tesouro.
The invalid acceptor Id.
Show RuleInViolationError
Show RuleInViolationError
This occurs when an internal Tesouro business rule is in violation.
Advice on how to overcome the rule in the future.
The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.Deprecated: Use errorDateTime instead.
The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.
An explanation of why the rule exists.
A human readable description of the error.
Tesouro response code indicating the error.See ProcessorResponseCode
Unique ID for the transaction assigned by Tesouro.
Show SyntaxOnNetworkResponseError
Show SyntaxOnNetworkResponseError
The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.Deprecated: Use errorDateTime instead.
The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.
A human readable description of the error.
Tesouro response code indicating the error.See ProcessorResponseCode
Unique ID for the transaction assigned by Tesouro.
Show TimeoutOnNetworkResponseError
Show TimeoutOnNetworkResponseError
The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.Deprecated: Use errorDateTime instead.
The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.
A human readable description of the error.
Tesouro response code indicating the error.See ProcessorResponseCode
Unique ID for the transaction assigned by Tesouro.
The amount of time Tesouro waited for a response in milliseconds.
Show ValidationFailureError
Show ValidationFailureError
The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.Deprecated: Use errorDateTime instead.
The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.
The name of the graphql field in error.
The path to the graphql field in error.
A human readable description of the error.
Tesouro response code indicating the error.See ProcessorResponseCode
Unique ID for the transaction assigned by Tesouro.
The value of the graphql field in error.
Show UnknownCardError
Show UnknownCardError
The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.Deprecated: Use errorDateTime instead.
The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.
A human readable description of the error.
Tesouro response code indicating the error.See ProcessorResponseCode
Unique ID for the transaction assigned by Tesouro.
Show TokenNotFoundError
Show TokenNotFoundError
The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.Deprecated: Use errorDateTime instead.
The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.
A human readable description of the error.
Tesouro response code indicating the error.See ProcessorResponseCode
Unique ID for the transaction assigned by Tesouro.
Show InvalidTokenError
Show InvalidTokenError
Occurs when an acquirer token deTokenizes into a payment method that is not supportedby the current action.
The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.Deprecated: Use errorDateTime instead.
The type of payment method behind the token.
The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.
A human readable description of the error.
Tesouro response code indicating the error.See ProcessorResponseCode
Unique ID for the transaction assigned by Tesouro.
Show RouteNotFoundError
Show RouteNotFoundError
Occurs when there is no boarded route with Tesouro to process the presented payment method.
The current list of payment brands Tesouro has routes to support.See PaymentBrand
The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.Deprecated: Use errorDateTime instead.
The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.
A human readable description of the error.
The assigned payment brand of the payment method presented for processing.See PaymentBrand
Tesouro response code indicating the error.See ProcessorResponseCode
Unique ID for the transaction assigned by Tesouro.
Show child attributes
Show child attributes
The date Tesouro received the transaction based on acceptor cutoff time
Address Verification Service (AVS) is a service provided by the payment brands that determines the match or partial match of the consumer’s address information.See AddressVerificationResponse
The business application identifier (BAI) is a value provided by Visa to identify the type of transfer that is being performed.See BusinessApplicationId
Details related to the card used on the transactionSee CardInformation
The security code response from the network.See CardSecurityCodeResponseDetails
Difference between request receipt and response in milliseconds.Deprecated: New durations coming soon.
Result of Tesouro’s idempotency check. If the transaction reference matches that of another transaction from that presenter it will be treated as a duplicate.
A detailed description of the response code. e.g., Insufficient funds.
Name verification service result provided by the payment brand.See NameVerificationResponseDetails
The response code from the network.See NetworkResponseDetails
The transaction ID forwarded from the network response.
A unique 36 character identifier created by Tesouro and assigned to a group of transactions in the same payment request cohort. e.g., An authorization request, incremental authorization request, and the final capture would have the same paymentID.
A normalized 4-character response code defined by Tesouro that represents the outcome of the payment transaction request.See ProcessorResponseCode
List of fields that were detected as invalid and sanitized by Tesouro to prevent the payment transaction request from failing.See SanitizedFieldOutput
The system trace audit number sent to the network.
The UTC date and time the transaction was received by Tesouro.
Details associated with the token generated on a tokenization request.See TokenDetails
A unique identifier created by Tesouro and assigned to the transaction.
mutation VerifyAccount($verifyAccountInput: VerifyAccountInput!) {
verifyAccount(verifyAccountInput: $verifyAccountInput) {
errors {
... on InternalServiceError {
dateTimeUtc
errorDateTime
message
processorResponseCode
transactionId
}
... on AcceptorNotFoundError {
dateTimeUtc
errorDateTime
message
organizationId
presenterId
}
... on RuleInViolationError {
advice
dateTimeUtc
errorDateTime
explanationOfRule
message
}
... on SyntaxOnNetworkResponseError {
attemptedNetwork
dateTimeUtc
errorDateTime
message
processorResponseCode
}
... on TimeoutOnNetworkResponseError {
attemptedNetwork
dateTimeUtc
errorDateTime
message
processorResponseCode
}
... on ValidationFailureError {
dateTimeUtc
errorDateTime
fieldName
fieldPath
message
}
... on UnknownCardError {
dateTimeUtc
errorDateTime
message
processorResponseCode
transactionId
}
... on TokenNotFoundError {
dateTimeUtc
errorDateTime
message
processorResponseCode
transactionId
}
... on InvalidTokenError {
dateTimeUtc
deTokenizedPaymentMethodType
errorDateTime
expectedPaymentMethodType
message
}
... on RouteNotFoundError {
boardedPaymentBrandsForAcceptor
dateTimeUtc
errorDateTime
message
paymentBrand
}
}
verifyAccountResponse {
activityDate
advice {
networkAdviceCode
}
avsResponseDetails {
avsResponseCode
networkCode
responseType
}
businessApplicationId
cardDetails {
last4
paymentBrand
}
cardSecurityCodeResponseDetails {
networkCode
processorCode
}
duration
isDuplicateRequest
message
nameVerificationResponseDetails {
processorCode
}
networkResponseDetails {
networkResponseCode
processorResponseCode
}
networkTransactionId
paymentId
processorResponseCode
sanitizedFields {
fieldName
fieldPath
originalValue
reason
sanitizedValue
}
systemTraceAuditNumber
timestampUtc
tokenDetails {
token
tokenizedPan
}
transactionId
}
}
}
{
"data": {
"verifyAccount": {
"errors": [
{
"__typename": "InternalServiceError",
"dateTimeUtc": "2026-01-15T14:30:00Z",
"errorDateTime": "2026-01-15T14:30:00Z",
"message": "example",
"processorResponseCode": "A0000",
"transactionId": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
}
],
"verifyAccountResponse": {
"activityDate": "2026-01-15",
"advice": {
"networkAdviceCode": "example"
},
"avsResponseDetails": {
"avsResponseCode": "ADDRESS_MATCHED_POSTALCODE_MATCHED",
"networkCode": "example",
"responseType": "FULL_MATCH"
},
"businessApplicationId": "CB",
"cardDetails": {
"last4": "1234",
"paymentBrand": "VISA"
},
"cardSecurityCodeResponseDetails": {
"networkCode": "example",
"processorCode": "MATCH"
},
"duration": 0,
"isDuplicateRequest": true,
"message": "example",
"nameVerificationResponseDetails": {
"processorCode": "MATCH"
},
"networkResponseDetails": {
"networkResponseCode": "example",
"processorResponseCode": "A0000"
},
"networkTransactionId": "example",
"paymentId": "c9a1e2d3-4b5f-6789-0abc-def123456789",
"processorResponseCode": "A0000",
"sanitizedFields": [
{
"fieldName": "example",
"fieldPath": "example",
"originalValue": "example",
"reason": "example",
"sanitizedValue": "example"
}
],
"systemTraceAuditNumber": "example",
"timestampUtc": "2026-01-15T14:30:00Z",
"tokenDetails": {
"token": "example",
"tokenizedPan": "example"
},
"transactionId": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901"
}
}
}
}
Was this page helpful?
⌘I