> ## Documentation Index > Fetch the complete documentation index at: https://docs.tesouro.com/llms.txt > Use this file to discover all available pages before exploring further. # updateAcceptorApplication > Change an application. `Mutation` ## Arguments The unique identifier used to identify the acceptor application. An optional field that the Transactor would pass to potentially identify multiple acceptors that roll up to a broader relationship. The type of the acceptor (e.g., MERCHANT, SPONSORED\_MERCHANT, etc.). See [AcceptorType](/acquiring/reference/graphql/types/acceptor-type) The type of the application (e.g., MERCHANT, SPONSORED\_MERCHANT, etc.). Mirrors AcceptorType values. A biller that accepts payments for recurring services such as utilities, subscriptions, or invoices. A standard merchant that accepts card-present or card-not-present payments for goods or services. A seller operating under a marketplace or platform that routes payments on their behalf. A merchant sponsored by a payment facilitator, operating under the facilitator's master merchant account. A supplier in a B2B payment relationship, typically receiving payments from buyer organizations. A digital wallet provider that stores payment credentials and facilitates transactions on behalf of consumers. The physical location that the acceptor uses to identify itself for operational and communication purposes. The first line of the address. The second line of the address, if applicable. City, town, or village. The ISO 3166-1 three-letter country code associated with the address. See [CountryCode](/acquiring/reference/graphql/types/country-code) A set of specific numbers, and sometimes letters, that help postal services deliver mail. State or province. The legal structure of a company, which determines its rights, liabilities, and taxation. e.g., LLC, Sole proprietor, C-Corp, etc. See [BusinessEntityType](/acquiring/reference/graphql/types/business-entity-type) 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". The default merchant category code for the acceptor. Indicates the acceptor is a known trusted acceptor. Indicates that the legal address is the same as the business address. The physical location that the acceptor uses to identify itself for legal purposes. The first line of the address. The second line of the address, if applicable. City, town, or village. The ISO 3166-1 three-letter country code associated with the address. See [CountryCode](/acquiring/reference/graphql/types/country-code) A set of specific numbers, and sometimes letters, that help postal services deliver mail. State or province. The official, registered name of a business that appears on legal documents, and used to identify the company legally by the government. It is distinct from the "business name", "Doing Business As" (DBA), "trade name", "assumed name", and "fictitious name". List of 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](https://www.iso.org/standard/79450.html) 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. The telephone number of the organization that is provided on the billing statement for service inquiries. The names of the software providers used by the applicant. The sponsor bank (aka acquirer) for the acceptor. The unique identifier for the set of bins from the sponsor bank to use. The unique identifier for the sponsor bank. The U.S. state or jurisdiction in which the legal entity was incorporated or formed (2-character code). The tax identification number of the legal entity. Type of tax identification number. See [TaxIdentificationNumberType](/acquiring/reference/graphql/types/tax-identification-number-type) The tax identification number. The name of the referral partner, if present. This identifies any Gateways, POS software, or Fulfillment partners. This overrides the transactor's type when supplied. See [TransactorTypeI](/acquiring/reference/graphql/types/transactor-type-i) The website address for the applicant. The acceptor's end-of-day time in the provided timezone. Optional list of allocation overrides for the acceptor application. This allows you to specify custom fee amounts or rates for specific allocations. Input for adding a new allocation override to an acceptor application. Id of the Allocation you want to override. The overridden fee amount for this allocation profile. The overridden rate for this allocation profile. Formatted as a decimal, e.g., If the overridden rate is 3%, formatted as 0.03. Input for removing an allocation override from an acceptor application. The id of the allocation override to remove. Input for updating an existing allocation override on an acceptor application. Id of the Allocation you want to override. The overridden fee amount for this allocation profile. The overridden rate for this allocation profile. Formatted as a decimal, e.g., If the overridden rate is 3%, formatted as 0.03. Bank account information. Input for adding a new bank account to an acceptor application. The account number of the bank account. The type of the account owner (e.g., personal, business). See [AccountOwnerType](/acquiring/reference/graphql/types/account-owner-type) See [BankAccountFeesSettlements](/acquiring/reference/graphql/types/bank-account-fees-settlements) The type of the bank account (e.g., savings, demand). See [BankAccountType](/acquiring/reference/graphql/types/bank-account-type) Name of the institution where the account is held. The name on the bank account. The routing number of the bank account. Input for removing a bank account from an acceptor application. The ID of the bank account to remove. Input for updating an existing bank account on an acceptor application. The account number of the bank account. The type of the account owner (e.g., personal, business). See [AccountOwnerType](/acquiring/reference/graphql/types/account-owner-type) See [BankAccountFeesSettlements](/acquiring/reference/graphql/types/bank-account-fees-settlements) The type of the bank account (e.g., savings, demand). See [BankAccountType](/acquiring/reference/graphql/types/bank-account-type) Name of the institution where the account is held. The ID of the bank account to update. The name on the bank account. The routing number of the bank account. The billing descriptor information for the acceptor. The billing descriptor name. The billing descriptor service fee name. Id of the Billing Profile. The time zone of the acceptor, standardized by the Internet Assigned Numbers Authority (IANA). IANA time zones follow this convention: {Area}/{Location}, where an area corresponds to a continent or an ocean and the location to a location within the continent. See [IanaTimezone](/acquiring/reference/graphql/types/iana-timezone) Comments associated with the application Input for adding a new comment The comment text to add The average annual sales amount, in the specified currency. The average gross sales amount, in the specified currency. The average amount of a transaction, in the specified currency. 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. 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. The approximate rate of chargebacks. Formatted as a decimal, e.g., If the chargeback rate is 0.25%, input as 0.0025. The currency specified on the transaction requests, in ISO 4217 alpha currency code format. The number of days in the processing cycle. The highest amount of a transaction, in the specified currency. The approximate rate of refunds. Formatted as a decimal, e.g., If the refund rate is 10% of sales, input as 0.1 Services related to transaction processing. Configuration for the Account Updater service, enabling Tesouro to refresh card credentials for this acceptor. Indicator to enable the service. When set to True, the partner is instructing Tesouro to enable the service for this acceptor. Configuration for American Express acceptance (direct or OptBlue). Acceptor has a direct relationship with American Express who handles the financial settlement of funds, and manages chargebacks. An acquirer outside of American Express handles the financial settlement of funds, and manages chargebacks. American Express refers to this as its Opt-Blue program. Configuration for bank transfer processing, including enablement, limits, and activity metrics. The daily amount limit for bank transfers, in the specified acceptor processing activity currency. Flag to enable bank transfer processing for this acceptor. Configuration for bank transfer processing activity metrics (volumes, ticket sizes, return rates). Configuration for Discover acquiring relationships. An acquirer outside of Discover handles the financial settlement of funds, and manages chargebacks. Acceptor has a direct relationship with Discover who handles the financial settlement of funds, and manages chargebacks. Discover defines this relationship as the acceptor being retained by Discover. Configuration for Mastercard payment network enablement. Indicator to enable the service. When set to True, the partner is instructing Tesouro to enable the service for this acceptor. Configuration for Visa payment network enablement. Indicator to enable the service. When set to True, the partner is instructing Tesouro to enable the service for this acceptor. Stakeholders associated with the application Add a new business stakeholder to the application. The first line of the address. The second line of the address, if applicable. City, town, or village. The ISO 3166-1 three-letter country code associated with the address. See [CountryCode](/acquiring/reference/graphql/types/country-code) A set of specific numbers, and sometimes letters, that help postal services deliver mail. State or province. 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. See [StakeholderRole](/acquiring/reference/graphql/types/stakeholder-role) The tax identification number of the legal entity. Type of tax identification number. See [TaxIdentificationNumberType](/acquiring/reference/graphql/types/tax-identification-number-type) The tax identification number. Add a new person stakeholder to the application. Required if roles includes "Owner", "ControlPerson", "Guarantor". Always supply a SSN or ITIN if available. Social Security Number. Passport number - only to be used when the person's address is outside of the United States. Individual Tax Identification Number. The personal identification number. The person's first name. The person's last name. The person's middle name. The person's name post nominal. The person's salutation. The person's name suffix. 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. The first line of the address. The second line of the address, if applicable. City, town, or village. The ISO 3166-1 three-letter country code associated with the address. See [CountryCode](/acquiring/reference/graphql/types/country-code) A set of specific numbers, and sometimes letters, that help postal services deliver mail. State or province. See [StakeholderRole](/acquiring/reference/graphql/types/stakeholder-role) Remove a business stakeholder from the application. A unique UUID created by Tesouro and assigned to the stakeholder. Remove a person stakeholder from the application. A unique UUID created by Tesouro and assigned to the stakeholder. Update an existing business stakeholder in the application. A unique UUID created by Tesouro and assigned to the stakeholder. The first line of the address. The second line of the address, if applicable. City, town, or village. The ISO 3166-1 three-letter country code associated with the address. See [CountryCode](/acquiring/reference/graphql/types/country-code) A set of specific numbers, and sometimes letters, that help postal services deliver mail. State or province. 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. See [StakeholderRole](/acquiring/reference/graphql/types/stakeholder-role) The tax identification number of the legal entity. Type of tax identification number. See [TaxIdentificationNumberType](/acquiring/reference/graphql/types/tax-identification-number-type) The tax identification number. Update an existing person stakeholder in the application. A unique UUID created by Tesouro and assigned to the stakeholder. Required if roles includes "Owner", "ControlPerson", "Guarantor". Always supply a SSN or ITIN if available. Social Security Number. Passport number - only to be used when the person's address is outside of the United States. Individual Tax Identification Number. The personal identification number. The person's first name. The person's last name. The person's middle name. The person's name post nominal. The person's salutation. The person's name suffix. 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. The first line of the address. The second line of the address, if applicable. City, town, or village. The ISO 3166-1 three-letter country code associated with the address. See [CountryCode](/acquiring/reference/graphql/types/country-code) A set of specific numbers, and sometimes letters, that help postal services deliver mail. State or province. See [StakeholderRole](/acquiring/reference/graphql/types/stakeholder-role) The application has been approved, either automatically or manually. A processing account may now be created. The application has been rejected due to verification failures, compliance issues, or other disqualifying factors. The application is awaiting manual review or requires additional information to complete the underwriting process. The application has been withdrawn by the applicant, transactor, or Tesouro. No further review or decision will occur. ## Return type `UpdateAcceptorApplicationPayload!` The acceptor application that was created or updated. The acceptor ID assigned during onboarding. Current boarding process status. Null if boarding has not started. See [AccountStatus](/acquiring/reference/graphql/types/account-status) The events associated with the application. See [ApplicationEventCollection](/acquiring/reference/graphql/types/application-event-collection) The identity information of the application. See [AcceptorApplicationIdentityOutput](/acquiring/reference/graphql/types/acceptor-application-identity-output) The status of the application. See [AcceptorApplicationStatus](/acquiring/reference/graphql/types/acceptor-application-status) The user assigned to the application. See [ApplicationAssignee](/acquiring/reference/graphql/types/application-assignee) The attachments associated with the application. See [Attachment](/acquiring/reference/graphql/types/attachment) The billing and funding information of the application. See [AcceptorApplicationBillingAndFundingOutput](/acquiring/reference/graphql/types/acceptor-application-billing-and-funding-output) The card acceptor ID assigned during onboarding. The comments associated with the application. See [Comment](/acquiring/reference/graphql/types/comment) The actor who created the application. See [Actor](/acquiring/reference/graphql/types/actor) The date and time when the application was created. The underwriting decision components for the application. See [DecisionComponent](/acquiring/reference/graphql/types/decision-component) The unique identifier of the application. The participants of the application. See [BoardingApplicationParticipant](/acquiring/reference/graphql/types/boarding-application-participant) The process activity information of the application. See [AcceptorApplicationProcessingActivityOutput](/acquiring/reference/graphql/types/acceptor-application-processing-activity-output) The queue the application is assigned to. See [WorkflowAssignment](/acquiring/reference/graphql/types/workflow-assignment) The underwriting decision components schema for the application. See [UnderwritingDecisionComponentsSchema](/acquiring/reference/graphql/types/underwriting-decision-components-schema) The desired services associated with the application. See [AcceptorApplicationServicesOutput](/acquiring/reference/graphql/types/acceptor-application-services-output) Stakeholder information. Optionally reveal sensitive fields for a specific stakeholder. See [StakeholderOutput](/acquiring/reference/graphql/types/stakeholder-output) The date and time when the application submission was attempted. The date and time when the application was successfully submitted. The actor who updated the application. See [Actor](/acquiring/reference/graphql/types/actor) The date and time when the application was last updated. Errors that occurred during the mutation, if any. Null or empty indicates success. Represents a validation error on an acceptor application that is not specific to a single field. A static code for tying the response back programmatically. See [AcceptorApplicationValidationErrorCode](/acquiring/reference/graphql/types/acceptor-application-validation-error-code) A helpful message describing the validation failure. Represents a field-level validation error on an acceptor application. A static code for tying the response back programmatically. See [AcceptorApplicationFieldValidationErrorCode](/acquiring/reference/graphql/types/acceptor-application-field-validation-error-code) The name of the field that failed validation. A helpful message describing how to fix the invalid value. Represents a field-level validation error on a stakeholder within an acceptor application. A static code for tying the response back programmatically. See [AcceptorApplicationStakeholderFieldValidationErrorCode](/acquiring/reference/graphql/types/acceptor-application-stakeholder-field-validation-error-code) The name of the field that failed validation. A helpful message describing how to fix the invalid value. The ID of the stakeholder whose field failed validation. Represents a field-level validation error on a bank account within an acceptor application. The associated bank account id A static code for tying the response back programmatically See [AcceptorApplicationBankAccountFieldValidationGraphQlErrorCode](/acquiring/reference/graphql/types/acceptor-application-bank-account-field-validation-graph-ql-error-code) The field that is invalid A helpful message to help fix the invalid value See [CommonErrorCode](/acquiring/reference/graphql/types/common-error-code) See [CommonErrorCode](/acquiring/reference/graphql/types/common-error-code) See [CommonErrorCode](/acquiring/reference/graphql/types/common-error-code) See [CommonErrorCode](/acquiring/reference/graphql/types/common-error-code) See [CommonErrorCode](/acquiring/reference/graphql/types/common-error-code) ```graphql Operation lines expandable theme={null} mutation UpdateAcceptorApplication($input: AcceptorApplicationUpdateInput!) { updateAcceptorApplication(input: $input) { acceptorApplication { acceptorId accountStatus applicationEvents { } applicationIdentity { acceptorReference acceptorRelationshipReference acceptorType businessEntityType businessName defaultMerchantCategoryCode isKnownAcceptor isLegalAddressSameAsBusinessAddress isProcessingStatement legalEntityName serviceTelephoneNumber softwareProviderNames stateOfIncorporation transactorTypeII transactorTypeIII transactorTypeIOverride websiteUrl } applicationStatus assignee { assignedDateTime name userId } attachments { fileName id size uploadedDateTime } billingAndFunding { acceptorCutoffTime billingProfileId fundingProfileId timezone } cardAcceptorId comments { content createdDateTime id updatedDateTime } createdBy { name type } createdDateTime decisionComponents { hasAttachments hasComments id status updatedDateTime } id participants { role } processingActivity { averageAnnualSalesAmount averageMonthlySalesAmount averageTicketAmount cardNotPresentMix cardPresentMix chargebackRate currency daysInCycle exposure highestTicketAmount refundRate } queue schema { createdDateTime id version } services { } stakeholders { emailAddress id ipAddress ownershipPercentage roles } submissionAttemptedDateTime submissionSuccessfulDateTime updatedBy { name type } updatedDateTime } errors { ... on AcceptorApplicationValidationError { code message } ... on AcceptorApplicationFieldValidationError { code field message } ... on AcceptorApplicationStakeholderFieldValidationError { code field message stakeholderId } ... on AcceptorApplicationBankAccountFieldValidationError { bankAccountId code field message } ... on ForbiddenError { advice code message } ... on InvalidActorError { advice code message } ... on InvalidOrganizationError { advice code message } ... on NotFoundError { advice code message resourceId resourceName } ... on ServerError { advice code message } } } } ``` ```json Variables lines expandable theme={null} { "input": { "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" } } ``` ```bash cURL lines expandable theme={null} curl --request POST \ --url https://api.sandbox.com/graphql \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer ' \ --data '{ "query": "mutation UpdateAcceptorApplication($input: AcceptorApplicationUpdateInput!) {\n updateAcceptorApplication(input: $input) {\n acceptorApplication {\n acceptorId\n accountStatus\n applicationEvents {\n\n }\n applicationIdentity {\n acceptorReference\n acceptorRelationshipReference\n acceptorType\n businessEntityType\n businessName\n defaultMerchantCategoryCode\n isKnownAcceptor\n isLegalAddressSameAsBusinessAddress\n isProcessingStatement\n legalEntityName\n serviceTelephoneNumber\n softwareProviderNames\n stateOfIncorporation\n transactorTypeII\n transactorTypeIII\n transactorTypeIOverride\n websiteUrl\n }\n applicationStatus\n assignee {\n assignedDateTime\n name\n userId\n }\n attachments {\n fileName\n id\n size\n uploadedDateTime\n }\n billingAndFunding {\n acceptorCutoffTime\n billingProfileId\n fundingProfileId\n timezone\n }\n cardAcceptorId\n comments {\n content\n createdDateTime\n id\n updatedDateTime\n }\n createdBy {\n name\n type\n }\n createdDateTime\n decisionComponents {\n hasAttachments\n hasComments\n id\n status\n updatedDateTime\n }\n id\n participants {\n role\n }\n processingActivity {\n averageAnnualSalesAmount\n averageMonthlySalesAmount\n averageTicketAmount\n cardNotPresentMix\n cardPresentMix\n chargebackRate\n currency\n daysInCycle\n exposure\n highestTicketAmount\n refundRate\n }\n queue\n schema {\n createdDateTime\n id\n version\n }\n services {\n\n }\n stakeholders {\n emailAddress\n id\n ipAddress\n ownershipPercentage\n roles\n }\n submissionAttemptedDateTime\n submissionSuccessfulDateTime\n updatedBy {\n name\n type\n }\n updatedDateTime\n }\n errors {\n ... on AcceptorApplicationValidationError {\n code\n message\n }\n ... on AcceptorApplicationFieldValidationError {\n code\n field\n message\n }\n ... on AcceptorApplicationStakeholderFieldValidationError {\n code\n field\n message\n stakeholderId\n }\n ... on AcceptorApplicationBankAccountFieldValidationError {\n bankAccountId\n code\n field\n message\n }\n ... on ForbiddenError {\n advice\n code\n message\n }\n ... on InvalidActorError {\n advice\n code\n message\n }\n ... on InvalidOrganizationError {\n advice\n code\n message\n }\n ... on NotFoundError {\n advice\n code\n message\n resourceId\n resourceName\n }\n ... on ServerError {\n advice\n code\n message\n }\n }\n }\n}", "variables": { "input": { "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" } } }' ``` ```json Response lines expandable theme={null} { "data": { "updateAcceptorApplication": { "acceptorApplication": { "acceptorId": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "accountStatus": "ON_HOLD", "applicationEvents": { "items": [ "example" ], "pageInfo": "example" }, "applicationIdentity": { "acceptorReference": "CLACK-2026-001", "acceptorRelationshipReference": "REL-CLACK-001", "acceptorType": "BILLER", "businessAddress": "example", "businessEntityType": "ASSOCIATION", "businessName": "Clacksworth Keyboards", "defaultMerchantCategoryCode": "example", "isKnownAcceptor": true, "isLegalAddressSameAsBusinessAddress": true, "isProcessingStatement": true, "legalAddress": "example", "legalEntityName": "Clacksworth Keyboards LLC", "merchantCategories": [ "example" ], "sensitiveFields": "example", "serviceTelephoneNumber": "+15551234567", "softwareProviderNames": [ "example" ], "sponsorBank": "example", "stateOfIncorporation": "example", "taxIdentificationNumber": "example", "transactorTypeII": "example", "transactorTypeIII": [ "example" ], "transactorTypeIOverride": "BPSP", "websiteUrl": "https://clacksworth.com" }, "applicationStatus": "APPROVED", "assignee": { "assignedBy": "example", "assignedDateTime": "2026-01-15T14:30:00Z", "name": "Ben Torres", "userId": "c9a1e2d3-4b5f-6789-0abc-def123456789" }, "attachments": [ { "fileName": "business-license.pdf", "id": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901", "size": 0, "uploadedBy": "example", "uploadedDateTime": "2026-01-15T14:30:00Z" } ], "billingAndFunding": { "acceptorCutoffTime": "12:00:00", "bankAccounts": [ "example" ], "billingDescriptor": "CLACKSWORTH KEYBOARDS", "billingProfileId": "e7c3a4b5-6d7e-8901-2cde-f34567890123", "fundingProfileId": "b6d4e5f6-7a8b-9012-3def-456789012345", "timezone": "AMERICA_CHICAGO" }, "cardAcceptorId": "example", "comments": [ { "content": "Approved for mechanical keyboard accessories line.", "createdBy": "example", "createdDateTime": "2026-01-15T14:30:00Z", "decisionComponent": "example", "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "lastUpdatedBy": "example", "updatedDateTime": "2026-01-15T14:30:00Z" } ], "createdBy": { "name": "Ben Torres", "type": "APP" }, "createdDateTime": "2026-01-15T14:30:00Z", "decisionComponents": [ { "attachments": [ "example" ], "comments": [ "example" ], "hasAttachments": true, "hasComments": true, "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "items": [ "example" ], "lastUpdatedBy": "example", "schema": "example", "status": "ACCEPTED", "updatedDateTime": "2026-01-15T14:30:00Z" } ], "id": "c9a1e2d3-4b5f-6789-0abc-def123456789", "participants": [ { "organization": "example", "role": "BANK" } ], "processingActivity": { "averageAnnualSalesAmount": 0, "averageMonthlySalesAmount": 45000, "averageTicketAmount": 150, "cardNotPresentMix": 0.05, "cardPresentMix": 0.05, "chargebackRate": 0.05, "currency": "USD", "daysInCycle": 0, "exposure": 100000, "highestTicketAmount": 2500, "refundRate": 0.05 }, "queue": "PARTNER", "schema": { "createdDateTime": "2026-01-15T14:30:00Z", "id": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901", "underwritingDecisionComponentSchemas": [ "example" ], "version": "example" }, "services": { "transactionProcessingService": "example" }, "stakeholders": [ { "emailAddress": "ben@clacksworth.com", "id": "e7c3a4b5-6d7e-8901-2cde-f34567890123", "ipAddress": "example", "ownershipPercentage": 0.05, "roles": [ "AUTHORIZED" ], "sensitiveFields": "example" } ], "submissionAttemptedDateTime": "2026-01-15T14:30:00Z", "submissionSuccessfulDateTime": "2026-01-15T14:30:00Z", "updatedBy": { "name": "Ben Torres", "type": "APP" }, "updatedDateTime": "2026-01-15T14:30:00Z" }, "errors": [ { "__typename": "AcceptorApplicationValidationError", "code": "INTERNAL_SERVER_ERROR", "message": "example" } ] } } } ```