Skip to main content

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.

Start by calling the createAcceptorApplication mutation with the initial application details. If possible, provide all application details in this call. Note that this mutation does not perform validation on the application data - validation only occurs when you submit the application.
ScenarioA developer at Clearpath Payments is using Tesouro’s acquiring API to board Maple Street Coffee as a new sub-merchant acceptor. They’ll start with the basic business information and can add stakeholder details and bank accounts either in this initial call or through subsequent updates.
While you can create a minimal application and add details later, it’s more efficient to include as much information as possible in the initial createAcceptorApplication call to reduce the number of back and forth requests.
Next steps after creation After creating the application:
  • Add missing details: If you did not provide all required data in the initial createAcceptorApplication call, you can update application
  • Submit for processing: Once all required data is provided, submit application to begin underwriting
Required fields See the complete list of required fields for detailed information about all mandatory and conditional fields for acceptor applications. 
mutation AcceptorApplicationCreate($input: AcceptorApplicationCreateInput!) {
  createAcceptorApplication(input: $input) {
    acceptorApplication {
      id
      applicationStatus
    }
    errors {
      ... on Error {
        message
        __typename
      }
    }
  }
}

{
  "data": {
    "createAcceptorApplication": {
      "acceptorApplication": {
        "id": "60c66576-0caf-4dd1-8c66-fccae049f0fd",
        "applicationStatus": "CREATED"
      }
    }
  },
  "extensions": {
    "rateLimit": {
      "requestRate": 1,
      "remaining": 48,
      "retryAfterMs": 0,
      "resetAfterMs": 20
    }
  }
}