Creating A New Business (With Merchant Data)

Access Endpoint URL: https://rest.everyware.com/api/Default/CreateNewMerchantAccount [POST]

You can use the CreateNewMerchantAccount method to create a new business attached to a merchant account, which in turn connects your business to the Everyware merchant ecosystem. This method requires more information from the outset, but also fast tracks your ability to take payments from customers.

It is necessary to provide the business owner's information—including a valid mailing address, email, and phone number—as the Main Business Contact when setting up a location for which a New Merchant application will be submitted. Once submitted, an Everyware Account Specialist will be in contact to complete the setup.

Inbound Parameters

Parameters should be passed in a single JSON-body object.

Parameter

Description

Optional/Required

FirstName

First name of Main Business Contact (Owner).

Required

LastName

Last name of Main Business Contact (Owner).

Required

DateOfBirth

Date Of Birth of Main Business Contact (Owner).

Format: MM-DD-YYYY

Required

SSN

Social Security Number for Main Business Contact (Owner).

Format: No hyphens

Required

Email

Email address for the Main Business Contact (Owner).

Appears on your email receipts and invoices.

Required

Phone

Phone Number for the Main Business Contact (10-digits max, no formatting).

Example: 3055551212

Required

Address1

Line One of the Main Business Contact's (Owner's) Street Address.

Required

Address2

Line Two of the Main Business Contact's (Owner's) Street Address. If not applicable, pass a whitespace character.

Required

City

City of Main Business Contact (Owner's) Street Address.

Required

State

State code of Main Business Contact (Owner's) Street Address.

Format: 2-letter code (TX, FL, etc.)

Required

PostalCode

The zip code of the Main Business Contact's (Owner's) address.

Required

BusinessLegalName

Legal name of the company.

Required

DBA

The Doing Business As name of the company.

Required

EIN

Tax Identification Number

Required

URL

Website address for the business. Do not include the http/https prefix.

Example: google.com

Required

BusinessTypeId

Numerical field denoting the type of business/industry/vertical the merchant account is for.

Contact your Everyware representative to confirm which BusinessTypeId value you should be using for the business(es) you will be onboarding with Everyware.

Required

BusinessAddress

Line One of the business's street address. Appears on invoices and receipts.

Required

BusinessCity

City of the business's street address.

Required

BusinessState

State code of the Main Business Contact (Owner).

Format: 2-letter code (TX, FL, etc.)

Required

BusinessPostalCode

The zip/postal code of the business street address.

Required

AccountName

The name of the business's bank account. This is the account to which Everyware will deposit funds.

Required

AccountNumber

The business's bank account number. It is the number of the account to which Everyware will deposit funds.

Required

BankName

The name of the business's bank. This is the bank to which Everyware will deposit funds.

Required

RoutingNumber

The business's bank routing number. This is the bank to which Everyware will deposit funds.

Required

ExternalAPIKey

Only enter if you want an external key defined by you to override the key assigned by Everyware.

Optional

PaymentsWebhookURL

When a payment is completed, Everyware will post the data to an optional webhook that you host. Must include a valid URL prefix (example: https://).

Optional

PaymentWebhookUsername

The username for the payment webhook that you host.

Optional

PaymentWebhookPassword

The password for the payment webhook that you host.

Optional

MessagesWebhookURL

When a message is created, Everyware will post the data to the appropriate webhook that you host. Must include a valid URL prefix (example: https://).

Optional

CustomersWebhookURL

When a customer is added, Everyware will post the data to the appropriate webhook that you host. Must include a valid URL prefix (example: https://).

Optional

ReferralId

The ID of the referring company/agent. It is sent to Everyware's account management team when new sales sites are created.

Example: "Business Inc"

Optional

ExternalID

The ID associated with the business in an external system.

Optional

GatewayId

The Payment Gateway ID. It is used to configure the gateway-specific onboarding process.

Optional

GatewayPasskey

The passkey corresponding to the gateway. It is used to configure the onboarding process, which varies by gateway.

Optional

Tier

Selected tier/plan. It is used to configure the gateway-specific onboarding process.

Optional

OwnershipType

The ownership type of the business.

Accepted values are:
"LLC",
"Corporation",
"Partnership",
"Sole Proprietor",
"Non-Profit"

Optional

AverageTicket

Average transaction amount.

Optional

HighTicket

Highest transaction amount.

Optional

CardMonthlyVolume

Average monthly credit card volume.

Optional

MccCode

The merchant's category code.

Optional

BusinessDescription

Description of goods and services.

Optional

SwipedPercent

The card present/swiped percentage.

Optional

KeyedPercent

The card not present/keyed percentage.

Optional

EcommercePercent

The eCommerce percentage.

Optional

OwnerTitle

The owner's title.

Example: "CEO", "CTO"

Optional

OwnershipPercent

The ownership percentage.

Optional

IsOwnerController

Defines whether the owner is the controller.

Optional

IsOwnerSigner

Defines whether the owner is the signer.

Optional

OwnerAddressCountryCode

Country code that corresponds to the owner's address.

Optional

BusinessAddressCountryCode

Country code that corresponds to the business's address.

Optional

AccountType

Type of bank account.

Example: "savings", "checking"

Optional

IPAddress

IP Address of the signing merchant. This can be retrieved by going to https://www.whatismyip.com/

Optional

👍

Optional: BusinessTypeID

The BusinessTypeID will determine the default services, invoice fields and other feature settings throughout the site. If blank, the industry will default to the Master Site’s Business Type. If blank at the Master Site level and business level, sites will default to the most generic site type, “Other.”

OUTBOUND PARAMETERS

Please note that the API response for this call is not in the universal response format. It is specific to this call.

ParameterDescription
MobileNumberUnique messaging phone number assigned for the business.
SalesSiteIDThe unique identifier in Everyware for the business.
APIKeyThe API Key for the newly created business.
UsernameThe username generated for the newly created business, which will usually be the same as a SalesSiteID.

CREATE NEW MERCHANT SAMPLE CODE

{
  "FirstName": "John",
  "LastName": "Test",
  "DateOfBirth": "01-01-2001",
  "SSN": "555443333",
  "Email": "[email protected]",
  "Phone": "5555555555",
  "Address1": "100 Main St",
  "Address2": "",
  "City": "Austin",
  "State": "TX",
  "PostalCode": "78754",
  "BusinessLegalName": "Pharmacist ABC",
  "DBA": "Pharmacist ABC",
  "EIN": "123456780",
  "URL": "www.drabc.com",
  "BusinessAddress": "201 Main St",
  "BusinessCity": "Austin",
  "BusinessState": "TX",
  "BusinessPostalCode": "78701",
  "AccountName": "ABC Bank Account",
  "AccountNumber": "9998899",
  "BankName": "ABC Bank",
  "RoutingNumber": "9999999998",
  "ReferralID": "Sunshine"
}
curl --location 'https://rest.everyware.com/api/Default/CreateNewMerchantAccount' \
--header 'Authorization: Basic [xxx]' \
--header 'Content-Type: application/json' \
--data-raw ' {
  "FirstName": "John",
  "LastName": "Test",
  "DateOfBirth": "01-01-2001",
  "SSN": "555443333",
  "Email": "[email protected]",
  "Phone": "5555555555",
  "Address1": "100 Main St",
  "Address2": "",
  "City": "Austin",
  "State": "TX",
  "PostalCode": "78754",
  "BusinessLegalName": "Pharmacist ABC",
  "DBA": "Pharmacist ABC",
  "EIN": "123456780",
  "URL": "www.drabc.com",
  "BusinessAddress": "201 Main St",
  "BusinessCity": "Austin",
  "BusinessState": "TX",
  "BusinessPostalCode": "78701",
  "AccountName": "ABC Bank Account",
  "AccountNumber": "9998899",
  "BankName": "ABC Bank",
  "RoutingNumber": "9999999998"
  "ReferralID": "Sunshine"
}'
{
    "IsSuccess": true,
    "Message": "Nice! New Business Account has been created successfully.",
    "Data": {
        "MobileNumber": "5555555555",
        "SalesSiteID": 127982,
        "APIKey": "XXXC-CCCC-CCCC-CCCC-XXXXXXXXX",
        "UserName": "127982"
}

PREVIEW IMAGE

In Everyware a newly created business profile page looks like this: