reinitiateBankTransfer

Reinitiate a previously returned bank transfer transaction and return a payload that includes details of the resulting transaction.

Operation

mutation ReinitiateBankTransfer($reinitiateBankTransferInput: ReinitiateBankTransferInput!) {
  reinitiateBankTransfer(reinitiateBankTransferInput: $reinitiateBankTransferInput) {
    errors {
      ... on InternalServiceError {
        dateTimeUtc
        errorDateTime
        message
        processorResponseCode
        transactionId
      }
      ... 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 PriorPaymentNotFoundError {
        dateTimeUtc
        errorDateTime
        message
        processorResponseCode
        transactionId
      }
    }
    reinitiateBankTransferResponse {
      activityDate
      duration
      isDuplicateRequest
      message
      paymentId
      processorResponseCode
      sanitizedFields {
        fieldName
        fieldPath
        originalValue
        reason
        sanitizedValue
      }
      timestampUtc
      tokenDetails {
        token
        tokenizedPan
      }
      transactionId
    }
  }
}

Response

{
  "data": {
    "reinitiateBankTransfer": {
      "errors": [
        {
          "__typename": "InternalServiceError",
          "dateTimeUtc": "2026-01-15T14:30:00Z",
          "errorDateTime": "2026-01-15T14:30:00Z",
          "message": "example",
          "processorResponseCode": "A0000",
          "transactionId": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901"
        }
      ],
      "reinitiateBankTransferResponse": {
        "activityDate": "2026-01-15",
        "duration": 0,
        "isDuplicateRequest": true,
        "message": "example",
        "paymentId": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
        "processorResponseCode": "A0000",
        "sanitizedFields": [
          {
            "fieldName": "example",
            "fieldPath": "example",
            "originalValue": "example",
            "reason": "example",
            "sanitizedValue": "example"
          }
        ],
        "timestampUtc": "2026-01-15T14:30:00Z",
        "tokenDetails": {
          "token": "example",
          "tokenizedPan": "example"
        },
        "transactionId": "b6d4e5f6-7a8b-9012-3def-456789012345"
      }
    }
  }
}

Mutation

Arguments

reinitiateBankTransferInput · ReinitiateBankTransferInput! · required

Show child attributes

acceptorId · UUID! · required

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.

paymentId · UUID! · required

The unique ‘paymentId’ of the bank transfer transaction that is to be reinitiated.

transactionId · UUID! · required

The unique ‘transactionId’ of the specific transaction within the payment that is to be reinitiated.

transactionReference · Max36Text! · required

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

ReinitiateBankTransferPayload!

errors · [ReinitiateBankTransferError!]

Show Possible types

Show InternalServiceError

dateTimeUtc · DateTime! · required · deprecated

The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.

Deprecated: Use errorDateTime instead.

errorDateTime · DateTime! · required

The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.

message · String! · required

A human readable description of the error.

processorResponseCode · ProcessorResponseCode! · required

Tesouro response code indicating the error.

See ProcessorResponseCode

transactionId · UUID! · required

Unique ID for the transaction assigned by Tesouro.

Show RuleInViolationError

This occurs when an internal Tesouro business rule is in violation.

advice · String! · required

Advice on how to overcome the rule in the future.

dateTimeUtc · DateTime! · required · deprecated

The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.

Deprecated: Use errorDateTime instead.

errorDateTime · DateTime! · required

The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.

explanationOfRule · String! · required

An explanation of why the rule exists.

message · String! · required

A human readable description of the error.

processorResponseCode · ProcessorResponseCode! · required

Tesouro response code indicating the error.

See ProcessorResponseCode

ruleName · RuleName! · required

The name of the rule in violation

See RuleName

transactionId · UUID! · required

Unique ID for the transaction assigned by Tesouro.

Show SyntaxOnNetworkResponseError

attemptedNetwork · Network! · required

The network the transaction request was attempted with.

See Network

dateTimeUtc · DateTime! · required · deprecated

The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.

Deprecated: Use errorDateTime instead.

errorDateTime · DateTime! · required

The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.

message · String! · required

A human readable description of the error.

processorResponseCode · ProcessorResponseCode! · required

Tesouro response code indicating the error.

See ProcessorResponseCode

transactionId · UUID! · required

Unique ID for the transaction assigned by Tesouro.

Show TimeoutOnNetworkResponseError

attemptedNetwork · Network! · required

The network the authorization was attempted.

See Network

dateTimeUtc · DateTime! · required · deprecated

The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.

Deprecated: Use errorDateTime instead.

errorDateTime · DateTime! · required

The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.

message · String! · required

A human readable description of the error.

processorResponseCode · ProcessorResponseCode! · required

Tesouro response code indicating the error.

See ProcessorResponseCode

transactionId · UUID! · required

Unique ID for the transaction assigned by Tesouro.

waitTime · Int! · required

The amount of time Tesouro waited for a response in milliseconds.

Show ValidationFailureError

dateTimeUtc · DateTime! · required · deprecated

The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.

Deprecated: Use errorDateTime instead.

errorDateTime · DateTime! · required

The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.

fieldName · String! · required

The name of the graphql field in error.

fieldPath · String! · required

The path to the graphql field in error.

message · String! · required

A human readable description of the error.

processorResponseCode · ProcessorResponseCode! · required

Tesouro response code indicating the error.

See ProcessorResponseCode

transactionId · UUID! · required

Unique ID for the transaction assigned by Tesouro.

valueInError · String! · required

The value of the graphql field in error.

Show PriorPaymentNotFoundError

This occurs when a prior referenced payment cannot be found

dateTimeUtc · DateTime! · required · deprecated

The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.

Deprecated: Use errorDateTime instead.

errorDateTime · DateTime! · required

The date and time, in UTC, that the error occured. Formatted as 2024-03-27T02:40:00Z.

message · String! · required

A human readable description of the error.

processorResponseCode · ProcessorResponseCode! · required

Tesouro response code indicating the error.

See ProcessorResponseCode

transactionId · UUID! · required

Unique ID for the transaction assigned by Tesouro.

unknownPaymentId · UUID! · required

The payment id that cannot be found.

reinitiateBankTransferResponse · ReinitiateBankTransferResponse

Show child attributes

activityDate · Date! · required

The date Tesouro received the transaction based on acceptor cutoff time

duration · Int! · required · deprecated

Difference between request receipt and response in milliseconds.

Deprecated: New durations coming soon.

isDuplicateRequest · Boolean! · required

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.

message · String! · required

A detailed description of the response code. e.g., Insufficient funds.

paymentId · UUID! · required

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.

processorResponseCode · ProcessorResponseCode! · required

A normalized 4-character response code defined by Tesouro that represents the outcome of the payment transaction request.

See ProcessorResponseCode

sanitizedFields · [SanitizedFieldOutput!]! · required

List of fields that were detected as invalid and sanitized by Tesouro to prevent the payment transaction request from failing.

See SanitizedFieldOutput

timestampUtc · DateTime! · required

The UTC date and time the transaction was received by Tesouro.

tokenDetails · TokenDetails

Details associated with the token generated on a tokenization request.

See TokenDetails

transactionId · UUID! · required

A unique identifier created by Tesouro and assigned to the transaction.

Operation

mutation ReinitiateBankTransfer($reinitiateBankTransferInput: ReinitiateBankTransferInput!) {
  reinitiateBankTransfer(reinitiateBankTransferInput: $reinitiateBankTransferInput) {
    errors {
      ... on InternalServiceError {
        dateTimeUtc
        errorDateTime
        message
        processorResponseCode
        transactionId
      }
      ... 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 PriorPaymentNotFoundError {
        dateTimeUtc
        errorDateTime
        message
        processorResponseCode
        transactionId
      }
    }
    reinitiateBankTransferResponse {
      activityDate
      duration
      isDuplicateRequest
      message
      paymentId
      processorResponseCode
      sanitizedFields {
        fieldName
        fieldPath
        originalValue
        reason
        sanitizedValue
      }
      timestampUtc
      tokenDetails {
        token
        tokenizedPan
      }
      transactionId
    }
  }
}

Response

{
  "data": {
    "reinitiateBankTransfer": {
      "errors": [
        {
          "__typename": "InternalServiceError",
          "dateTimeUtc": "2026-01-15T14:30:00Z",
          "errorDateTime": "2026-01-15T14:30:00Z",
          "message": "example",
          "processorResponseCode": "A0000",
          "transactionId": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901"
        }
      ],
      "reinitiateBankTransferResponse": {
        "activityDate": "2026-01-15",
        "duration": 0,
        "isDuplicateRequest": true,
        "message": "example",
        "paymentId": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
        "processorResponseCode": "A0000",
        "sanitizedFields": [
          {
            "fieldName": "example",
            "fieldPath": "example",
            "originalValue": "example",
            "reason": "example",
            "sanitizedValue": "example"
          }
        ],
        "timestampUtc": "2026-01-15T14:30:00Z",
        "tokenDetails": {
          "token": "example",
          "tokenizedPan": "example"
        },
        "transactionId": "b6d4e5f6-7a8b-9012-3def-456789012345"
      }
    }
  }
}