# Onboard Merchant The following endpoints help you manage the merchant onboarding process, from creating a merchant application to submitting it for review and approval. The following steps help to onboard a merchant: {% stepper %} {% step %} #### Create merchant profile Submit a request to the [Create Merchant Application](https://docs.xplorpay.com/api-reference/api/merchant-onboarding/onboard-merchant/application-management/application#post-api-boardingmanagement-v1.0-applications-create) endpoint using your assigned portfolio MID. This MID is a unique 16-digit identifier provided during integration setup and represents your merchant portfolio. In the request: * Set the `MerchantId` HTTP header to your portfolio’s MID. * ​Include the `HierarchyNodeKey` in the request body to define where the new merchant belongs in the hierarchy. The response returns a new 16-digit MID. Use this MID in all subsequent onboarding API requests. {% endstep %} {% step %} #### Create merchant application Use the [Create Merchant Application](https://docs.xplorpay.com/api-reference/api/merchant-onboarding/onboard-merchant/application-management/application#post-api-boardingmanagement-v1.0-applications-create) endpoint to create the merchant application using the assigned MID. This step collects required onboarding details such as business name and hierarchy placement before submitting the application for underwriting and setup. {% endstep %} {% step %} #### Provide merchant demographic and business details Collect and submit merchant demographic and business information through [Merchant Demographics APIs](https://docs.xplorpay.com/api-reference/api/merchant-onboarding/onboard-merchant/merchant-demographics). This process ensures that the merchant account includes all required information for verification and underwriting. {% hint style="warning" %} Once a merchant is initially created, the system pre-generates empty demographic records such as mailing address, physical address, taxpayer information, and sales profiles. Update these records using the related `PUT` endpoints. {% endhint %} {% endstep %} {% step %} #### Configure pricing plan Use the [Pricing Plan API](https://docs.xplorpay.com/api-reference/api/merchant-onboarding/onboard-merchant/pricing-plan-and-reference/pricingplanv2#post-api-pricing-v2-pricingplan-merchantnumber) to create or update merchant pricing plans during onboarding. This helps to configure the transaction fees, service charges, and other cost-related configurations that align with each merchant’s business needs. Customizable pricing plans are flexible pricing structure based on your business requirements. Each plan can include specific fee types, rates, and service charges. Configure pricing using predefined templates or customize plans to match individual business requirements. {% endstep %} {% step %} #### Add equipment, documents, and compliance data Complete equipment survey to order equipment using [Equipment Order API.](https://docs.xplorpay.com/api-reference/api/merchant-onboarding/onboard-merchant/equipment/equipment-order/equipment-order-controller) It helps to streamline the process of configuring and ordering devices required for payment processing. You can select the supported devices, such as POS terminals or card readers and payment hardware devices. Once submitted, the system provisions the hardware and links it to the corresponding Merchant ID (MID). To configure equipment: 1. Retrieve available equipment products. 2. Retrieve the equipment [configuration survey](https://docs.xplorpay.com/api-reference/api/merchant-onboarding/onboard-merchant/equipment/equipment-configuration-survey) for the selected device. 3. Complete and submit the required survey configuration. 4. Submit the equipment order. After submission, the system provisions the hardware and associates it with the merchant MID. {% endstep %} {% step %} #### Submit application signature Merchant consent is collected through signature submission to complete the onboarding application. You can submit signatures electronically or through uploaded signed documents. **Electronic signature submission** To submit electronic signatures: 1. Mark at least one business contact as a signer. 2. ​Present the legal terms and conditions to the signer for review. 3. ​Provide a method for the signer to accept the agreement (for example, a checkbox). 4. ​Submit the signature using the [Submit Signatures](https://docs.xplorpay.com/api-reference/api/merchant-onboarding/onboard-merchant/application-management/application#post-api-boardingmanagement-v1.0-applications-merchantnumber-submitsignatures) endpoint. **Signature submission via document upload** Merchants preferring physical signatures can print, sign, and then upload the signed documents for submission using below process: 1. Mark at least one business contact as a signer. 2. ​Allow the merchant to upload the signed documents through your application. 3. ​Submit the uploaded document using the [Upload Document](https://docs.xplorpay.com/api-reference/api/merchant-onboarding/onboard-merchant/merchant-demographics/documents#post-api-demographics-v1-documents-merchantnumber) endpoint. 4. Submit the signature confirmation using the [Submit Signatures](https://docs.xplorpay.com/api-reference/api/merchant-onboarding/onboard-merchant/application-management/application#post-api-boardingmanagement-v1.0-applications-merchantnumber-submitsignatures) endpoint. Once a merchant submit the signature, the system validates the submitted information and if any errors are found, they are returned in the response. If the data is valid, the signatures are accepted, and the submission is complete. After a successful submission, no further changes can be made to the merchant through the Merchant Onboarding API. This process ensures Xplor Pay receives the required authorization while supporting flexible signature submission options. {% endstep %} {% step %} #### Submit application for review and approval Submit the application for processing after all required onboarding data and signatures are completed. After submission, Xplor Pay validates the onboarding information, including business contacts, banking information, and compliance details and performs automated underwriting and compliance review. * ​**Underwriting review** – The submitted data is reviewed for compliance and risk evaluation. * ​**Equipment activation** – Provisions configured payment hardware. This step transitions the merchant from onboarding to operational status. ​After successful review and approval, the response returns HTTP `200 OK` with confirmation that the merchant application is approved. The merchant account is activated and ready to process payments. {% endstep %} {% endstepper %} After onboarding is complete, proceed to [Payment Processing](https://docs.xplorpay.com/api-reference/api/payments). * [Application Management](/api-reference/api/merchant-onboarding/onboard-merchant/application-management.md) * [Merchant Demographics](/api-reference/api/merchant-onboarding/onboard-merchant/merchant-demographics.md) * [Pricing Plan and Reference](/api-reference/api/merchant-onboarding/onboard-merchant/pricing-plan-and-reference.md) * [Equipment](/api-reference/api/merchant-onboarding/onboard-merchant/equipment.md) * [Merchant Legal Documents](/api-reference/api/merchant-onboarding/onboard-merchant/merchant-legal-documents.md) * [eDocs Reporting](/api-reference/api/merchant-onboarding/onboard-merchant/edocs-reporting.md) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.xplorpay.com/api-reference/api/merchant-onboarding/onboard-merchant.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.