📄️ Introduction
The Account Management System API features endpoints that let you onboard your own merchant partner accounts. Note that before utilizing this API, you must have worked with Splitit to define and understand the required data you'll need to create your merchant partners. Once you have done that, proceed to the [Guide](/api/ams/guide).
📄️ Guide
Follow the steps below to onboard your own merchant partner accounts by API. You have two choices of flow, one that only uses API calls, whereby you provide the data for your merchant partners, and one that uses a form, in which case your merchant partners input their data.
📄️ Get Splitit Token
Authenticate using your *client_id* and *client_secret* from your [merchant portal](https://merchant.sandbox.splitit.com) (Splitit support will also have to enable AMS API access for you).
📄️ Structure for Add Merchant Partner Requests
Using your bearer token to authenticate, fetch the fields that you will need to complete an [Add Merchant Partner](/api/ams/partner-profiles-create-dynamic) request. (Note that these fields have been previously agreed upon between you and Splitit.) In addition, note that the [response's](/api/ams/guide#2-view-the-required-format-for-your-add-requests) *RequestUrlEndpoint* here includes the full URL (including *profileID*) that you will need to add new merchants using the [Add Merchant Partner](/api/ams/partner-profiles-create-dynamic) endpoint.
📄️ Add Merchant Partner
Use this endpoint to add a new merchant to your account by providing information for the fields that were returned in the object from [Structure for Add Merchant Partner Requests](/api/ams/partner-profiles-get-structure). As before, authenticate with your bearer token. Note that you can receive ongoing webhooks related to onboarding status by adding your desired URL to the `OnboardingInitialSetup` object
📄️ Upload Documents
Use this endpoint to upload documents to Splitit (e.g., agreements) for partners or merchants. You can add multiple documents at once. Authentication is by bearer token.
📄️ Send Invite Emails
Instead of inputting merchant partner information yourself, use a merchant partner's email address(es) to send them to a web link with a prefilled form. If the *profileID* and email address(es) you send the endpoint are valid, the system will create a prefilled form and will send invitations to the email address(es) you provide (if your inputs aren't valid, you will get the appropriate error messages). As with the other endpoints, you must add your bearer token. Note that if you don't have your *profileId*, you can get it by calling [Structure for Add Merchant Partner Requests](/api/ams/partner-profiles-get-structure) and looking at the end of the *RequestUrlEndpoint* field in the response.
📄️ Get Onboarding Status
Call this endpoint to get the onboarding status of an account you added. You can add multiple documents at once. Authenticate with your bearer token.