v1

latestOpenAPI 3.0.1Apache 2.02026-07-248286406.8 KB

Business

Create business

This POST endpoint is used to initiate create a business. <br> You can use this endpoint to establish a business which you can use to transact through the MassPay platform. <br> To use this endpoint, you need to provide the required parameters in the request Body, including business_legal_name, dba_business_name, business_incorporation_date, and other business entity related details. <br> The endpoint will then return a successful business token for the newly created entity. The response will contain a JSON object indicating the status of the request and any relevant business details.

post/business

Request body

reference_idstring required

Reference ID for the new Merchant (Business) being enrolled. Value is set by the integrator.

legal_namestring required

Legal name of the business being enrolled.

The legal structure of the business. Options are "Ccorp", "LLC", "Partnership", "Nonprofit", "Scorp", "Soleprop", or "Other"

categorystring required

Category, or industry, the business operates within.

mcc_sicstring

The Merchant Category Code (MCC) or Standard Industrial Classfication (SIC) of the business.

countrystring required

The country where the business is domiciled. For United States, use "USA"

street1string required

The legal street one address of the business.

street2string

The legal street two address of the business.

citystring required

The legal address city of the business.

state_provstring required

The legal address state or province of the business.

postal_codestring required

The legal address zip, or postal code, of the business.

address_type'Residential' | 'Commercial' | 'Other'

The type of business address submitted.

place_of_incorporationstring required

The place where the business was incorporated. State, province and country

incorporation_datestring date required

The date of business incorporation. Formatted as, "YYYY-MM-DD"

phone_numberstring required

The phone number of the business.

email_addressstring required

The email address of the business.

website_addressstring required

The business website address.

descriptionstring required

A description of the business and its goods and services sold.

The Tax ID type submitted.

tax_id_numberstring required

The Tax ID number of the business.

registration_numberstring required

The business registration number.

articles_of_incorporationstring

If required, a file upload of the articles of incorporation.

Base-64 format

partner_commentsstring

Any additional information to pass to our underwriting team.

notify_userboolean

Whenever set to true, we send an email to the Control person with the credentials to access the MassPay Dashboard. When set to false, no email notification would be sent.

Example request

{
  "reference_id": "ref-apple-inc",
  "legal_name": "Apple Inc.",
  "type": "Ccorp",
  "category": "COMPUTER SOFTWARE STORE",
  "mcc_sic": "5744",
  "country": "USA",
  "street1": "One Apple Park Way",
  "city": "Cupertino",
  "state_prov": "CA",
  "postal_code": "95014",
  "address_type": "Commercial",
  "place_of_incorporation": "California",
  "incorporation_date": "1977-01-03",
  "phone_number": "4089961010",
  "email_address": "support@apple.com",
  "website_address": "https://www.apple.com",
  "description": "Consumer electronics",
  "tax_id_type": "Employer Identification Card",
  "tax_id_number": "94-2404110",
  "registration_number": "RA000598",
  "articles_of_incorporation": "MA==",
  "partner_comments": "Public company, ticker: NASDAQ: AAPL",
  "bank_details": {
    "name_on_account": "Apple Inc",
    "account_type": "Checking",
    "routing_number": "322271627",
    "account_number": "971121121"
  },
  "details": {
    "card_acceptance_card_present": 50
  },
  "principal": [
    {
      "type": [
        "Control Person"
      ],
      "reference_id": "ref-tim",
      "title": "CEO",
      "first_name": "Tim",
      "last_name": "Cook",
      "percentage_of_ownership": 0.02,
      "street1": "One Apple Park Way",
      "city": "Cupertino",
      "state_prov": "CA",
      "postal_code": "95014",
      "country": "USA",
      "email_address": "tcook@apple.com",
      "phone_number": "4089961010",
      "dob": "1960-11-01",
      "tax_id_type": "Driving License",
      "tax_id_number": "D123456789",
      "country_of_citizenship": "USA"
    }
  ]
}

Response

Business enrollment request received successfully

business_tokenstring required

Token representing the business

api_keystring required

API key