mutation CreateAcceptorApplication($input: AcceptorApplicationCreateInput!) {
createAcceptorApplication(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
}
}
}
}
{
"input": {
"applicationIdentity": {
"acceptorReference": "CLACK-2026-001",
"acceptorRelationshipReference": "REL-CLACK-001",
"acceptorType": "BILLER"
},
"billingAndFunding": {
"acceptorCutoffTime": "12:00:00",
"allocationOverrides": [
"example"
],
"bankAccounts": [
"example"
]
},
"comments": [
{
"addCommentsInput": "example"
}
]
}
}
curl --request POST \
--url https://api.sandbox.com/graphql \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
--data '{
"query": "mutation CreateAcceptorApplication($input: AcceptorApplicationCreateInput!) {\n createAcceptorApplication(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": {
"applicationIdentity": {
"acceptorReference": "CLACK-2026-001",
"acceptorRelationshipReference": "REL-CLACK-001",
"acceptorType": "BILLER"
},
"billingAndFunding": {
"acceptorCutoffTime": "12:00:00",
"allocationOverrides": [
"example"
],
"bankAccounts": [
"example"
]
},
"comments": [
{
"addCommentsInput": "example"
}
]
}
}
}'
{
"data": {
"createAcceptorApplication": {
"acceptorApplication": {
"acceptorId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"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": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
},
"attachments": [
{
"fileName": "business-license.pdf",
"id": "c9a1e2d3-4b5f-6789-0abc-def123456789",
"size": 0,
"uploadedBy": "example",
"uploadedDateTime": "2026-01-15T14:30:00Z"
}
],
"billingAndFunding": {
"acceptorCutoffTime": "12:00:00",
"bankAccounts": [
"example"
],
"billingDescriptor": "CLACKSWORTH KEYBOARDS",
"billingProfileId": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
"fundingProfileId": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
"timezone": "AMERICA_CHICAGO"
},
"cardAcceptorId": "example",
"comments": [
{
"content": "Approved for mechanical keyboard accessories line.",
"createdBy": "example",
"createdDateTime": "2026-01-15T14:30:00Z",
"decisionComponent": "example",
"id": "b6d4e5f6-7a8b-9012-3def-456789012345",
"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": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"items": [
"example"
],
"lastUpdatedBy": "example",
"schema": "example",
"status": "ACCEPTED",
"updatedDateTime": "2026-01-15T14:30:00Z"
}
],
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"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": "c9a1e2d3-4b5f-6789-0abc-def123456789",
"underwritingDecisionComponentSchemas": [
"example"
],
"version": "example"
},
"services": {
"transactionProcessingService": "example"
},
"stakeholders": [
{
"emailAddress": "ben@clacksworth.com",
"id": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
"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"
}
]
}
}
}
Boarding
createAcceptorApplication
Create an application.
mutation CreateAcceptorApplication($input: AcceptorApplicationCreateInput!) {
createAcceptorApplication(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
}
}
}
}
{
"input": {
"applicationIdentity": {
"acceptorReference": "CLACK-2026-001",
"acceptorRelationshipReference": "REL-CLACK-001",
"acceptorType": "BILLER"
},
"billingAndFunding": {
"acceptorCutoffTime": "12:00:00",
"allocationOverrides": [
"example"
],
"bankAccounts": [
"example"
]
},
"comments": [
{
"addCommentsInput": "example"
}
]
}
}
curl --request POST \
--url https://api.sandbox.com/graphql \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
--data '{
"query": "mutation CreateAcceptorApplication($input: AcceptorApplicationCreateInput!) {\n createAcceptorApplication(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": {
"applicationIdentity": {
"acceptorReference": "CLACK-2026-001",
"acceptorRelationshipReference": "REL-CLACK-001",
"acceptorType": "BILLER"
},
"billingAndFunding": {
"acceptorCutoffTime": "12:00:00",
"allocationOverrides": [
"example"
],
"bankAccounts": [
"example"
]
},
"comments": [
{
"addCommentsInput": "example"
}
]
}
}
}'
{
"data": {
"createAcceptorApplication": {
"acceptorApplication": {
"acceptorId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"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": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
},
"attachments": [
{
"fileName": "business-license.pdf",
"id": "c9a1e2d3-4b5f-6789-0abc-def123456789",
"size": 0,
"uploadedBy": "example",
"uploadedDateTime": "2026-01-15T14:30:00Z"
}
],
"billingAndFunding": {
"acceptorCutoffTime": "12:00:00",
"bankAccounts": [
"example"
],
"billingDescriptor": "CLACKSWORTH KEYBOARDS",
"billingProfileId": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
"fundingProfileId": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
"timezone": "AMERICA_CHICAGO"
},
"cardAcceptorId": "example",
"comments": [
{
"content": "Approved for mechanical keyboard accessories line.",
"createdBy": "example",
"createdDateTime": "2026-01-15T14:30:00Z",
"decisionComponent": "example",
"id": "b6d4e5f6-7a8b-9012-3def-456789012345",
"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": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"items": [
"example"
],
"lastUpdatedBy": "example",
"schema": "example",
"status": "ACCEPTED",
"updatedDateTime": "2026-01-15T14:30:00Z"
}
],
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"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": "c9a1e2d3-4b5f-6789-0abc-def123456789",
"underwritingDecisionComponentSchemas": [
"example"
],
"version": "example"
},
"services": {
"transactionProcessingService": "example"
},
"stakeholders": [
{
"emailAddress": "ben@clacksworth.com",
"id": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
"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"
}
]
}
}
}
Mutation
Arguments
Show child attributes
Show child attributes
Show child attributes
Show child attributes
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
The type of the application (e.g., MERCHANT, SPONSORED_MERCHANT, etc.). Mirrors AcceptorType values.
Show Possible enum values
Show Possible enum 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.
Show child attributes
Show child attributes
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
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
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.
Show child attributes
Show child attributes
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
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
Show child attributes
Show child attributes
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 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.
Show child attributes
Show child attributes
Type of tax identification number.See TaxIdentificationNumberType
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
The website address for the applicant.
Show child attributes
Show child attributes
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.
Show child attributes
Show child attributes
Bank account information.
Show child attributes
Show child attributes
The account number of the bank account.
The type of the account owner (e.g., personal, business).See AccountOwnerType
The type of the bank account (e.g., savings, demand).See BankAccountType
Name of the institution where the account is held.
The name on the bank account.
The routing number of the bank account.
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: /, where an area corresponds to a continent or an ocean and the location to a location within the continent.See IanaTimezone
Locations to be created for this acceptor.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The acceptor outlets assigned to this location.
Show child attributes
Show child attributes
The billing descriptor information for the outlet if different from the acceptor.
The name of the outlet.
The merchant category code (MCC) associated with the outlet if different from the acceptor.
The point of interactions to be created within the outlet.
The unique reference assigned by the acceptor of the outlet to be created.
The address of the phsyical location.
Show child attributes
Show child attributes
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
A set of specific numbers, and sometimes letters, that help postal services deliver mail.
State or province.
The display name of the location to be created.
Identification assigned by the acceptor for this location to be created.
Show child attributes
Show child attributes
The acceptor outlets assigned to this location.
Show child attributes
Show child attributes
The billing descriptor information for the outlet if different from the acceptor.
The name of the outlet.
The merchant category code (MCC) associated with the outlet if different from the acceptor.
The unique reference assigned by the acceptor of the outlet to be created.
The display name of the location to be created.
Identification assigned by the acceptor for this location to be created.
The URL of the website location to be created.
Show child attributes
Show child attributes
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
Show child attributes
Show child attributes
Services related to transaction processing.
Show child attributes
Show child attributes
Configuration for the Account Updater service, enabling Tesouro to refresh card credentials for this acceptor.
Show child attributes
Show child attributes
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).
Show child attributes
Show child attributes
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.
Show child attributes
Show child attributes
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.
Show child attributes
Show child attributes
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.
Show child attributes
Show child attributes
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
Show child attributes
Show child attributes
Add a new business stakeholder to the application.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
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
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
The tax identification number of the legal entity.
Show child attributes
Show child attributes
Type of tax identification number.See TaxIdentificationNumberType
The tax identification number.
Add a new person stakeholder to the application.
Show child attributes
Show child attributes
Required if roles includes “Owner”, “ControlPerson”, “Guarantor”.
Show child attributes
Show child attributes
The personal identification number.
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.
Show child attributes
Show child attributes
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
A set of specific numbers, and sometimes letters, that help postal services deliver mail.
State or province.
See StakeholderRole
Return type
CreateAcceptorApplicationPayload!
The acceptor application that was created or updated.
Show child attributes
Show child attributes
The acceptor ID assigned during onboarding.
Current boarding process status. Null if boarding has not started.See AccountStatus
The events associated with the application.See ApplicationEventCollection
The identity information of the application.See AcceptorApplicationIdentityOutput
The status of the application.See AcceptorApplicationStatus
The user assigned to the application.See ApplicationAssignee
The attachments associated with the application.See Attachment
The billing and funding information of the application.See AcceptorApplicationBillingAndFundingOutput
The card acceptor ID assigned during onboarding.
The date and time when the application was created.
The underwriting decision components for the application.See DecisionComponent
The unique identifier of the application.
The participants of the application.See BoardingApplicationParticipant
The process activity information of the application.See AcceptorApplicationProcessingActivityOutput
The queue the application is assigned to.See WorkflowAssignment
The underwriting decision components schema for the application.See UnderwritingDecisionComponentsSchema
The desired services associated with the application.See AcceptorApplicationServicesOutput
Stakeholder information. Optionally reveal sensitive fields for a specific stakeholder.See StakeholderOutput
The date and time when the application submission was attempted.
The date and time when the application was successfully submitted.
The date and time when the application was last updated.
Errors that occurred during the mutation, if any. Null or empty indicates success.
Show Possible types
Show Possible types
Show AcceptorApplicationValidationError
Show AcceptorApplicationValidationError
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
A helpful message describing the validation failure.
Show AcceptorApplicationFieldValidationError
Show AcceptorApplicationFieldValidationError
Represents a field-level validation error on an acceptor application.
A static code for tying the response back programmatically.See AcceptorApplicationFieldValidationErrorCode
The name of the field that failed validation.
A helpful message describing how to fix the invalid value.
Show AcceptorApplicationStakeholderFieldValidationError
Show AcceptorApplicationStakeholderFieldValidationError
Represents a field-level validation error on a stakeholder within an acceptor application.
A static code for tying the response back programmatically.See AcceptorApplicationStakeholderFieldValidationErrorCode
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.
Show AcceptorApplicationBankAccountFieldValidationError
Show AcceptorApplicationBankAccountFieldValidationError
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 programmaticallySee AcceptorApplicationBankAccountFieldValidationGraphQlErrorCode
The field that is invalid
A helpful message to help fix the invalid value
Show ForbiddenError
Show ForbiddenError
Show InvalidActorError
Show InvalidActorError
Show InvalidOrganizationError
Show InvalidOrganizationError
Show NotFoundError
Show NotFoundError
Show ServerError
Show ServerError
mutation CreateAcceptorApplication($input: AcceptorApplicationCreateInput!) {
createAcceptorApplication(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
}
}
}
}
{
"input": {
"applicationIdentity": {
"acceptorReference": "CLACK-2026-001",
"acceptorRelationshipReference": "REL-CLACK-001",
"acceptorType": "BILLER"
},
"billingAndFunding": {
"acceptorCutoffTime": "12:00:00",
"allocationOverrides": [
"example"
],
"bankAccounts": [
"example"
]
},
"comments": [
{
"addCommentsInput": "example"
}
]
}
}
curl --request POST \
--url https://api.sandbox.com/graphql \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
--data '{
"query": "mutation CreateAcceptorApplication($input: AcceptorApplicationCreateInput!) {\n createAcceptorApplication(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": {
"applicationIdentity": {
"acceptorReference": "CLACK-2026-001",
"acceptorRelationshipReference": "REL-CLACK-001",
"acceptorType": "BILLER"
},
"billingAndFunding": {
"acceptorCutoffTime": "12:00:00",
"allocationOverrides": [
"example"
],
"bankAccounts": [
"example"
]
},
"comments": [
{
"addCommentsInput": "example"
}
]
}
}
}'
{
"data": {
"createAcceptorApplication": {
"acceptorApplication": {
"acceptorId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"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": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
},
"attachments": [
{
"fileName": "business-license.pdf",
"id": "c9a1e2d3-4b5f-6789-0abc-def123456789",
"size": 0,
"uploadedBy": "example",
"uploadedDateTime": "2026-01-15T14:30:00Z"
}
],
"billingAndFunding": {
"acceptorCutoffTime": "12:00:00",
"bankAccounts": [
"example"
],
"billingDescriptor": "CLACKSWORTH KEYBOARDS",
"billingProfileId": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
"fundingProfileId": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
"timezone": "AMERICA_CHICAGO"
},
"cardAcceptorId": "example",
"comments": [
{
"content": "Approved for mechanical keyboard accessories line.",
"createdBy": "example",
"createdDateTime": "2026-01-15T14:30:00Z",
"decisionComponent": "example",
"id": "b6d4e5f6-7a8b-9012-3def-456789012345",
"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": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"items": [
"example"
],
"lastUpdatedBy": "example",
"schema": "example",
"status": "ACCEPTED",
"updatedDateTime": "2026-01-15T14:30:00Z"
}
],
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"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": "c9a1e2d3-4b5f-6789-0abc-def123456789",
"underwritingDecisionComponentSchemas": [
"example"
],
"version": "example"
},
"services": {
"transactionProcessingService": "example"
},
"stakeholders": [
{
"emailAddress": "ben@clacksworth.com",
"id": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
"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"
}
]
}
}
}
Was this page helpful?
⌘I