Activate the New Merchant Account

POST /accountmanagement/v1/accounts/account_id/activation

After the merchant account has been created with all its required elements, you must then activate that account. If the account is in the correct state and contains enough information the merchant will be on-boarded and go through our Risk and Compliance screening.

For merchants in Canada or the U.S. you must verify the identity of the business owner before you activate the merchant account.

To activate the new merchant account, you must initiate a POST request to the activation endpoint.

Request Example
curl -X POST https://api.test.paysafe.com/accountmanagement/v1/accounts/89987201/activation \
-u devcentre322:B-qa2-0-53625f86-302c021476f52bdc9deab7aea876bb28762e62f92fc6712d0214736abf501e9675e55940e83ef77f5c304edc7968 \
-H 'Content-Type: application/json' \
  -d ' {
    }'

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

By default, the merchant account is activated with the status of DEFERRED. Once it has successfully gone through Paysafe Risk and Compliance screening, the status will be updated to ENABLED or APPROVED. In some cases where the identity of the business owner was verified through the Paysafe API – and depending on the region and bank – the merchant account may be activated with the status of ENABLED or APPROVED immediately.

Response Example
{
	"account": {
		"id": "89987201",
		"name": "Popeyes Gym",
		"legalEntity": "Popeye's Inc",
		"productCode": "GOLD",
		"category": "CONSULTANT",
		"currency": "CAD",
		"region": "CA",
		"locale": "en_CA",
		"status": "DEFERRED",
		"url": "www.popeyessupplements.com",
		"phoneNumber": "8191112222",
		"email": "test.email@test.com",
		"userName": "luke_skywalker",
		"averageTransactionAmount": 100000,
		"caAccountDetails": {
			"type": "Corporation",
			"description": "Performance enhancing nutritional supplements",
			"isCardPresent": false,
			"hasPreviouslyProcessedCards": false,
			"shipsGoods": false,
			"refundPolicy": false,
			"federalTaxNumber": "1231"
		},
		"merchantDescriptor": {
			"dynamicDescriptor": "Popeyes",
			"phone": "1112223333"
		}
	},
	"accountAddress": {
		"id": "6a275b7c-6f11-4ed1-ae77-21071724574g",
		"street": "100 Queen Street West",
		"city": "Toronto",
		"state": "ON",
		"country": "CA",
		"zip": "M5H 2N2"
	},
	"businessOwnerDetails": [{
		"owner": {
			"id": "8ede583e-6326-4298-885b-988522f6c54e",
			"firstName": "Joe",
			"lastName": "Xavier",
			"middleName": "Smith",
			"email": "jxs@gmail.com",
			"jobTitle": "CEO",
			"phone": "5556668888",
			"ssn": "*******56",
			"dateOfBirth": {
				"day": 19,
				"month": 8,
				"year": 1976
			}
		},
		"ownerAddress": {
			"id": "6a275b7c-6f11-4ed1-ae77-21071724574g",
			"street": "270 RUE OLIER",
			"street2": "",
			"city": "Chicoutmi",
			"zip": "G7G4J3",
			"country": "CA",
			"state": "QC",
			"yearsAtAddress": "2"
		}
	}],
	"bankAccount": {
		"id": "de2d6f63-c6c5-42a3-8f97-54ea0a229318",
		"accountNumber": "511201",
		"transitNumber": "25039",
		"institutionId": "001"
	},
	"termCondition": {
		"id": "6a275b7c-6f11-4ed1-ae77-21071724574a",
		"version": "1.0",
		"dateAccepted": "2016-12-14T15:12:18Z"
	},
	"links": [{
		"rel": "self",
		"href": "https://api.test.paysafe.com/accountmanagement/v1/accounts/89987201"
	}]
}

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

Mandatory Merchant Account Elements for Account Activation

When you create a merchant account, only the following elements are mandatory: name, currency, region, legalEntity, and productCode. This is to make the account creation requirements as minimal as possible. However, before you can activate the merchant account, the following elements are required and you must update the merchant account to include them:

  • category
  • phone
  • yearlyVolumeRange
  • averageTransactionAmount
  • merchantDescriptor

Note that the merchantDescriptor is itself an object that contains two elements – dynamicDescriptor and phone – both of which are mandatory.

In addition, depending on the jurisdiction in which you are boarding merchants, one of the following objects is also mandatory before you can activate the merchant account:

  • Canada – caAccountDetails, for which type and federalTaxNumber are mandatory elements
  • United States – usAccountDetails, for which type and federalTaxNumber are mandatory elements
  • Europe – euAccountDetails, for which type is mandatory, and registrationNumber is mandatory unless the value for type is set to one of TRUST, SOLEPROP, GOV, or PARTNERSHIP (in which case registrationNumber is optional)
Did you find this page useful?