Skip to main content
Object

​
Fields

​
id
required
A unique, 36 character identifier created by Tesouro and assigned to the ACH return.
​
acceptor
required
​
accountNumberEndingIn
The last few numbers of the bank account used as a visual reference to the full account numer.
​
accountOwnerName
The name of the bank account owner, as provided by the NACHA report.
​
accountOwnerType
The type of the bank account owner, as provided by the NACHA report.
​
accountType
The type of the bank account, e.g., Checking or Savings.
​
activityDate
required
The date Tesouro received the ach return.
​
amount
required
The amount of the ach return.
​
currency
required
The currency specified on the ach return.
​
organization
required
​
reasonCode
required
Nacha Return Codes and associated ISO Status Reason Codes for returns and reversals from the External Code List.
​
reason
required
Description of return reason.
​
routingNumber
required
A unique nine-digit number that identifies a bank and is used for electronic transactions. It’s also known as an ABA routing number, or routing transit number (RTN).
​
traceNumber
required
A unique 15 digit reference number created by the bank and used to investigate and research ACH transfers and returns.
​
transactionActivityDate
The date Tesouro recognized the original ACH payment request, based upon the acceptor cutoff. Formatted as YYYY-MM-DD
​
transactionAmount
required
The transaction amount submitted with the original ach request.
​
paymentId
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.
​
transactionDateTime
required
The date and time that Tesouro received the original ach transaction, in UTC. Formatted as 2024-03-27T02:40:00Z
​
transactionId
required
A unique identifier assigned by Tesouro to the original ach transaction.
​
transactionReference
A unique identifier from original ach transaction created by the entity holding the direct relationship with the Acceptor. Tesouro uses this identifier to manage idempotency.
​
transactionTraceNumber
required
A number that a bank can you to investigate and research an ach transaction.
​
transactionType
required
The type of original ach transaction, e.g., Sale or Refund.
{
  "id": "72ef289d-77d4-4696-8a08-da83ed15b751",
  "acceptor": Acceptor,
  "accountNumberEndingIn": "abc123",
  "accountOwnerName": "xyz789",
  "accountOwnerType": "CONSUMER",
  "accountType": "CHECKING",
  "activityDate": "2007-12-03",
  "amount": Decimal,
  "currency": "abc123",
  "organization": Organization,
  "reasonCode": "R01",
  "reason": "abc123",
  "routingNumber": "xyz789",
  "traceNumber": "xyz789",
  "transactionActivityDate": "2007-12-03",
  "transactionAmount": Decimal,
  "paymentId": "72ef289d-77d4-4696-8a08-da83ed15b751",
  "transactionDateTime": "2007-12-03T10:15:30Z",
  "transactionId": "72ef289d-77d4-4696-8a08-da83ed15b751",
  "transactionReference": "xyz789",
  "transactionTraceNumber": "xyz789",
  "transactionType": "AUTHORIZATION"
}