Activate 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.
To activate the new merchant account, you must initiate a POST request to the activation endpoint.
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 ' {
}'
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)
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.
{
"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.