submitAcceptorApplication

Submit an application.

Operation

mutation SubmitAcceptorApplication($input: AcceptorApplicationSubmitInput!) {
  submitAcceptorApplication(input: $input) {
    acceptorApplication {
      acceptorId
      accountStatus
      applicationEvents {

      }
      applicationIdentity {
        acceptorReference
        acceptorRelationshipReference
        acceptorType
        businessEntityType
        businessName
        defaultMerchantCategoryCode
        isKnownAcceptor
        isLegalAddressSameAsBusinessAddress
        isProcessingStatement
        legalEntityName
        serviceTelephoneNumber
        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
      }
    }

}
}

Response

{
  "data": {
    "submitAcceptorApplication": {
      "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": "[phone]",
          "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": "[e-mail]",
            "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"
        }
      ]
    }
  }
}

Mutation

Arguments

input · AcceptorApplicationSubmitInput! · required

Show child attributes

id · UUID! · required

Return type

SubmitAcceptorApplicationPayload!

acceptorApplication · AcceptorApplication

The acceptor application that was created or updated.

Show child attributes

acceptorId · UUID

The acceptor ID assigned during onboarding.

accountStatus · AccountStatus

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

See AccountStatus

applicationEvents · ApplicationEventCollection

The events associated with the application.

See ApplicationEventCollection

applicationIdentity · AcceptorApplicationIdentityOutput

The identity information of the application.

See AcceptorApplicationIdentityOutput

applicationStatus · AcceptorApplicationStatus! · required

The status of the application.

See AcceptorApplicationStatus

assignee · ApplicationAssignee

The user assigned to the application.

See ApplicationAssignee

attachments · [Attachment!]! · required

The attachments associated with the application.

See Attachment

billingAndFunding · AcceptorApplicationBillingAndFundingOutput

The billing and funding information of the application.

See AcceptorApplicationBillingAndFundingOutput

cardAcceptorId · String

The card acceptor ID assigned during onboarding.

comments · [Comment!]! · required

The comments associated with the application.

See Comment

createdBy · Actor

The actor who created the application.

See Actor

createdDateTime · DateTime! · required

The date and time when the application was created.

decisionComponents · [DecisionComponent!]! · required

The underwriting decision components for the application.

See DecisionComponent

id · UUID! · required

The unique identifier of the application.

participants · [BoardingApplicationParticipant!]

The participants of the application.

See BoardingApplicationParticipant

processingActivity · AcceptorApplicationProcessingActivityOutput

The process activity information of the application.

See AcceptorApplicationProcessingActivityOutput

queue · WorkflowAssignment! · required

The queue the application is assigned to.

See WorkflowAssignment

schema · UnderwritingDecisionComponentsSchema

The underwriting decision components schema for the application.

See UnderwritingDecisionComponentsSchema

services · AcceptorApplicationServicesOutput

The desired services associated with the application.

See AcceptorApplicationServicesOutput

stakeholders · [StakeholderOutput!]! · required

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

See StakeholderOutput

submissionAttemptedDateTime · DateTime

The date and time when the application submission was attempted.

submissionSuccessfulDateTime · DateTime

The date and time when the application was successfully submitted.

updatedBy · Actor

The actor who updated the application.

See Actor

updatedDateTime · DateTime! · required

The date and time when the application was last updated.

errors · [SubmitAcceptorApplicationError!]

Errors that occurred during the mutation, if any. Null or empty indicates success.

Show Possible types

Show AcceptorApplicationValidationError

Represents a validation error on an acceptor application that is not specific to a single field.

code · AcceptorApplicationValidationErrorCode! · required

A static code for tying the response back programmatically.

See AcceptorApplicationValidationErrorCode

message · String! · required

A helpful message describing the validation failure.

Show AcceptorApplicationFieldValidationError

Represents a field-level validation error on an acceptor application.

code · AcceptorApplicationFieldValidationErrorCode! · required

A static code for tying the response back programmatically.

See AcceptorApplicationFieldValidationErrorCode

field · String! · required

The name of the field that failed validation.

message · String! · required

A helpful message describing how to fix the invalid value.

Show AcceptorApplicationStakeholderFieldValidationError

Represents a field-level validation error on a stakeholder within an acceptor application.

code · AcceptorApplicationStakeholderFieldValidationErrorCode! · required

A static code for tying the response back programmatically.

See AcceptorApplicationStakeholderFieldValidationErrorCode

field · String! · required

The name of the field that failed validation.

message · String! · required

A helpful message describing how to fix the invalid value.

stakeholderId · UUID! · required

The ID of the stakeholder whose field failed validation.

Show AcceptorApplicationBankAccountFieldValidationError

Represents a field-level validation error on a bank account within an acceptor application.

bankAccountId · UUID! · required

The associated bank account id

code · AcceptorApplicationBankAccountFieldValidationGraphQlErrorCode! · required

A static code for tying the response back programmatically

See AcceptorApplicationBankAccountFieldValidationGraphQlErrorCode

field · String! · required

The field that is invalid

message · String! · required

A helpful message to help fix the invalid value

Show ForbiddenError

advice · String! · required

code · CommonErrorCode! · required

See CommonErrorCode

message · String! · required

Show InvalidActorError

advice · String! · required

code · CommonErrorCode! · required

See CommonErrorCode

message · String! · required

Show InvalidOrganizationError

advice · String! · required

code · CommonErrorCode! · required

See CommonErrorCode

message · String! · required

Show NotFoundError

advice · String! · required

code · CommonErrorCode! · required

See CommonErrorCode

message · String! · required

resourceId · String

resourceName · String

Show ServerError

advice · String! · required

code · CommonErrorCode! · required

See CommonErrorCode

message · String! · required

Operation

mutation SubmitAcceptorApplication($input: AcceptorApplicationSubmitInput!) {
  submitAcceptorApplication(input: $input) {
    acceptorApplication {
      acceptorId
      accountStatus
      applicationEvents {

      }
      applicationIdentity {
        acceptorReference
        acceptorRelationshipReference
        acceptorType
        businessEntityType
        businessName
        defaultMerchantCategoryCode
        isKnownAcceptor
        isLegalAddressSameAsBusinessAddress
        isProcessingStatement
        legalEntityName
        serviceTelephoneNumber
        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
      }
    }

}
}

Response

{
  "data": {
    "submitAcceptorApplication": {
      "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": "[phone]",
          "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": "[e-mail]",
            "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"
        }
      ]
    }
  }
}