--- title: "Update business" method: PATCH path: "/business/{business_token}" tags: ["Business"] --- # Update business `PATCH /business/{business_token}` This **PATCH** endpoint is used to update a previously created business.
You can use this endpoint to provide data and file updates to a previously submitted business enrollment request.
To use this endpoint, you need to provide the requested parameters in the request Body, including `business_token`, and other business entity related details.
The endpoint will then return the business token for the updated business entity. The response will contain a JSON object indicating the status of the request and any relevant business details. ## Request body - CreateBusinessTxn — Creates a new business, or merchant, entity for risk review, underwriting, and boarding. - `reference_id` string, required — Reference ID for the new Merchant (Business) being enrolled. Value is set by the integrator. - `legal_name` string, required — Legal name of the business being enrolled. - `type` 'Ccorp' | 'LLC' | 'Partnership' | 'Nonprofit' | 'Scorp' | 'Soleprop' | 'Other', required — The legal structure of the business. Options are "Ccorp", "LLC", "Partnership", "Nonprofit", "Scorp", "Soleprop", or "Other" - `category` string, required — Category, or industry, the business operates within. - `mcc_sic` string — The Merchant Category Code (MCC) or Standard Industrial Classfication (SIC) of the business. - `country` string, required — The country where the business is domiciled. For United States, use "USA" - `street1` string, required — The legal street one address of the business. - `street2` string — The legal street two address of the business. - `city` string, required — The legal address city of the business. - `state_prov` string, required — The legal address state or province of the business. - `postal_code` string, required — The legal address zip, or postal code, of the business. - `address_type` 'Residential' | 'Commercial' | 'Other' — The type of business address submitted. - `place_of_incorporation` string, required — The place where the business was incorporated. State, province and country - `incorporation_date` string, date, required — The date of business incorporation. Formatted as, "YYYY-MM-DD" - `phone_number` string, required — The phone number of the business. - `email_address` string, required — The email address of the business. - `website_address` string, required — The business website address. - `description` string, required — A description of the business and its goods and services sold. - `tax_id_type` 'Passport' | 'National Identification Card' | 'Driving License' | 'Social Security Card/Number' | 'Tax Payer Identification Card/Number' | 'Senior Citizen Identification Card' | 'Birth Certificate' | 'Village Elder Identification Card' | 'Permanent Residency Identification Card' | 'Alien Registration Certificate/Card' | 'PAN Card' | 'Voter’s Identification Card' | 'Health Insurance Card/Number' | 'Employer Identification Card' | 'Others not listed', required — The Tax ID type submitted. - `tax_id_number` string, required — The Tax ID number of the business. - `registration_number` string, required — The business registration number. - `articles_of_incorporation` string — If required, a file upload of the articles of incorporation. Base-64 format - `partner_comments` string — Any additional information to pass to our underwriting team. - `notify_user` boolean — 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. - `bank_details` object — The bank details section is used to obtain business bank account details. - `first_name` string — The first name listed on the bank account. - `last_name` string — The last name listed on the bank account. - `name_on_account` string, required — The full name associated with the bank account. - `account_type` 'Checking' | 'Savings' — The bank account type. - `routing_number` string, required — The designated routing number for the financial institution holding the bank account. - `account_number` string, required — The account number of the bank account. - `dba` object — The DBA section represents the operating location details. - `same_as_legal` boolean, required — Is the DBA, or operating address the same as the business legal address? Y or N. - `business_name` string — The DBA, or operating, business name. - `street1` string — The street one address of the operating business location. - `street2` string — The street two address of the operating business location. - `city` string — The operating business location city. - `state_prov` string — The operating business location state or province. - `postal_code` string — The operating business location zip, or postal, code. - `country` string — The operating business location country. For United States, use "USA" - `details` object — Additional details of the business profile. - `company_annual_revenue` number — The annual revenue of the business. - `days_to_receive_product_or_service` integer — The number of days it typically takes for the business customers to receive their goods or services. - `expected_monthly_payout_transaction_volume` number — The expected total monthly payout amount, in $, for the business. - `expected_monthly_payout_transaction_count` integer — The expected total number of monthly payouts (transaction count) for the business. - `transaction_types_accepted` string[] — The transaction types accepted by the business for customer payment. Multiple values can be selected. - `credit_and_debit_card_accepted` boolean — Are credit and debit cards accepted by the business. - `expected_monthly_amex_sales_volume` number — If American Express is accepted for paymnet, what is the expected total monthly sales amount? - `card_acceptance_card_present` number — Are credit or debit cards accepted in person? Specify their percent of volume. 0 if not accepted - `card_acceptance_card_not_present` number — Are credit or debit cards accepted where the cardholder is not present? Specify their percent of volume. 0 if not accepted - `card_acceptance_internet` boolean — Are credit or debit cards accepted via the internet? Y or N. - `total_ach_annual_amount` number — If ACH payments are accepted, was is the total annual ACH amount? - `average_ach_ticket_amount` number — If ACH payments are accepted, was is the average ACH ticket amount? - `highest_ach_ticket_amount` number — If ACH payments are accepted, was is the highest ACH ticket amount? - `max_monthly_ach_ticket_amount` number — The highest monthly ACH ticket amount. - `total_sales_monthly` number — The total monthly amount of sales. - `actual_or_projected_monthly_credit_debit_sales` number — The actual or projected monthly amount of sales paid for by credit or debit cards. - `highest_amount_ticket` number — The highest purchase ticket amount. - `times_year_highest_ticket_amount_expected` integer — The number of times in a year the highest ticket amount is expected. - `avg_ticket_amount` number — The average ticket amount. - `contact_person` object — The contact person is the submitter of the business enrollment. - `first_name` string — First name of the enrollment contact person. - `last_name` string — Last name of the enrollment contact person. - `title` string — Title of the enrollment contact person. - `email_address` string — Email address of the enrollment contact person. - `phone_number` string — Phone number of the enrollment contact person. - `reference_id` string — Business contact reference ID. - `principal` object[], required — Fill in at least one owner officer - `type` string[], required — Type of principal, i.e Owner and Officer - `reference_id` string — Owner/officer reference ID. - `title` string, required — Owner/officer title. - `first_name` string, required — Owner/officer first name. - `middle_name` string — Owner/officer middle name. - `last_name` string, required — Owner/officer last name. - `percentage_of_ownership` number, required — Owner/officer percentage of business ownership, 0-100%. - `address_same_as_legal` boolean, required — Owner/officer address same as the business legal address - `street1` string, required — Owner/officer address street one. - `street2` string — Owner/officer address street two. - `city` string, required — Owner/officer address city. - `state_prov` string, required — Owner/officer address state or province. - `postal_code` string, required — Owner/officer address zip, or postal code. - `country` string, required — Owner/officer address country, For United States use "USA". - `email_address` string, required — Owner/officer email address. - `phone_number` string, required — Owner/officer phone number. - `dob` string, date, required — Owner/officer date of birth. Format: "YYYY-MM-DD" - `tax_id_type` 'Passport' | 'National Identification Card' | 'Driving License' | 'Social Security Card/Number' | 'Tax Payer Identification Card/Number' | 'Senior Citizen Identification Card' | 'Birth Certificate' | 'Village Elder Identification Card' | 'Permanent Residency Identification Card' | 'Alien Registration Certificate/Card' | 'PAN Card' | 'Voter’s Identification Card' | 'Health Insurance Card/Number' | 'Employer Identification Card' | 'Others not listed', required — The Tax ID type submitted. - `tax_id_number` string, required — Owner/officer social security number. Format: "#########" - `id_document` string — An image of an ID document for the Owner/officer. Base64 encoded - `signing_application` boolean, required — Denotes if the Owner/officer is signing the application - `country_of_citizenship` string, required — Owner/officer country of citizenship. For United States, use "USA" - `webhooks` object[] - `webhook_url` string — The URL that will receive the webhook payloads - `event_types` string[] — The type of events the webhook will receive notifications for ## Response `200` Update business request received successfully - object - `business_token` string, required - `api_key` string, required ## Other responses - `201` — Created - `202` — Accepted - `204` — No Content - `400` — Bad Request - `401` — Unauthorized - `403` — Forbidden - `404` — Not Found - `500` — Internal Server Error - `504` — Gateway Timeout --- [API](https://skmtc.net/masspay/apis/masspay-api.md) · [All operations](https://skmtc.net/masspay/apis/masspay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/masspay/masspay-api/revisions/c03b61a6a551/schema)