/api/v2/merchant/create

The POST /api/v2/merchant/create API method in the payment processing system is used to create a new merchant services application. This API method creates merchant application with basic information for bordering, after that to submit application you need to fill it using API method Submit or separate methods from Data merchant management section. Authentication is required, and the request must include all required fields in the body. A successful response returns details of the created application, along with a status code confirming submission, or validation errors if the data provided is incomplete or incorrect.

Merchant Boarding API: POST /api/v2/merchant/create

The POST /api/v2/merchant/create API endpoint allows users to initiate the creation of a merchant services application within the ISO merchant boarding system. This method is used to establish a new application with basic information, forming the foundation for onboarding a merchant.

Authentication

• Authentication is required to access this endpoint.
• Use API keys or other basic authorizations in the request headers.

Purpose

• This API method creates a new merchant application with the essential data necessary to initiate the boarding process.
• Once the application is created, additional details must be provided using either:
  • The POST /api/v2/merchant/submit API method.
  • Other methods available in the Data Merchant Management section.

Error Handling

• Validation errors occur if mandatory fields are missing or incorrectly formatted.
• Error responses include a descriptive list of issues to help correct the submission.

Next Steps After Creation

• Once the application is created, complete the merchant profile by submitting additional data using:
  • The POST /api/v2/merchant/submit API to finalize and submit the application.
  • Other specific API methods from the Data Merchant Management section for incremental updates.

Use Case

This endpoint is ideal for ISOs and merchant services platforms to initialize merchant onboarding applications efficiently, setting the stage for further data collection and submission.