AcceptorApplication

OBJECT An acceptor application representing a merchant onboarding request, including identity, billing, services, and underwriting details.

Fields

[StakeholderOutput!]!

required

Stakeholder information. Optionally reveal sensitive fields for a specific stakeholder.

Show child attributes

String

The email address of the stakeholder.

UUID

A unique UUID created by Tesouro and assigned to the stakeholder.

String

The IP address of the stakeholder at the time of application submission.

Percentage

The approximate ownership of the acceptor that this owner holds. Formatted as a decimal, e.g., If the owners holds 30%, input as 0.30

Int

The stakeholder’s reference number: assigned when the stakeholder is added, unique within the application per stakeholder kind, never changed, and never reused. Null for stakeholders added before reference numbers existed.

[StakeholderRole!]

The roles this stakeholder holds in relation to the business, such as Owner or ControlPerson.See StakeholderRole

StakeholderSensitiveFields

Sensitive fields that require special permissions to access.See StakeholderSensitiveFields

ApplicationEventCollection

The events associated with the application.

Show child attributes

[ApplicationEvent!]!

required

See ApplicationEvent

PageInfo!

required

See PageInfo

[Attachment!]!

required

The attachments associated with the application.

Show child attributes

String!

required

The name of the uploaded file.

UUID!

required

The unique identifier of the attachment.

Int

The size of the attachment in bytes.

Actor

See Actor

DateTime!

required

The date and time in UTC that this file was stored in the system.

[Comment!]!

required

The comments associated with the application.

Show child attributes

String

The text content of the comment.

Actor

See Actor

DateTime!

required

The date and time in UTC that this comment was created.

DecisionComponent

See DecisionComponent

UUID!

required

The unique identifier of the comment.

Actor

The actor (user or app) who last updated this recordSee Actor

DateTime!

required

The last date and time this was updated in UTC.

Actor

The actor who created the application.

Show child attributes

String!

required

ActorType!

required

See ActorType

[DecisionComponent!]!

required

The underwriting decision components for the application.

Show child attributes

[Attachment!]!

required

See Attachment

[Comment!]!

required

See Comment

Boolean!

required

Boolean!

required

UUID!

required

The unique identifier of the decision component.

[DecisionComponentItem!]!

required

See DecisionComponentItem

Actor

The actor (user or app) who last updated this recordSee Actor

UnderwritingDecisionComponentSchema

See UnderwritingDecisionComponentSchema

DecisionComponentStatus

The current processing status of this decision component in the underwriting workflow.See DecisionComponentStatus

DateTime!

required

The last date and time this was updated in UTC.

UnderwritingDecisionComponentsSchema

The underwriting decision components schema for the application.

Show child attributes

DateTime!

required

The date and time this was created in UTC.

UUID!

required

The unique identifier of the decision components schema.

[UnderwritingDecisionComponentSchema!]!

required

The individual component schemas that make up this decision components schema.See UnderwritingDecisionComponentSchema

String!

required

The version identifier of this decision components schema.

Actor

The actor who updated the application.

Show child attributes

String!

required

ActorType!

required

See ActorType

UUID

The acceptor ID assigned during onboarding.

AccountStatus

Current boarding process status. Null if boarding has not started.

Show Possible enum values

enum

The onboarding process is temporarily paused, possibly due to missing information, compliance issues, or other reasons.

enum

The account has been successfully set up, and the customer is now fully onboarded and can start processing payments.

enum

The configuration of the acceptor account settings, including payment gateway parameters, merchant details, and transaction processing settings, is actively underway but has not yet been completed.

AcceptorApplicationIdentityOutput

The identity information of the application.

Show child attributes

String

The unique identifier used to identify the acceptor application.

String

An optional field that the Transactor would pass to potentially identify multiple Acceptors that roll up to a broader relationship.

AcceptorType

The type of the acceptor (e.g., MERCHANT, SPONSORED_MERCHANT, etc.).See AcceptorType

AddressOutput

The address from where the applicant operates it business. This may or may not be different from the legal address.See AddressOutput

BusinessEntityType

The type of business, e.g., CORPORATION, LLC, SOLE_PROPRIETOR, etc.See BusinessEntityType

String

The descriptive name for the applicant that may be different from its legal entity name. Also known as “Doing Business As” (DBA), “trade name”, “assumed name”, or “fictitious name”. This name will appear on the cardholder’s statement.

String

The default merchant category code for the acceptor.

Boolean!

required

Indicates the acceptor is a known trusted acceptor.

Boolean

Indicates whether the legal address is the same as the business address.

Boolean!

required

An indicator informing Tesouro when processing statements require review by the underwriter. True = requires review; False = does not require review.

AddressOutput

The registered legal address of the business entity.See AddressOutput

String

The legal company name.

[MerchantCategoryOutput!]

A description of the merchant category used to classify businesses based on the goods or services they provide.See MerchantCategoryOutput

SalesChannel

The channel through which the applicant primarily accepts payments (e.g., RETAIL, MOTO, E_COMMERCE).See SalesChannel

AcceptorApplicationSensitiveFields

Sensitive fields that require special permissions to access.See AcceptorApplicationSensitiveFields

String

The customer service telephone number for the business.

[String!]

The names of the software providers used by the applicant.

The bank or financial institution holding the relationship with Tesouro to facilitate the movement of money and provide compliance oversight. Also known as the acquiring bank.See SelectedSponsorBankOutput

String

The U.S. state or jurisdiction in which the legal entity was incorporated or formed (2-character code).

TaxIdentificationNumberOutput

The tax identification number of the legal entity.See TaxIdentificationNumberOutput

String

The name of the referral partner, if present.

[String!]

This identifies any Gateways, POS software, or Fulfillment partners.

TransactorTypeI

This overrides the transactor’s type when supplied.See TransactorTypeI

String

The applicant’s website. If the applicant sells its products or services using ecommerce, then the website URL is required.

AcceptorApplicationStatus!

required

The status of the application.

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.

AcceptorApplicationBillingAndFundingOutput

The billing and funding information of the application.

Show child attributes

LocalTime

The acceptor’s end-of-day time in the provided timezone.

[BankAccountOutput!]

Bank account information. Optionally reveal sensitive fields for a specific bank account.See BankAccountOutput

BillingDescriptorOutput

The billing descriptor information for the acceptor.See BillingDescriptorOutput

UUID

Id of the Billing Profile.

UUID

Id of the Funding Profile.

IanaTimezone

The time zone of the acceptor, standardized by the Internet Assigned Numbers Authority (IANA). IANA time zones follow this convention: /, where an area corresponds to a continent or an ocean and the location to a location within the continent.See IanaTimezone

String

The card acceptor ID assigned during onboarding.

AcceptorApplicationProcessingActivityOutput

The process activity information of the application.

Show child attributes

Decimal

The average annual sales amount, in the specified currency.

Decimal

The average gross sales amount, in the specified currency.

Decimal

The average amount of a transaction, in the specified currency.

Percentage

The approximate mix of business-to-business (B2B) transactions. Formatted as a decimal, e.g., If B2B transactions make up 30% of total volume, input as 0.3.

Percentage

The approximate mix of card-not-present (CNP) transactions. Formatted as a decimal., e.g., If CNP transactions make up 80% of total volume, input as 0.8. When no value has been captured, this falls back to the sum of customerInitiatedCardNotPresentMix and merchantInitiatedCardNotPresentMix.

Percentage

The approximate mix of card present (CP) transactions. Formatted as a decimal., e.g., If CP transactions make up 20% of total volume, input as 0.2.

Percentage

The approximate rate of chargebacks. Formatted as a decimal, e.g., If the chargeback rate is 0.25%, input as 0.0025.

CurrencyCodeAlpha

The currency specified on the transaction requests, in ISO 4217 alpha currency code format.

Percentage

The approximate mix of card-not-present (CNP) transactions initiated by the customer, such as e-commerce orders. Formatted as a decimal, e.g., If customer-initiated CNP transactions make up 50% of total volume, input as 0.5. Together with merchantInitiatedCardNotPresentMix this makes up cardNotPresentMix.

Int

The number of days in the processing cycle.

DecimalAmount

The calculated potential exposure for the acceptor.

Decimal

The highest amount of a transaction, in the specified currency.

Percentage

The approximate mix of card-not-present (CNP) transactions initiated by the merchant, such as mail or telephone orders (MOTO). Formatted as a decimal, e.g., If merchant-initiated CNP transactions make up 30% of total volume, input as 0.3. Together with customerInitiatedCardNotPresentMix this makes up cardNotPresentMix.

Percentage

The approximate rate of refunds. Formatted as a decimal, e.g., If the refund rate is 10% of sales, input as 0.1

RiskLevel

The assessed risk level of the application’s processing activity.See RiskLevel

AcceptorApplicationServicesOutput

The desired services associated with the application.

Show child attributes

TransactionProcessingServiceOutput

Services related to transaction processing.See TransactionProcessingServiceOutput

ApplicationAssignee

The user assigned to the application.

Show child attributes

AssignedByUser!

required

The user who made the assignment.See AssignedByUser

DateTime!

required

The date and time when the assignment was made.

String!

required

The name of the assigned user.

UUID!

required

The unique identifier of the assigned user.

DateTime!

required

The date and time when the application was created.

UUID!

required

The unique identifier of the application.

[BoardingApplicationParticipant!]

The participants of the application.

Show child attributes

Organization!

required

The organization that is participating in this application.See Organization

ApplicationParticipantRole!

required

The role this organization plays in the boarding application.See ApplicationParticipantRole

WorkflowAssignment!

required

The queue the application is assigned to.

Show Possible enum values

enum

The workflow step is assigned to the partner or transactor, who must provide information or take action to proceed.

enum

The workflow step is assigned to the payment processor operations team for internal review or configuration.

enum

The workflow step is assigned to the underwriting team for risk evaluation, manual review, or compliance assessment.

DateTime

The date and time when the application submission was attempted.

DateTime

The date and time when the application was successfully submitted.

DateTime!

required

The date and time when the application was last updated.

Boarding

Transaction Processing

Risk, Compliance & Dispute Management

Reporting

Types

AcceptorApplication

Fields

​Fields

Fields