Skip to main content

​
Overview

Acceptor boarding is in Beta and not ready for production integration.
To onboard a new acceptor to Tesouro, you’ll use a series of GraphQL mutations to create and submit an application. The flow is flexible — you can either submit a fully completed application in a single request or progressively build the application over multiple steps.
Ben runs a mechanical keyboard business and wants to start accepting payments through Tesouro. He needs to create an acceptor application that includes his business details, stakeholder information, and bank account details before he can begin processing transactions.
Here’s what the process generally looks like:
  • Query available billing profiles and corresponding allocations via billingProfiles to understand existing fee structures for processing transactions.
  • Create the application using createAcceptorApplication with a billing profile (including allocation overrides), stakeholders (owners, control person, etc.), bank accounts, and other required data.
  • Add any missing details via updateAcceptorApplication, if necessary.
  • Submit the application via submitAcceptorApplication once all required data is provided.
  • Proceed to account creation and boarding once underwriting is approved.
This guide walks through each of these steps, explaining the required inputs, response formats, and how to handle validation.