OBJECT
Extension on Organization providing counts of acceptor applications grouped by status.
Fields
UUID!
required
The id of the organization as defined in their profile.
AchNotificationOfChangeCollection
A Notification of Change (NOC), notifies the sender of an ACH payment that information related to the customer’s bank account was inaccurate or outdated, and provides the updated information that needs to be corrected before another payment can be sent from (or to) the account.
Show child attributes
Show child attributes
[AchNotificationOfChange!]!
required
Show child attributes
Show child attributes
Acceptor
Show child attributes
Show child attributes
AllocationDetailCollection
An itemized list of applied allocations for a given transaction activity date or funds release date.
AuthorizationSummaryCollection
A summary of authorizations (counts, amounts) for the given transaction date, grouped by acceptor, transaction currency, response code, and payment brand.
BillingDescriptor!
required
Billing descriptor information for the acceptor.
String!
required
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.
FeeCollection
An itemized list of applied fees for a given transaction activity date or funds release date.
FeeSummaryCollection
A summary of aggregated fees by acceptor and fee name/program for a specified activity date or funds release date, grouped by fee type, and where applicable, payment brand, product, and funding source.
FundingAchReturnOutputCollection
An itemized list of financially impacting ach returns occuring on the pertinent funds release dates. Use this report to track ach return-related money-movements.
FundingDisputeEventOutputCollection
An itemized list of financially impacting dispute events occuring on the pertinent funds release dates. Use this report to track dispute-related money-movements.
FundingSummaryCollection
A summary of financial activity for a given funds release date or transaction activity date. Use this report to understand financial impact of daily sales, reconcile sales activity to your bank deposits, or drill deeper into the composition of your funding.
FundingTransactionCollection
An itemized list of funded transactions (captures, sales, and refunds) for the selected transaction activity date or funds release date.
UUID!
required
The id of the acceptor as defined in their profile.
String!
required
deprecated
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.Deprecated: Use businessName instead.
PaymentTransactionCollection
A list of transaction requests (including conveyed) submitted on the pertinent transaction activity dates. Use this report as an operational tool to reconcile against your internal record of submitted transactions.
PaymentTransactionSummaryCollection
A summary of transaction aggregates (counts and amounts, including conveyed transactions) by pertinent transaction type, currency, card brand, and transaction activity date.
String!
required
The acceptor provided reference as defined in their profile.
String!
required
The original bank account number.
String
The updated bank account number.
BankAccountType!
required
The type of bank account, either Checking or Savings, specified on the original transaction.
BankAccountType
Date!
required
The date the notification of change was received by Tesouro.
String!
required
A reader friendly description of the Change reason code.
AchNotificationOfChangeCodes!
required
A unique code signaling that information in a prior ACH entry needs updating.
Show Possible enum values
Show Possible enum values
enum
Incorrect bank account number
enum
Incorrect transit/routing number
enum
Incorrect transit/routing number and bank account number
enum
Bank account name change
enum
Incorrect payment code
enum
Incorrect bank account number and transit code
enum
Incorrect transit/routing number, bank account number and payment code
enum
Corrected foreign routing number
enum
Incorrect individual ID number
enum
Incorrect company name
enum
Incorrect company identification
enum
Incorrect company name and company ID
UUID!
required
A unique 36 character identifier created by Tesouro, and assigned to the specific change notification.
Organization
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.
String!
required
The original unique nine-digit number identifying the bank.
String
The updated routing number.
Date!
required
The date Tesouro recognized the transaction that triggered the notification of change.
Decimal!
required
The transaction amount submitted with the transaction request.
String!
required
The currency specified on the transaction request, in ISO 4217 alpha currency code format.
DateTime!
required
The date and time that Tesouro received the transaction request, in UTC. Formatted as 2024-03-27T02:40:00Z
UUID!
required
The unique 36 character identifier Tesouro assigned to the transaction that triggered the notification of change.
String!
required
The unique identifier assigned to the transaction by the acceptor (or partner) and included in the original transaction request sent to Tesouro.
TransactionType!
required
The type of transaction, either an ACH debit (sale) or ACH debit (refund).
Show Possible enum values
Show Possible enum values
enum
Card authorization.
enum
Incremental authorization.
enum
Capture previous authorization.
enum
Clearing of previous capture.
enum
Sale / charge.
enum
Refund transaction.
enum
Reversal / Void transaction.
enum
Card verification transaction.
enum
Authorization for refund.
enum
Account validation transaction.
AchReturnCollection
An itemized list of ach returns for a given transaction activity date or acticity date.
Show child attributes
Show child attributes
[AchReturn!]!
required
Show child attributes
Show child attributes
Acceptor!
required
Show child attributes
Show child attributes
AllocationDetailCollection
An itemized list of applied allocations for a given transaction activity date or funds release date.
AuthorizationSummaryCollection
A summary of authorizations (counts, amounts) for the given transaction date, grouped by acceptor, transaction currency, response code, and payment brand.
BillingDescriptor!
required
Billing descriptor information for the acceptor.
String!
required
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.
FeeCollection
An itemized list of applied fees for a given transaction activity date or funds release date.
FeeSummaryCollection
A summary of aggregated fees by acceptor and fee name/program for a specified activity date or funds release date, grouped by fee type, and where applicable, payment brand, product, and funding source.
FundingAchReturnOutputCollection
An itemized list of financially impacting ach returns occuring on the pertinent funds release dates. Use this report to track ach return-related money-movements.
FundingDisputeEventOutputCollection
An itemized list of financially impacting dispute events occuring on the pertinent funds release dates. Use this report to track dispute-related money-movements.
FundingSummaryCollection
A summary of financial activity for a given funds release date or transaction activity date. Use this report to understand financial impact of daily sales, reconcile sales activity to your bank deposits, or drill deeper into the composition of your funding.
FundingTransactionCollection
An itemized list of funded transactions (captures, sales, and refunds) for the selected transaction activity date or funds release date.
UUID!
required
The id of the acceptor as defined in their profile.
String!
required
deprecated
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.Deprecated: Use businessName instead.
PaymentTransactionCollection
A list of transaction requests (including conveyed) submitted on the pertinent transaction activity dates. Use this report as an operational tool to reconcile against your internal record of submitted transactions.
PaymentTransactionSummaryCollection
A summary of transaction aggregates (counts and amounts, including conveyed transactions) by pertinent transaction type, currency, card brand, and transaction activity date.
String!
required
The acceptor provided reference as defined in their profile.
String
The last few numbers of the bank account used as a visual reference to the full account numer.
String
The name of the bank account owner, as provided by the NACHA report.
AccountOwnerType
BankAccountType
Date!
required
The date Tesouro received the ach return.
Decimal!
required
The amount of the ach return.
String!
required
The currency specified on the ach return.
UUID!
required
A unique, 36 character identifier created by Tesouro and assigned to the ACH return.
Organization!
required
UUID
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.
String!
required
Description of return reason.
AchReturnCode!
required
Nacha Return Codes and associated ISO Status Reason Codes for returns and reversals from the External Code List.
String!
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).
String!
required
A unique 15 digit reference number created by the bank and used to investigate and research ACH transfers and returns.
Date
The date Tesouro recognized the original ACH payment request, based upon the acceptor cutoff. Formatted as YYYY-MM-DD
Decimal!
required
The transaction amount submitted with the original ach request.
DateTime!
required
The date and time that Tesouro received the original ach transaction, in UTC. Formatted as 2024-03-27T02:40:00Z
UUID!
required
A unique identifier assigned by Tesouro to the original ach transaction.
String
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.
String!
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.
Show Possible enum values
Show Possible enum values
enum
Card authorization.
enum
Incremental authorization.
enum
Capture previous authorization.
enum
Clearing of previous capture.
enum
Sale / charge.
enum
Refund transaction.
enum
Reversal / Void transaction.
enum
Card verification transaction.
enum
Authorization for refund.
enum
Account validation transaction.
AllocationDetailCollection
An itemized list of applied allocations for a given transaction activity date or funds release date.
Show child attributes
Show child attributes
[AllocationDetail!]!
required
Show child attributes
Show child attributes
Acceptor
Show child attributes
Show child attributes
AllocationDetailCollection
An itemized list of applied allocations for a given transaction activity date or funds release date.
AuthorizationSummaryCollection
A summary of authorizations (counts, amounts) for the given transaction date, grouped by acceptor, transaction currency, response code, and payment brand.
BillingDescriptor!
required
Billing descriptor information for the acceptor.
String!
required
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.
FeeCollection
An itemized list of applied fees for a given transaction activity date or funds release date.
FeeSummaryCollection
A summary of aggregated fees by acceptor and fee name/program for a specified activity date or funds release date, grouped by fee type, and where applicable, payment brand, product, and funding source.
FundingAchReturnOutputCollection
An itemized list of financially impacting ach returns occuring on the pertinent funds release dates. Use this report to track ach return-related money-movements.
FundingDisputeEventOutputCollection
An itemized list of financially impacting dispute events occuring on the pertinent funds release dates. Use this report to track dispute-related money-movements.
FundingSummaryCollection
A summary of financial activity for a given funds release date or transaction activity date. Use this report to understand financial impact of daily sales, reconcile sales activity to your bank deposits, or drill deeper into the composition of your funding.
FundingTransactionCollection
An itemized list of funded transactions (captures, sales, and refunds) for the selected transaction activity date or funds release date.
UUID!
required
The id of the acceptor as defined in their profile.
String!
required
deprecated
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.Deprecated: Use businessName instead.
PaymentTransactionCollection
A list of transaction requests (including conveyed) submitted on the pertinent transaction activity dates. Use this report as an operational tool to reconcile against your internal record of submitted transactions.
PaymentTransactionSummaryCollection
A summary of transaction aggregates (counts and amounts, including conveyed transactions) by pertinent transaction type, currency, card brand, and transaction activity date.
String!
required
The acceptor provided reference as defined in their profile.
String
The leading digits of the account.
String
The final digits of the account.
Date!
required
The date the allocation was applied.
Decimal!
required
The total allocation amount calculated as a percentage of the transaction amount (including taxes), a flat allocation, or a combination of both.
AllocationType!
required
Decimal!
required
The net billable event amount, including any add-ons or deductions.
String
The allocation’s billable event currency code in ISO 4217 alpha currency code format.
BillableType
The type of billable event, including, but not limited to: Authorization, Capture, Refund, Reversal, Authentication, Dispute, Funds transfer, Misc. adjustment, Token, Account updater, AVS verification, etc.
UUID
Reference id of item that allocation applies to (Refer to BillingEventSourceType field for referencing type).
BillingEventSourceType
ConsumerType
Specifies the type of account associated with the cardholder’s card, e.g., Consumer, Commercial, Government, etc., which has an impact on the interchange qualification. NOTE: This field will present a null, not applicable, or empty value if the allocation is not tied to a specific transaction.
String!
required
A detailed description of the allocation.
String!
required
The total allocation amount’s currency code in ISO 4217 alpha currency code format.
Date
The date that Tesouro releases the funds from its bank account to the recipient’s bank account.
String
A value created by Tesouro and sent with the funds transfer to the recipient’s bank for display on the bank statement. It includes information on who sent the money and the purpose of the payment. The recipient can use this value to help with bank and transaction reconciliation.
UUID
A unique identifier created by Tesouro and assigned to the transfer of money to a bank account, that identifies a cohort of funded transactions making up the transfer.
String
Unique ISO four digit values used to classify merchants and their transactions into specific categories based on the type of business, trade or services supplied. https://www.iso.org/standard/79450.html
String!
required
The name of the allocation.
String
A unique identifier created by the acceptor and assigned to the order placed by the customer.
Organization
PaymentBrand
The specific payment brand used, e.g., Visa, MasterCard, Discover, American Express, etc.
FundingSource
UUID
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. NOTE: This field will present a null, not applicable, or empty value if the allocation is not tied to a specific transaction.
String
The product name according to the payment brand (e.g. World Elite Mastercard card) NOTE: This field will present a null, not applicable, or empty value if the allocation is not tied to a specific transaction.
Perspective
The perspective of the allocation, which can be either ‘Acceptor’ or ‘Partner’. This field is used to determine the perspective from which the allocation is reported.
UUID
A unique, 36 character identifier created by Tesouro and assigned to the machine user or system entity that is credentialed to make API requests and present payments to Tesouro and the network.
Network
ProductPillar!
required
The Tesouro product pillar that this allocation applies to: “Boarding”, “Transaction processing”, “Funding”, “Risk, Compliance, and Dispute management”, or “Reporting”.
Show Possible enum values
Show Possible enum values
enum
Due diligence, underwriting, and onboarding.
enum
Authorization, capture, and clearing of transactions using various methods and payment credentials.
enum
Funding
enum
Insights and recommendation to optimize transaction processing.
enum
Risk, Fraud and Dispute Management
enum
Acceptor billing engine and funds disbursement.
enum
Risk mitigation, fraud prevention and detection, and dispute management.
Decimal!
required
The decimal used to multiply against the transaction amount to determine the “percentage” portion of the allocation rate.
Decimal!
required
The unit amount charged on transaction, as part of the allocation rate.
DateTime
The date and time that Tesouro received the transaction, in UTC. Formatted as 2024-03-27T02:40:00Z
UUID
A unique 36 character identifier assigned by Tesouro for every transaction request received.
String
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.
AuthorizationSummaryCollection
A summary of authorizations (counts, amounts) for the given transaction date, grouped by acceptor, transaction currency, response code, and payment brand.
Show child attributes
Show child attributes
[AuthorizationSummary!]!
required
Show child attributes
Show child attributes
Acceptor
Show child attributes
Show child attributes
AllocationDetailCollection
An itemized list of applied allocations for a given transaction activity date or funds release date.
AuthorizationSummaryCollection
A summary of authorizations (counts, amounts) for the given transaction date, grouped by acceptor, transaction currency, response code, and payment brand.
BillingDescriptor!
required
Billing descriptor information for the acceptor.
String!
required
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.
FeeCollection
An itemized list of applied fees for a given transaction activity date or funds release date.
FeeSummaryCollection
A summary of aggregated fees by acceptor and fee name/program for a specified activity date or funds release date, grouped by fee type, and where applicable, payment brand, product, and funding source.
FundingAchReturnOutputCollection
An itemized list of financially impacting ach returns occuring on the pertinent funds release dates. Use this report to track ach return-related money-movements.
FundingDisputeEventOutputCollection
An itemized list of financially impacting dispute events occuring on the pertinent funds release dates. Use this report to track dispute-related money-movements.
FundingSummaryCollection
A summary of financial activity for a given funds release date or transaction activity date. Use this report to understand financial impact of daily sales, reconcile sales activity to your bank deposits, or drill deeper into the composition of your funding.
FundingTransactionCollection
An itemized list of funded transactions (captures, sales, and refunds) for the selected transaction activity date or funds release date.
UUID!
required
The id of the acceptor as defined in their profile.
String!
required
deprecated
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.Deprecated: Use businessName instead.
PaymentTransactionCollection
A list of transaction requests (including conveyed) submitted on the pertinent transaction activity dates. Use this report as an operational tool to reconcile against your internal record of submitted transactions.
PaymentTransactionSummaryCollection
A summary of transaction aggregates (counts and amounts, including conveyed transactions) by pertinent transaction type, currency, card brand, and transaction activity date.
String!
required
The acceptor provided reference as defined in their profile.
AuthorizationApprovalStatus!
required
String!
required
The Address Verification Service (AVS) result provided by the payment brand that verifies the entered address information matches the address information on file with the issuing bank.
String!
required
The ISO 3166-1 three-letter country code associated with the issuing bank.
String!
required
The name of the issuing bank
String!
required
Unique ISO four digit values used to classify merchants and their transactions into specific categories based on the type of business, trade or services supplied.
Organization!
required
PaymentBrand!
required
Specifies which payment brand was used, e.g., Visa, Mastercard, Discover, American Express, etc.
String!
required
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 order.
String!
required
Specifies the source of the card customer’s funds , e.g., credit, debit, pre-paid.
String!
required
The product name according to the payment brand (e.g. World Elite Mastercard card), if applicable.
Network!
required
String!
required
A normalized response code defined by Tesouro that maps to the network’s authorization response code.
String!
required
A human readable description of the authorization response code. e.g., Insufficient funds.
String!
required
The response code sent from the network detailing the card security code verification results.
Date!
required
The date Tesouro recognized the payment request based upon the acceptor cutoff
Decimal!
required
The total amount approved for authorization, which may be different than the total amount requested.
Decimal!
required
The total amount requested for authorization
Int!
required
The total number of transactions
String!
required
The currency specified on the transaction, in ISO 4217 alpha currency code format.
PaymentTransactionType!
required
The type of transaction, e.g., Authorization, Capture, Refund, Reversal, Incremental authorization, Authentication.
Show Possible enum values
Show Possible enum values
enum
A request to the cardholder’s issuing bank to confirm that the account is active and has enough credit or funds to make the transaction. If approved, the requested amount is put on hold in the cardholder’s account.
enum
A request to adjust the amount of a previously approved authorization before it is captured.
enum
A request to initiate the flow of funds from the cardholder’s issuing bank account to your merchant account. Follows an approved authorization.
enum
A request to initiate the flow of funds from the customer’s bank account to your merchant account.
enum
A request to send money back to the cardholder’s account who has returned a purchase or no longer wants to receive services.
enum
A request to cancel a previous transaction request. Authorization reversals notify the cardholder’s issuer that all or part of a transaction has been canceled and that the authorization hold should be released.
enum
Performs address and card security code checks on a cardholder’s account to ensure it is in good standing, without actually charging an amount to the card.
enum
A request to the cardholder’s issuing bank to confirm that the account is active and capable of completing the refund transaction.
enum
Validates a bank account to ensure that the account belongs to the person or entity that claims to own it.
FeeCollection
An itemized list of applied fees for a given transaction activity date or funds release date.
Show child attributes
Show child attributes
[Fee!]!
required
Show child attributes
Show child attributes
Acceptor
Show child attributes
Show child attributes
AllocationDetailCollection
An itemized list of applied allocations for a given transaction activity date or funds release date.
AuthorizationSummaryCollection
A summary of authorizations (counts, amounts) for the given transaction date, grouped by acceptor, transaction currency, response code, and payment brand.
BillingDescriptor!
required
Billing descriptor information for the acceptor.
String!
required
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.
FeeCollection
An itemized list of applied fees for a given transaction activity date or funds release date.
FeeSummaryCollection
A summary of aggregated fees by acceptor and fee name/program for a specified activity date or funds release date, grouped by fee type, and where applicable, payment brand, product, and funding source.
FundingAchReturnOutputCollection
An itemized list of financially impacting ach returns occuring on the pertinent funds release dates. Use this report to track ach return-related money-movements.
FundingDisputeEventOutputCollection
An itemized list of financially impacting dispute events occuring on the pertinent funds release dates. Use this report to track dispute-related money-movements.
FundingSummaryCollection
A summary of financial activity for a given funds release date or transaction activity date. Use this report to understand financial impact of daily sales, reconcile sales activity to your bank deposits, or drill deeper into the composition of your funding.
FundingTransactionCollection
An itemized list of funded transactions (captures, sales, and refunds) for the selected transaction activity date or funds release date.
UUID!
required
The id of the acceptor as defined in their profile.
String!
required
deprecated
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.Deprecated: Use businessName instead.
PaymentTransactionCollection
A list of transaction requests (including conveyed) submitted on the pertinent transaction activity dates. Use this report as an operational tool to reconcile against your internal record of submitted transactions.
PaymentTransactionSummaryCollection
A summary of transaction aggregates (counts and amounts, including conveyed transactions) by pertinent transaction type, currency, card brand, and transaction activity date.
String!
required
The acceptor provided reference as defined in their profile.
String
The leading digits of the account.
String
The final digits of the account.
Date!
required
The date the fee was applied
Decimal!
required
The net billable event amount, including any add-ons or deductions.
String
The fee’s billable event currency code in ISO 4217 alpha currency code format.
BillableType
The type of billable event, including, but not limited to: Authorization, Capture, Refund, Reversal, Authentication, Dispute, Funds transfer, Misc. adjustment, Token, Account updater, AVS verification, etc.
UUID
Reference id of item that fee applies to (Refer to BillingEventSourceType field for referencing type).
BillingEventSourceType
ConsumerType
Specifies the type of account associated with the cardholder’s card, e.g., Consumer, Commercial, Government, etc., which has an impact on the interchange qualification. NOTE: This field will present a null, not applicable, or empty value if the fee is not tied to a specific transaction.
String!
required
A detailed description of the fee or program
Decimal!
required
The total fee amount calculated as a percentage of the transaction amount (including taxes), a flat fee, or a combination of both.
AllocationType!
required
String!
required
The total fee amount’s currency code in ISO 4217 alpha currency code format.
Date
The date that Tesouro releases the funds from its bank account to the recipient’s bank account.
String
A value created by Tesouro and sent with the funds transfer to the recipient’s bank for display on the bank statement. It includes information on who sent the money and the purpose of the payment. The recipient can use this value to help with bank and transaction reconciliation.
UUID
A unique identifier created by Tesouro and assigned to the transfer of money to a bank account, that identifies a cohort of funded transactions making up the transfer.
String
Unique ISO four digit values used to classify merchants and their transactions into specific categories based on the type of business, trade or services supplied. https://www.iso.org/standard/79450.html
String!
required
The name of the fee, interchange or wholesale program
String
A unique identifier created by the acceptor and assigned to the order placed by the customer.
Organization
PaymentBrand
The specific payment brand used, e.g., Visa, MasterCard, Discover, American Express, etc.
FundingSource
UUID
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. NOTE: This field will present a null, not applicable, or empty value if the fee is not tied to a specific transaction.
String
The product name according to the payment brand (e.g. World Elite Mastercard card) NOTE: This field will present a null, not applicable, or empty value if the fee is not tied to a specific transaction.
Perspective
The perspective of the fee, which can be either ‘Acceptor’ or ‘Partner’. This field is used to determine the perspective from which the fee is reported.
UUID
Presenter Id
Network
ProductPillar!
required
The Tesouro product pillar that this fee applies to: “Boarding”, “Transaction processing”, “Funding”, “Risk, Compliance, and Dispute management”, or “Reporting”.
Show Possible enum values
Show Possible enum values
enum
Due diligence, underwriting, and onboarding.
enum
Authorization, capture, and clearing of transactions using various methods and payment credentials.
enum
Funding
enum
Insights and recommendation to optimize transaction processing.
enum
Risk, Fraud and Dispute Management
enum
Acceptor billing engine and funds disbursement.
enum
Risk mitigation, fraud prevention and detection, and dispute management.
Decimal!
required
The decimal used to multiply against the transaction amount to determine the “percentage” portion of the fee rate.
Decimal!
required
The unit amount charged on transaction, as part of the fee rate.
DateTime
The date and time that Tesouro received the transaction, in UTC. Formatted as 2024-03-27T02:40:00Z
UUID
A unique 36 character identifier assigned by Tesouro for every transaction request received.
String
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.
FeeSummaryCollection
A summary of aggregated fees by acceptor and fee name/program for a specified activity date or funds release date, grouped by fee type, and where applicable, payment brand, product, and funding source.
Show child attributes
Show child attributes
[FeeSummary!]!
required
Show child attributes
Show child attributes
Acceptor
Show child attributes
Show child attributes
AllocationDetailCollection
An itemized list of applied allocations for a given transaction activity date or funds release date.
AuthorizationSummaryCollection
A summary of authorizations (counts, amounts) for the given transaction date, grouped by acceptor, transaction currency, response code, and payment brand.
BillingDescriptor!
required
Billing descriptor information for the acceptor.
String!
required
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.
FeeCollection
An itemized list of applied fees for a given transaction activity date or funds release date.
FeeSummaryCollection
A summary of aggregated fees by acceptor and fee name/program for a specified activity date or funds release date, grouped by fee type, and where applicable, payment brand, product, and funding source.
FundingAchReturnOutputCollection
An itemized list of financially impacting ach returns occuring on the pertinent funds release dates. Use this report to track ach return-related money-movements.
FundingDisputeEventOutputCollection
An itemized list of financially impacting dispute events occuring on the pertinent funds release dates. Use this report to track dispute-related money-movements.
FundingSummaryCollection
A summary of financial activity for a given funds release date or transaction activity date. Use this report to understand financial impact of daily sales, reconcile sales activity to your bank deposits, or drill deeper into the composition of your funding.
FundingTransactionCollection
An itemized list of funded transactions (captures, sales, and refunds) for the selected transaction activity date or funds release date.
UUID!
required
The id of the acceptor as defined in their profile.
String!
required
deprecated
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.Deprecated: Use businessName instead.
PaymentTransactionCollection
A list of transaction requests (including conveyed) submitted on the pertinent transaction activity dates. Use this report as an operational tool to reconcile against your internal record of submitted transactions.
PaymentTransactionSummaryCollection
A summary of transaction aggregates (counts and amounts, including conveyed transactions) by pertinent transaction type, currency, card brand, and transaction activity date.
String!
required
The acceptor provided reference as defined in their profile.
Decimal
The total amount of the billable type and used to calculate the Fee when a fee rate multiplier is part of the fee rate..
BillableType
Date!
required
The date the fee was applied
Decimal
The total amount of fees applied.
Int
The number of fees
String
A detailed description of the fee or program.
String
The name of the fee, interchange or wholesale program.
UUID!
required
A unique identifier created by Tesouro and assigned to each fee allocation.
Decimal
A component of the fee rate; the decimal used to multiply against the transaction amount to determine a ‘percent’ cost.
Decimal
A component of the fee rate; the unit amount charged per item.
AllocationType
String
The currency of the funded transaction, formatted in ISO 4217 alphabetic code.
Date
The date that Tesouro releases the funds from its bank account to the recipient’s bank account.
UUID!
required
A unique identifier created by Tesouro and assigned to the transfer of money to a bank account, that identifies a cohort of funded transactions making up the transfer.
String
Unique ISO four digit values used to classify merchants and their transactions into specific categories based on the type of business, trade or services supplied. NOTE: This field will present a null, not applicable, or empty value if the fee is not tied to a specific transaction.
Organization!
required
PaymentBrand
Specifies which payment brand was used, e.g., Visa, Mastercard, Discover, American Express, etc. NOTE: This field will present a null, not applicable, or empty value if the fee is not tied to a specific transaction.
FundingSource
String
The product name according to the payment brand (e.g. World Elite Mastercard card) NOTE: This field will present a null, not applicable, or empty value if the fee is not tied to a specific transaction.
Perspective
The perspective of the fee, which can be either ‘Acceptor’ or ‘Partner’. This field is used to determine the perspective from which the fee is reported.
Network
The payment network that the transaction was sent across, which may be unafilliated with the card brand. NOTE: This field will present a null, not applicable, or empty value if the fee is not tied to a specific transaction.
ProductPillar
The Tesouro product pillar that this fee applies to, e.g., Transaction processing; Billing & Funding; Risk, Fraud, & Dispute management; Reporting; Boarding;
Show Possible enum values
Show Possible enum values
enum
Due diligence, underwriting, and onboarding.
enum
Authorization, capture, and clearing of transactions using various methods and payment credentials.
enum
Funding
enum
Insights and recommendation to optimize transaction processing.
enum
Risk, Fraud and Dispute Management
enum
Acceptor billing engine and funds disbursement.
enum
Risk mitigation, fraud prevention and detection, and dispute management.
FundingAchReturnOutputCollection
An itemized list of financially impacting ACH returns occurring on the pertinent funds release dates. Use this report to track ACH return-related money-movements.
Show child attributes
Show child attributes
[FundingAchReturnOutput!]!
required
Show child attributes
Show child attributes
Acceptor!
required
Show child attributes
Show child attributes
AllocationDetailCollection
An itemized list of applied allocations for a given transaction activity date or funds release date.
AuthorizationSummaryCollection
A summary of authorizations (counts, amounts) for the given transaction date, grouped by acceptor, transaction currency, response code, and payment brand.
BillingDescriptor!
required
Billing descriptor information for the acceptor.
String!
required
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.
FeeCollection
An itemized list of applied fees for a given transaction activity date or funds release date.
FeeSummaryCollection
A summary of aggregated fees by acceptor and fee name/program for a specified activity date or funds release date, grouped by fee type, and where applicable, payment brand, product, and funding source.
FundingAchReturnOutputCollection
An itemized list of financially impacting ach returns occuring on the pertinent funds release dates. Use this report to track ach return-related money-movements.
FundingDisputeEventOutputCollection
An itemized list of financially impacting dispute events occuring on the pertinent funds release dates. Use this report to track dispute-related money-movements.
FundingSummaryCollection
A summary of financial activity for a given funds release date or transaction activity date. Use this report to understand financial impact of daily sales, reconcile sales activity to your bank deposits, or drill deeper into the composition of your funding.
FundingTransactionCollection
An itemized list of funded transactions (captures, sales, and refunds) for the selected transaction activity date or funds release date.
UUID!
required
The id of the acceptor as defined in their profile.
String!
required
deprecated
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.Deprecated: Use businessName instead.
PaymentTransactionCollection
A list of transaction requests (including conveyed) submitted on the pertinent transaction activity dates. Use this report as an operational tool to reconcile against your internal record of submitted transactions.
PaymentTransactionSummaryCollection
A summary of transaction aggregates (counts and amounts, including conveyed transactions) by pertinent transaction type, currency, card brand, and transaction activity date.
String!
required
The acceptor provided reference as defined in their profile.
String
The last few numbers of the bank account used as a visual reference to the full account numer.
String
The name of the bank account owner, as provided by the NACHA report.
AccountOwnerType
BankAccountType
Date!
required
The date Tesouro received the ach return.
Decimal!
required
The amount of the ach return.
String!
required
The currency specified on the ach return.
Decimal
The funded amount of the ACH return.
String
The currency associated with the ACH return funding amount.
Date
The date the debited or credited funds for the ACH return were released.
String
A value created by Tesouro and sent with the funds transfer to the recipient’s bank for display on the bank statement. It includes information on who sent the money and the purpose of the payment. The recipient can use this value to help with bank and transaction reconciliation.
UUID
A unique identifier created by Tesouro and assigned to the transfer of money to a bank account for this ach return, that identifies a cohort of funded transactions making up the transfer.
UUID!
required
A unique identifier created by Tesouro and assigned to the ACH return resulting in the credit or debit.
Organization!
required
UUID
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.
Perspective
The perspective of the money movement, which can be either ‘Acceptor’ or ‘Partner’. This field is used to determine the financial perspective from which the ACH return is reported.
String!
required
Description of return reason.
AchReturnCode!
required
Nacha Return Codes and associated ISO Status Reason Codes for returns and reversals from the External Code List.
String!
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).
String!
required
A unique 15 digit reference number created by the bank and used to investigate and research ACH transfers and returns.
Date
The date Tesouro recognized the original ACH payment request, based upon the acceptor cutoff. Formatted as YYYY-MM-DD
Decimal!
required
The transaction amount submitted with the original ach request.
DateTime!
required
The date and time that Tesouro received the original ach transaction, in UTC. Formatted as 2024-03-27T02:40:00Z
UUID!
required
A unique identifier assigned by Tesouro to the original ach transaction.
String
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.
String!
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.
Show Possible enum values
Show Possible enum values
enum
Card authorization.
enum
Incremental authorization.
enum
Capture previous authorization.
enum
Clearing of previous capture.
enum
Sale / charge.
enum
Refund transaction.
enum
Reversal / Void transaction.
enum
Card verification transaction.
enum
Authorization for refund.
enum
Account validation transaction.
FundingDisbursementReturnCollection
An itemized list of funding disbursement returns for a given activity date.
Show child attributes
Show child attributes
[FundingDisbursementReturn!]!
required
Show child attributes
Show child attributes
Date!
required
The activity date of the return.
Decimal!
required
The transaction amount of the return.
Date
The date the return entered the system.
UUID!
required
A unique identifier for the funding disbursement return.
Organization!
required
The organization associated with this return.
FundsTransfer
AchReturnCode!
required
String
The trace number of the return.
FundingDisputeEventOutputCollection
An itemized list of financially impacting dispute events occuring on the pertinent funds release dates. Use this report to track dispute-related money-movements.
Show child attributes
Show child attributes
[FundingDisputeEventOutput!]!
required
Show child attributes
Show child attributes
Acceptor
Show child attributes
Show child attributes
AllocationDetailCollection
An itemized list of applied allocations for a given transaction activity date or funds release date.
AuthorizationSummaryCollection
A summary of authorizations (counts, amounts) for the given transaction date, grouped by acceptor, transaction currency, response code, and payment brand.
BillingDescriptor!
required
Billing descriptor information for the acceptor.
String!
required
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.
FeeCollection
An itemized list of applied fees for a given transaction activity date or funds release date.
FeeSummaryCollection
A summary of aggregated fees by acceptor and fee name/program for a specified activity date or funds release date, grouped by fee type, and where applicable, payment brand, product, and funding source.
FundingAchReturnOutputCollection
An itemized list of financially impacting ach returns occuring on the pertinent funds release dates. Use this report to track ach return-related money-movements.
FundingDisputeEventOutputCollection
An itemized list of financially impacting dispute events occuring on the pertinent funds release dates. Use this report to track dispute-related money-movements.
FundingSummaryCollection
A summary of financial activity for a given funds release date or transaction activity date. Use this report to understand financial impact of daily sales, reconcile sales activity to your bank deposits, or drill deeper into the composition of your funding.
FundingTransactionCollection
An itemized list of funded transactions (captures, sales, and refunds) for the selected transaction activity date or funds release date.
UUID!
required
The id of the acceptor as defined in their profile.
String!
required
deprecated
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.Deprecated: Use businessName instead.
PaymentTransactionCollection
A list of transaction requests (including conveyed) submitted on the pertinent transaction activity dates. Use this report as an operational tool to reconcile against your internal record of submitted transactions.
PaymentTransactionSummaryCollection
A summary of transaction aggregates (counts and amounts, including conveyed transactions) by pertinent transaction type, currency, card brand, and transaction activity date.
String!
required
The acceptor provided reference as defined in their profile.
String!
required
The Acquirer Reference Number (ARN) is a unique 23 digit number created by Tesouro, that was assigned to the original transaction and provided to the acquiring and issuing banks for their purpose of tracing the transaction through the full process until it is funded to the bank.
String
The case number assigned to the dispute.
Date
The date the dispute lifecycle was received.
UUID!
required
A unique identifier created and used internally by Tesouro, and assigned to the dispute.
Decimal
The funded amount of the dispute, which may be different from the “dispute amount” if the original transaction’s amount was presented in a different currency than its funding currency.
String
The currency associated with the dispute funding amount
Date
The date the debited or credited funds for the dispute lifecycle were released.
String
A value created by Tesouro and sent with the funds transfer to the recipient’s bank for display on the bank statement. It includes information on who sent the money and the purpose of the payment. The recipient can use this value to help with bank and transaction reconciliation.
UUID
A unique identifier created by Tesouro and assigned to the transfer of money to a bank account for this dispute, that identifies a cohort of funded transactions making up the transfer.
UUID!
required
A unique identifier created by Tesouro and assigned to the dispute event resulting in the credit or debit.
DisputeLifeCycle!
required
Organization!
required
PaymentBrand
UUID
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.
Perspective
The perspective of the dispute, which can be either ‘Acceptor’ or ‘Partner’. This field is used to determine the perspective from which the dispute is reported.
String
The processing network that the transaction was sent across, which may be unaffiliated with the card brand.
UUID!
required
A unique identifier assigned by Tesouro for the transaction associated with this dispute event.
String
A unique transaction identifier created by the entity holding the direct relationship with the Acceptor. Tesouro uses this identifier to manage idempotency.
FundingSummaryCollection
A summary of financial activity for a given funds release date or transaction activity date. Use this report to understand financial impact of daily sales, reconcile sales activity to your bank deposits, or drill deeper into the composition of your funding.
Show child attributes
Show child attributes
[FundingSummary!]!
required
Show child attributes
Show child attributes
Acceptor
Show child attributes
Show child attributes
AllocationDetailCollection
An itemized list of applied allocations for a given transaction activity date or funds release date.
AuthorizationSummaryCollection
A summary of authorizations (counts, amounts) for the given transaction date, grouped by acceptor, transaction currency, response code, and payment brand.
BillingDescriptor!
required
Billing descriptor information for the acceptor.
String!
required
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.
FeeCollection
An itemized list of applied fees for a given transaction activity date or funds release date.
FeeSummaryCollection
A summary of aggregated fees by acceptor and fee name/program for a specified activity date or funds release date, grouped by fee type, and where applicable, payment brand, product, and funding source.
FundingAchReturnOutputCollection
An itemized list of financially impacting ach returns occuring on the pertinent funds release dates. Use this report to track ach return-related money-movements.
FundingDisputeEventOutputCollection
An itemized list of financially impacting dispute events occuring on the pertinent funds release dates. Use this report to track dispute-related money-movements.
FundingSummaryCollection
A summary of financial activity for a given funds release date or transaction activity date. Use this report to understand financial impact of daily sales, reconcile sales activity to your bank deposits, or drill deeper into the composition of your funding.
FundingTransactionCollection
An itemized list of funded transactions (captures, sales, and refunds) for the selected transaction activity date or funds release date.
UUID!
required
The id of the acceptor as defined in their profile.
String!
required
deprecated
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.Deprecated: Use businessName instead.
PaymentTransactionCollection
A list of transaction requests (including conveyed) submitted on the pertinent transaction activity dates. Use this report as an operational tool to reconcile against your internal record of submitted transactions.
PaymentTransactionSummaryCollection
A summary of transaction aggregates (counts and amounts, including conveyed transactions) by pertinent transaction type, currency, card brand, and transaction activity date.
String!
required
The acceptor provided reference as defined in their profile.
Decimal!
required
Total monetary amount of ACH returns from the acceptor.
Decimal!
required
Net amount of financially impacting disputes debited from and or credited to the acceptor.
Decimal!
required
The total amount of fees paid by the acceptor.
Int!
required
Total number of fees paid by the acceptor.
Decimal!
required
The net amount funded to (or debited from) the acceptor.
Decimal!
required
Total amount of interchange fees charged to acceptor.
Int!
required
Total number of network fees charged to acceptor.
Decimal!
required
Total amount of network fees charged to acceptor.
Int!
required
Total number of interchange fees charged to acceptor.
Decimal!
required
deprecated
The total amount of net sales (refunds + captures) processed.Deprecated: Use acceptorNetSettledSalesAmount instead
Decimal!
required
The net amount of the acceptor’s sales and refunds.
Decimal!
required
Total monetary amount of ACH returns
Int!
required
Total number of ACH returns
Decimal!
required
Total amount of convenience fees charged to the customer.
Int!
required
Total number of convenience fees charged to the customer.
Decimal
deprecated
The total amount of disputes represented and credited to the acceptor.Deprecated: Use disputesCreditAmount instead
Int
deprecated
The total number of representmentsDeprecated: Use disputesCreditCount instead
Int!
required
The total number of dispute debits and credits applied on your account. Calculated as [Dispute credits count - Dispute debits count]
Decimal!
required
The amount of financially impacting dispute events (e.g., representments) credited to your account.
Int!
required
The number of financially impacting dispute events (e.g., representments) credited to your account.
Decimal!
required
The amount of financially impacting dispute events (e.g., 1st chargebacks) debited from your account.
Int!
required
The number of financially impacting dispute events (e.g., 1st chargebacks) debited from your account.
Decimal!
required
deprecated
The total amount of financially impacting disputes.Deprecated: Use disputesNetAmount instead
Decimal!
required
The net amount of financially impacting dispute events funded to our from your account. Calculated as [Dispute credits - Dispute debits].
Decimal!
required
deprecated
The total amount of fees. Calculated as [Interchange + Network fees + Processor fees + Transactor fees].Deprecated: Use feesAmount instead.
Decimal!
required
The total amount of fees.
Int!
required
Total number of fees.
Int!
required
deprecated
The total number of dispute debits and credits applied on your account. Calculated as [Dispute credits count - Dispute debits count]Deprecated: Use disputesCount instead.
String!
required
The currency of the funded transaction, formatted in ISO 4217 alphabetic code.
Decimal!
required
The amount transferred from Tesouro to the recipient’s bank.
Date!
required
The date that Tesouro releases the funds from its bank account to the recipient’s bank account.
FundsTransfer
String
A value created by Tesouro and sent with the funds transfer to the recipient’s bank for display on the bank statement. It includes information on who sent the money and the purpose of the payment. The recipient can use this value to help with bank and transaction reconciliation.
UUID!
required
A unique identifier created by Tesouro and assigned to the transfer of money to a bank account, that identifies a cohort of funded transactions making up the transfer.
UUID
A reusable identifier created and used internally by Tesouro, and assigned to the configuration of funding profiles specifying who and/or where the funds transfer is sent.
String
A reusable, descriptive name specified by the transactor, labeling who and/or where the funds transfer is going. E.g., the name of a specific acceptor, a group of acceptors, a bank account, etc.
Decimal!
required
Total amount of interchange fees.
Int!
required
Total number of interchange fees.
Decimal
The net amount of miscellaneous adjustments. Calculated as [Miscellaneous credits - Miscellaneous debits].
Decimal
The total amount of miscellaneous credits
Int
The total number of miscellaneous credits
Decimal
The total amount of miscellaneous debits
Int
The total number of miscellaneous debits
Decimal!
required
Total amount of network fees.
Int!
required
Total number of network fees.
Organization!
required
Decimal!
required
The total amount of partner fees passed onto the acceptor.
Int!
required
Total number of partner fees charged to the acceptor.
PaymentBrand
Specifies which payment brand was used, e.g., Visa, Mastercard, Discover, American Express, etc. NOTE: This field will present a null, not applicable, or empty value if the fee is not tied to a specific transaction.
PaymentChannel
Perspective
The perspective of the funds transfer, which can be either ‘Acceptor’ or ‘Partner’. This field is used to determine the perspective from which the funds transfer is reported.
Network
The processing network that the transaction was sent across, which may be unaffiliated with the card brand. NOTE: This field will present a null, not applicable, or empty value if the fee is not tied to a specific transaction.
Decimal!
required
Total amount of processor fees charged by Tesouro.
Int!
required
Total number of processor fees.
Int!
required
The total number of refunded transactions.
Decimal!
required
The gross refunds amount before deducting any associated transaction-level fees.
Decimal!
required
The net reserve amount, if applicable.
Int!
required
The total number of captured sale transactions
Decimal!
required
The gross sales amount before deducting any associated transaction-level fees.
Decimal!
required
The net transaction amount, calculated as [Gross sales amount - Gross refunds amount]
Decimal!
required
Total amount of service fees charged to the customer.
Int!
required
Total number of service fees charged to the customer.
Decimal!
required
Total amount of surcharges charged to the customer.
Int!
required
Total number of surcharges charged to the customer.
Decimal!
required
The total amount transferred to third parties.
Date!
required
The date Tesouro recognized the payment request based upon the acceptor cutoff
Decimal!
required
deprecated
The total amount of transactor fees passed onto the acceptor.Deprecated: Use partnerFeesAmount instead.
FundingTransactionCollection
An itemized list of funded transactions (captures, sales, and refunds) for the selected transaction activity date or funds release date.
Show child attributes
Show child attributes
[FundingTransaction!]!
required
Show child attributes
Show child attributes
Acceptor!
required
Show child attributes
Show child attributes
AllocationDetailCollection
An itemized list of applied allocations for a given transaction activity date or funds release date.
AuthorizationSummaryCollection
A summary of authorizations (counts, amounts) for the given transaction date, grouped by acceptor, transaction currency, response code, and payment brand.
BillingDescriptor!
required
Billing descriptor information for the acceptor.
String!
required
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.
FeeCollection
An itemized list of applied fees for a given transaction activity date or funds release date.
FeeSummaryCollection
A summary of aggregated fees by acceptor and fee name/program for a specified activity date or funds release date, grouped by fee type, and where applicable, payment brand, product, and funding source.
FundingAchReturnOutputCollection
An itemized list of financially impacting ach returns occuring on the pertinent funds release dates. Use this report to track ach return-related money-movements.
FundingDisputeEventOutputCollection
An itemized list of financially impacting dispute events occuring on the pertinent funds release dates. Use this report to track dispute-related money-movements.
FundingSummaryCollection
A summary of financial activity for a given funds release date or transaction activity date. Use this report to understand financial impact of daily sales, reconcile sales activity to your bank deposits, or drill deeper into the composition of your funding.
FundingTransactionCollection
An itemized list of funded transactions (captures, sales, and refunds) for the selected transaction activity date or funds release date.
UUID!
required
The id of the acceptor as defined in their profile.
String!
required
deprecated
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.Deprecated: Use businessName instead.
PaymentTransactionCollection
A list of transaction requests (including conveyed) submitted on the pertinent transaction activity dates. Use this report as an operational tool to reconcile against your internal record of submitted transactions.
PaymentTransactionSummaryCollection
A summary of transaction aggregates (counts and amounts, including conveyed transactions) by pertinent transaction type, currency, card brand, and transaction activity date.
String!
required
The acceptor provided reference as defined in their profile.
Decimal!
required
The amount of acceptor interchange associated with this transaction
Decimal!
required
The itemized acceptor network fees associated with this transaction
Decimal!
required
The amount of convenience fees associated with this transaction
String!
required
The currency of the funded transaction, formatted in ISO 4217 alphabetic code.
Decimal!
required
The total amount of the transaction, in the funding currency.
Decimal!
required
The net funded amount after fees, in the funding currency.
Date
The date that Tesouro releases the funds from its bank account to the recipient’s bank account.
FundsTransfer
String
A value created by Tesouro and sent with the funds transfer to the recipient’s bank for display on the bank statement. It includes information on who sent the money and the purpose of the payment. The recipient can use this value to help with bank and transaction reconciliation.
UUID
A unique identifier created by Tesouro and assigned to the transfer of money to a bank account, that identifies a cohort of funded transactions making up the transfer.
Decimal!
required
The amount of interchange associated with this transaction
Boolean!
required
Indicates if the partner fee was adjusted at the transaction level.
Decimal!
required
The itemized network fees associated with this transaction
Organization!
required
Decimal!
required
The amount of partner fees associated with this transaction
PaymentTransaction!
required
Show child attributes
Show child attributes
Acceptor!
required
Date
The date Tesouro recognized the payment request based upon the acceptor cutoff.
AmountDetails
Components of the requested amount that may or may not have been provided by the presenter on the payment transaction request.
String
The billing descriptor name that appears on the customer’s statement.
BusinessApplicationId
The business application identifier (BAI) is a value provided by Visa to identify the type of transfer that is being performed.
Show Possible enum values
Show Possible enum values
enum
Consumer Bill Pay
FeeDetails
Aggregate information for assessed fees
UUID!
required
A unique identifier assigned by Tesouro for every transaction request received.
[LineItem!]
Line items associated with the payment transaction.
Location
The location where this transaction took place.
String
Unique ISO four digit values used to classify merchants and their transactions into specific categories based on the type of business, trade or services supplied.
Organization!
required
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.
PaymentMethod!
required
Refers to the various options available for customers to make payments when purchasing a product or service.
Network!
required
ProcessorResponseCode!
required
A response code provided by Tesouro identifying the specific approval or decline reason.
…and 90 more values. See ProcessorResponseCode for the full list.
Show Possible enum values
Show Possible enum values
enum
Full amount approved.
enum
Partially approved. The transaction was approved for an amount less than the original request because the cardholder’s account balance was insufficient to cover the full amount.
enum
Purchase amount approved, not cash.
enum
Point-to-Point Encryption (P2PE) success.
enum
Account Validated.
String!
required
A human readable description of the authorization response code. e.g., Insufficient funds.
String
A unique transaction identifier created by the entity holding the direct relationship with the Acceptor. Tesouro uses this identifier to manage idempotency.
ResponseType
String!
required
Short description of the payment transaction result. Examples include Approved, Insufficient funds. Intended for display purposes only.
Taxes
The various tax amounts collected on the payment transaction.
String
The last 4 digits of the tax identification number (TIN), which is a unique identifier created by the national government and associated with the acceptor at the time the transaction was submitted.
DateTime!
required
The date and time that Tesouro received the transaction, in UTC. Formatted as 2024-03-27T02:40:00Z
PaymentTransactionType!
required
The type of payment transaction, e.g., Authorization, Capture, Sale, Refund, Reversal, etc.
Show Possible enum values
Show Possible enum values
enum
A request to the cardholder’s issuing bank to confirm that the account is active and has enough credit or funds to make the transaction. If approved, the requested amount is put on hold in the cardholder’s account.
enum
A request to adjust the amount of a previously approved authorization before it is captured.
enum
A request to initiate the flow of funds from the cardholder’s issuing bank account to your merchant account. Follows an approved authorization.
enum
A request to initiate the flow of funds from the customer’s bank account to your merchant account.
enum
A request to send money back to the cardholder’s account who has returned a purchase or no longer wants to receive services.
enum
A request to cancel a previous transaction request. Authorization reversals notify the cardholder’s issuer that all or part of a transaction has been canceled and that the authorization hold should be released.
enum
Performs address and card security code checks on a cardholder’s account to ensure it is in good standing, without actually charging an amount to the card.
enum
A request to the cardholder’s issuing bank to confirm that the account is active and capable of completing the refund transaction.
enum
Validates a bank account to ensure that the account belongs to the person or entity that claims to own it.
Perspective
The perspective of the transaction, which can be either ‘Acceptor’ or ‘Partner’. This field is used to determine the perspective from which the transaction is reported.
Decimal!
required
The itemized processor fees associated with this transaction
Decimal!
required
The amount of service fees associated with this transaction
Decimal!
required
The amount of surcharge associated with this transaction
Decimal!
required
deprecated
The amount of partner fees associated with this transactionDeprecated: Use partnerFeesAmount instead.
[ReportAvailability!]
Show child attributes
Show child attributes
Date
The latest available date for querying reports with the selected date type. This date will vary based on data processing timelines.
Date
The first available date for querying reports with the selected date type. This date will vary based on data processing timelines.
PaymentTransactionCollection
A list of payment transaction requests (including conveyed) submitted on the pertinent transaction activity dates. Use this report as an operational tool to reconcile against your internal record of submitted transactions.
Show child attributes
Show child attributes
[PaymentTransaction!]!
required
Show child attributes
Show child attributes
Acceptor!
required
Show child attributes
Show child attributes
AllocationDetailCollection
An itemized list of applied allocations for a given transaction activity date or funds release date.
AuthorizationSummaryCollection
A summary of authorizations (counts, amounts) for the given transaction date, grouped by acceptor, transaction currency, response code, and payment brand.
BillingDescriptor!
required
Billing descriptor information for the acceptor.
String!
required
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.
FeeCollection
An itemized list of applied fees for a given transaction activity date or funds release date.
FeeSummaryCollection
A summary of aggregated fees by acceptor and fee name/program for a specified activity date or funds release date, grouped by fee type, and where applicable, payment brand, product, and funding source.
FundingAchReturnOutputCollection
An itemized list of financially impacting ach returns occuring on the pertinent funds release dates. Use this report to track ach return-related money-movements.
FundingDisputeEventOutputCollection
An itemized list of financially impacting dispute events occuring on the pertinent funds release dates. Use this report to track dispute-related money-movements.
FundingSummaryCollection
A summary of financial activity for a given funds release date or transaction activity date. Use this report to understand financial impact of daily sales, reconcile sales activity to your bank deposits, or drill deeper into the composition of your funding.
FundingTransactionCollection
An itemized list of funded transactions (captures, sales, and refunds) for the selected transaction activity date or funds release date.
UUID!
required
The id of the acceptor as defined in their profile.
String!
required
deprecated
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.Deprecated: Use businessName instead.
PaymentTransactionCollection
A list of transaction requests (including conveyed) submitted on the pertinent transaction activity dates. Use this report as an operational tool to reconcile against your internal record of submitted transactions.
PaymentTransactionSummaryCollection
A summary of transaction aggregates (counts and amounts, including conveyed transactions) by pertinent transaction type, currency, card brand, and transaction activity date.
String!
required
The acceptor provided reference as defined in their profile.
Date
The date Tesouro recognized the payment request based upon the acceptor cutoff.
AmountDetails
Components of the requested amount that may or may not have been provided by the presenter on the payment transaction request.
Show child attributes
Show child attributes
Decimal
The amount of cashback requested by the presenter.
Decimal
The total amount of convenience fees collected.
Decimal
Total discount amount applied to the order.
Decimal
Total charges for any import or export duties included in the order.
Decimal
The amount of gratuity requested by the presenter.
Decimal
The total amount of service fees collected.
Decimal
Total shipping charges for the transaction.
Decimal
The sum of all item costs in the transaction before applying any additional charges such as taxes, or fees.
Decimal
The total amount of surcharge collected.
String
The billing descriptor name that appears on the customer’s statement.
BusinessApplicationId
The business application identifier (BAI) is a value provided by Visa to identify the type of transfer that is being performed.
Show Possible enum values
Show Possible enum values
enum
Consumer Bill Pay
FeeDetails
UUID!
required
A unique identifier assigned by Tesouro for every transaction request received.
[LineItem!]
Line items associated with the payment transaction.
Show child attributes
Show child attributes
String
A specific code used to classify and categorize the type of goods and services being purchased.
String
Description of the goods or services.
Decimal
Details regarding any discounts applied to the line item.
Decimal
The total amount of the item. Calculated as [Unit price * Unit quantity]
String
The supplier’s unique product identifier, inventory number, or UPC code used to identity a specific product.
String
A SKU, or Stock Keeping Unit, is a unique alphanumeric code assigned by a retailer to identify and track each distinct product or product variation within their inventory.
LineItemTaxes
Tax details applicable to the individual line item. If the item is not taxable, these fields should be set to null.
String
The metric used for understanding the quantity of a given line item. e.g., for quantities, use “each” or “piece” for length, use “meter” or “inch” for volume, use “liter” or “gallon” and for weight, use “gram” or “pound”, etc.
Decimal
The “per unit” price of the line item.
Decimal
The number of units included in the line item.
Location
String
Unique ISO four digit values used to classify merchants and their transactions into specific categories based on the type of business, trade or services supplied.
Organization!
required
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.
PaymentMethod!
required
Refers to the various options available for customers to make payments when purchasing a product or service.
Show child attributes
Show child attributes
String
The acquirer token on file for this payment card, if the card has been used before and the transactor is subscribed to Tesouro’s tokenization services. Otherwise, this field’s value will be null.
PaymentBrand
Network!
required
ProcessorResponseCode!
required
A response code provided by Tesouro identifying the specific approval or decline reason.
…and 90 more values. See ProcessorResponseCode for the full list.
Show Possible enum values
Show Possible enum values
enum
Full amount approved.
enum
Partially approved. The transaction was approved for an amount less than the original request because the cardholder’s account balance was insufficient to cover the full amount.
enum
Purchase amount approved, not cash.
enum
Point-to-Point Encryption (P2PE) success.
enum
Account Validated.
String!
required
A human readable description of the authorization response code. e.g., Insufficient funds.
String
A unique transaction identifier created by the entity holding the direct relationship with the Acceptor. Tesouro uses this identifier to manage idempotency.
ResponseType
String!
required
Short description of the payment transaction result. Examples include Approved, Insufficient funds. Intended for display purposes only.
Taxes
String
The last 4 digits of the tax identification number (TIN), which is a unique identifier created by the national government and associated with the acceptor at the time the transaction was submitted.
DateTime!
required
The date and time that Tesouro received the transaction, in UTC. Formatted as 2024-03-27T02:40:00Z
PaymentTransactionType!
required
The type of payment transaction, e.g., Authorization, Capture, Sale, Refund, Reversal, etc.
Show Possible enum values
Show Possible enum values
enum
A request to the cardholder’s issuing bank to confirm that the account is active and has enough credit or funds to make the transaction. If approved, the requested amount is put on hold in the cardholder’s account.
enum
A request to adjust the amount of a previously approved authorization before it is captured.
enum
A request to initiate the flow of funds from the cardholder’s issuing bank account to your merchant account. Follows an approved authorization.
enum
A request to initiate the flow of funds from the customer’s bank account to your merchant account.
enum
A request to send money back to the cardholder’s account who has returned a purchase or no longer wants to receive services.
enum
A request to cancel a previous transaction request. Authorization reversals notify the cardholder’s issuer that all or part of a transaction has been canceled and that the authorization hold should be released.
enum
Performs address and card security code checks on a cardholder’s account to ensure it is in good standing, without actually charging an amount to the card.
enum
A request to the cardholder’s issuing bank to confirm that the account is active and capable of completing the refund transaction.
enum
Validates a bank account to ensure that the account belongs to the person or entity that claims to own it.
PaymentTransactionSummaryCollection
A summary of transaction aggregates (counts and amounts, including conveyed transactions) by pertinent transaction type, currency, card brand, and transaction activity date.
Show child attributes
Show child attributes
[PaymentTransactionSummary!]!
required
Show child attributes
Show child attributes
Acceptor!
required
Show child attributes
Show child attributes
AllocationDetailCollection
An itemized list of applied allocations for a given transaction activity date or funds release date.
AuthorizationSummaryCollection
A summary of authorizations (counts, amounts) for the given transaction date, grouped by acceptor, transaction currency, response code, and payment brand.
BillingDescriptor!
required
Billing descriptor information for the acceptor.
String!
required
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.
FeeCollection
An itemized list of applied fees for a given transaction activity date or funds release date.
FeeSummaryCollection
A summary of aggregated fees by acceptor and fee name/program for a specified activity date or funds release date, grouped by fee type, and where applicable, payment brand, product, and funding source.
FundingAchReturnOutputCollection
An itemized list of financially impacting ach returns occuring on the pertinent funds release dates. Use this report to track ach return-related money-movements.
FundingDisputeEventOutputCollection
An itemized list of financially impacting dispute events occuring on the pertinent funds release dates. Use this report to track dispute-related money-movements.
FundingSummaryCollection
A summary of financial activity for a given funds release date or transaction activity date. Use this report to understand financial impact of daily sales, reconcile sales activity to your bank deposits, or drill deeper into the composition of your funding.
FundingTransactionCollection
An itemized list of funded transactions (captures, sales, and refunds) for the selected transaction activity date or funds release date.
UUID!
required
The id of the acceptor as defined in their profile.
String!
required
deprecated
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.Deprecated: Use businessName instead.
PaymentTransactionCollection
A list of transaction requests (including conveyed) submitted on the pertinent transaction activity dates. Use this report as an operational tool to reconcile against your internal record of submitted transactions.
PaymentTransactionSummaryCollection
A summary of transaction aggregates (counts and amounts, including conveyed transactions) by pertinent transaction type, currency, card brand, and transaction activity date.
String!
required
The acceptor provided reference as defined in their profile.
ConveyedStatus!
required
Indicator that the transaction was conveyed, or handled by the Tesouro network
Show Possible enum values
Show Possible enum values
enum
The transaction does not move money, and therefore a conveyed status is not applicable.
enum
The transaction is acquired by and funded through the Tesouro platform.
enum
The transaction is conveyed and will be funded through the applicable payment network, e.g. American Express, Discover, Diners Club, etc.
Organization!
required
PaymentBrand
Specifies which payment brand was used, e.g., Visa, Mastercard, Discover, American Express, etc.
PaymentChannel
FundingSource!
required
UUID!
required
A unique identifier created and used by Tesouro, and assigned to the entity presenting the transaction to Tesouro.
Network
Date!
required
The date Tesouro recognized the payment request based upon the acceptor cutoff
Decimal!
required
The total value of the transactions
Int!
required
The total number of transactions
String!
required
The currency specified on the transaction, in ISO 4217 alpha currency code format.
TransactionRequestResult!
required
PaymentTransactionType!
required
The type of transaction, e.g., Authorization, Capture, Refund, Reversal, Incremental authorization, Authentication.
Show Possible enum values
Show Possible enum values
enum
A request to the cardholder’s issuing bank to confirm that the account is active and has enough credit or funds to make the transaction. If approved, the requested amount is put on hold in the cardholder’s account.
enum
A request to adjust the amount of a previously approved authorization before it is captured.
enum
A request to initiate the flow of funds from the cardholder’s issuing bank account to your merchant account. Follows an approved authorization.
enum
A request to initiate the flow of funds from the customer’s bank account to your merchant account.
enum
A request to send money back to the cardholder’s account who has returned a purchase or no longer wants to receive services.
enum
A request to cancel a previous transaction request. Authorization reversals notify the cardholder’s issuer that all or part of a transaction has been canceled and that the authorization hold should be released.
enum
Performs address and card security code checks on a cardholder’s account to ensure it is in good standing, without actually charging an amount to the card.
enum
A request to the cardholder’s issuing bank to confirm that the account is active and capable of completing the refund transaction.
enum
Validates a bank account to ensure that the account belongs to the person or entity that claims to own it.
AcceptorCollection
Show child attributes
Show child attributes
[Acceptor!]!
required
Show child attributes
Show child attributes
AllocationDetailCollection
An itemized list of applied allocations for a given transaction activity date or funds release date.See AllocationDetailCollection
AuthorizationSummaryCollection
A summary of authorizations (counts, amounts) for the given transaction date, grouped by acceptor, transaction currency, response code, and payment brand.See AuthorizationSummaryCollection
BillingDescriptor!
required
Billing descriptor information for the acceptor.
Show child attributes
Show child attributes
String!
required
The acceptor’s city that will appear on a credit card statement. Maximum 13 characters.
String!
required
The descriptive name for the acceptor that will appear on a credit card statement. Maximum 22 characters.
String!
required
The descriptive name for the acceptor’s service fee that may appear on a credit card statement. Maximum 22 characters.
String!
required
The 2-letter abbreviation of the acceptor’s state that will appear on a credit card statement.
String!
required
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.
FeeCollection
An itemized list of applied fees for a given transaction activity date or funds release date.See FeeCollection
FeeSummaryCollection
A summary of aggregated fees by acceptor and fee name/program for a specified activity date or funds release date, grouped by fee type, and where applicable, payment brand, product, and funding source.See FeeSummaryCollection
FundingAchReturnOutputCollection
An itemized list of financially impacting ach returns occuring on the pertinent funds release dates. Use this report to track ach return-related money-movements.See FundingAchReturnOutputCollection
FundingDisputeEventOutputCollection
An itemized list of financially impacting dispute events occuring on the pertinent funds release dates. Use this report to track dispute-related money-movements.See FundingDisputeEventOutputCollection
FundingSummaryCollection
A summary of financial activity for a given funds release date or transaction activity date. Use this report to understand financial impact of daily sales, reconcile sales activity to your bank deposits, or drill deeper into the composition of your funding.See FundingSummaryCollection
FundingTransactionCollection
An itemized list of funded transactions (captures, sales, and refunds) for the selected transaction activity date or funds release date.See FundingTransactionCollection
UUID!
required
The id of the acceptor as defined in their profile.
String!
required
deprecated
The descriptive name for the acceptor that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.Deprecated: Use businessName instead.
PaymentTransactionCollection
A list of transaction requests (including conveyed) submitted on the pertinent transaction activity dates. Use this report as an operational tool to reconcile against your internal record of submitted transactions.See PaymentTransactionCollection
PaymentTransactionSummaryCollection
A summary of transaction aggregates (counts and amounts, including conveyed transactions) by pertinent transaction type, currency, card brand, and transaction activity date.See PaymentTransactionSummaryCollection
String!
required
The acceptor provided reference as defined in their profile.
String!
required
The descriptive name for the organization that is different from its legal entity name. Also known
as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.
String!
required
The legal entity name for the organization.
String!
required
deprecated
The descriptive name for the organization that is different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”.Deprecated: Use businessName instead.
[MerchantCategory!]!
required
The allowed Merchant Category Codes for acceptors within this organization.
Show child attributes
Show child attributes
String!
required
Unique ISO four digit value used to classify merchants and their transactions into specific categories based on the type of business, trade or services supplied.
[OrganizationCapability!]!
required
OrganizationSettingsOutput!
required
Organization settings.
Show child attributes
Show child attributes
OrganizationAccessSettings!
required
deprecated
Access settings for the organization.Deprecated: Use the organization-level capabilities field instead.
Show child attributes
Show child attributes
Boolean!
required
deprecated
Indicates whether acceptor boarding is enabled for the organization.Deprecated: Use the organization-level capabilities field instead. Check for ACQUIRING in capabilities.
Boolean!
required
deprecated
Indicates whether underwriting applications are enabled for the organization.Deprecated: Use the organization-level capabilities field instead. Check for UNDERWRITING in capabilities.
AddressOutput
The business address of the organization.
Show child attributes
Show child attributes
Max100Text
The first line of the address.
Max100Text
The second line of the address, if applicable.
Max100Text
The third line of the address, if applicable.
Max100Text
City, town, or village.
CountryCode
The ISO 3166-1 three-letter country code associated with the address.See CountryCode
Max15Text
A set of specific numbers, and sometimes letters, that help postal services deliver mail.
String
State or province. US states must be in their 2 character format defined here https://about.usps.com/who/profile/history/state-abbreviations.htm. Canadian provinces must be their 2 character format defined here https://www.canada.ca/en/revenue-agency/services/tax/businesses/topics/completing-slips-summaries/financial-slips-summaries/return-investment-income-t5/provincial-territorial-codes.html
String
The phone number of the organization.
[AcceptorApplicationCounts!]!
required
The counts of acceptor applications for this organization, grouped by application status.
Show child attributes
Show child attributes
AcceptorApplicationStatus!
required
The status of the acceptor applications in this group.
Show Possible enum values
Show Possible enum values
enum
The application has been approved, either automatically or manually. A processing account may now be created.
enum
The application has been created but not yet submitted.
enum
The application has been rejected due to verification failures, compliance issues, or other disqualifying factors.
enum
The application is awaiting manual review or requires additional information to complete the underwriting process.
enum
The application is currently being evaluated by the system.
enum
The application submission failed due to a system error. Error messaging has been returned.
enum
The application submission failed due to missing or invalid data. Errors must be corrected before resubmission.
enum
The application has been withdrawn by the applicant, transactor, or Tesouro. No further review or decision will occur.
Int!
required
The total number of acceptor applications with this status.