Get Merchant's Sales and Business Profile

Retrieves the complete sales and business profile for a merchant application. The response includes the merchant's SIC code, business type, banking information, monthly and average transaction volumes, the card-present/MOTO/internet processing breakdown, and optional card-not-present (CNP) supplemental data. This data is required before submitting the merchant for processing.

Endpoint

GET /api/v1/merchant/account

Authentication

Basic HTTP Authentication required.
Encode username:password in Base64 and pass in the Authorization header:

Authorization: Basic {base64(username:password)}

When to use

Use this endpoint to read back the sales and business profile that has been saved for a merchant application. This is useful for displaying a review screen, populating an edit form, or verifying that required fields are complete before submission. The data here corresponds to the information collected in the "Sales & Business Profile" section of the merchant application.

Query Parameters

Response

200 OK

The data object is of type TsysMerchantAccount.

TsysCnpInformation sub-object (present when internet or moto > 0):

{
  "data": {
    "sic": "5812",
    "typeOfOwnership": "Corporation",
    "businessType": "Restaurant",
    "accountType": "C",
    "accountNumber": "12345678901",
    "businessCheckingRoutingNumber": "021000021",
    "achMethod": "Combine",
    "averageTicket": 4500,
    "highTicket": 20000,
    "monthlyVolume": 150000,
    "retail": 90,
    "imprint": 0,
    "moto": 5,
    "internet": 5,
    "bankName": "First National Bank",
    "goodsAndServices": "Full-service restaurant, food and beverages",
    "returnPolicy": "No refunds after meal is served; manager discretion for complaints",
    "nextDayFunding": false,
    "sameDayFunding": false,
    "isVsMcDsNetwork": true,
    "sellingRegulatedSubstances": false,
    "massageServices": false,
    "sellingGasFuel": false,
    "salesToConsumers": 100.0,
    "salesToBusiness": 0.0,
    "salesToGovernment": 0.0,
    "annualVolume": 1800000
  },
  "status": "OK",
  "error": null,
  "warning": null,
  "validationResults": [],
  "requestId": 72318
}

Error Codes

Common Mistakes

• The retail + imprint + moto + internet percentages must sum to 100 when submitting updates — verify this before submission.
• accountNumber must contain only digits (up to 17 characters) — do not include dashes or spaces.
• businessCheckingRoutingNumber must be exactly 9 digits.
• averageTicket and monthlyVolume are in whole dollar amounts (not cents), minimum value is 1.
• annualVolume is a read-only computed field; do not attempt to set it directly.

Related Endpoints

• PUT /api/v1/merchant/account — update the sales and business profile
• GET /api/v1/merchant/parameters — retrieve the merchant's business and owner information
• GET /api/v1/merchant/productSetup — retrieve the merchant's service acceptance/product setup

Example

curl -X GET "https://hq.staging.netevia.dev/api/v1/merchant/account?id=10045" \
  -H "Authorization: Basic $(echo -n 'username:password' | base64)" \
  -H "Accept: application/json"