Create a Business Owner

POST /accountmanagement/v1/accounts/account_id/businessowners

Now that you have created the merchant account and added a user, you must create a business owner who owns the merchant account.

To create a business owner, you must initiate a POST request to the businessowners endpoint. When you create the business owner, they are automatically associated with the account ID provided in the endpoint.

This example flow is for a Canadian applicant. Different fields are mandatory for US and EU merchants.

Request Example
curl -X POST https://api.test.paysafe.com/accountmanagement/v1/accounts/89987201/businessowners \
-u devcentre322:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H 'Content-Type: application/json' \
  -d ' {
    "firstName": "Joe",
    "middleName": "Xavier",
    "lastName": "Smith",
    "jobTitle": "CEO",
    "phone": "5559998888",
    "ssn": "123123456",
    "email": "jxs@gmail.com",
    "dateOfBirth": {
        "day": 19,
        "month": 8,
        "year": 1976
    },
    "nationality": "CA",
    "customerIp": "127.0.0.1"
}'

Prior to trying the example above, you should:

  • Replace the account number (89987201) in the URL with the Test account number you received.
  • Replace the API key (after the -u) with the API key you have received
Response Example
{
	"id": "8ede583e-6326-4298-885b-988522f6c54e",
	"firstName": "Joe",
	"lastName": "Xavier",
	"middleName": "Smith",
	"email": "jxs@gmail.com",
	"jobTitle": "CEO",
	"phone": "5559998888",
	"nationality": "CA",
	"customerIp": "127.0.0.1",
	"ssn": "*******56",
	"dateOfBirth": {
		"day": 19,
		"month": 8,
		"year": 1976
	},
	"links": [{
		"rel": "self",
		"href": "https://api.test.paysafe.com/accountmanagement/v1/businessowners/8ede583e-6326-4298-885b-988522f6c54e"
	}]
}

See our API Reference section for a list of all the JSON attributes and types available for the business owners endpoint.

Did you find this page useful?