Update merchant's sales and business profile

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Update Sales and Business Profile

Updates the sales and business profile section of an existing merchant application. This covers the merchant's industry classification (SIC code), ownership structure, bank account details, ACH settlement method, transaction volume estimates, card acceptance mix percentages, and optional card-not-present (CNP) business details for internet or MOTO merchants.

Endpoint

POST /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

Call this endpoint when the merchant's banking information changes, when volume projections need to be updated, or when the business type classification needs to be corrected after initial submission. For internet or mail-order merchants, the cardNotPresentInformation sub-object should be fully populated. The retail/imprint/moto/internet percentages must always sum to 100.

Request Body

FieldTypeRequiredDescription
idinteger (int32)YesMerchant profile ID to update (1–999999).
merchantAccountobjectNoSales and business profile data to update.
merchantAccount.sicstringYes (if merchantAccount provided)4-digit Standard Industry Classification code.
merchantAccount.typeOfOwnershipstringYes (if merchantAccount provided)Business ownership structure. Enum: Corporation, SoleProprietorship, Partnership, AssociationEstateTrust, TaxExempt501C, International, LimitedLiabilityLlc, GovernmentAgency.
merchantAccount.businessTypestringYes (if merchantAccount provided)Business category. Enum: Retail, Restaurant, Internet, MailOrder, Healthcare, Education, B2B, Service, QSR, Supermarket, Petroleum, Utilities, Government, Charity_NonProfit, Lodging, Other.
merchantAccount.accountNumberstringYes (if merchantAccount provided)Bank account number (up to 17 digits).
merchantAccount.businessCheckingRoutingNumberstringYes (if merchantAccount provided)9-digit ABA routing number.
merchantAccount.achMethodstringYes (if merchantAccount provided)ACH batch settlement method. Enum: Combine, Individual.
merchantAccount.averageTicketinteger (int64)Yes (if merchantAccount provided)Average transaction amount in cents (minimum 1).
merchantAccount.monthlyVolumeinteger (int64)Yes (if merchantAccount provided)Expected monthly processing volume in cents (minimum 1).
merchantAccount.retailintegerYes (if merchantAccount provided)Percentage of card-present transactions (0–100).
merchantAccount.imprintintegerYes (if merchantAccount provided)Percentage of imprint transactions (0–100).
merchantAccount.motointegerYes (if merchantAccount provided)Percentage of mail/phone order transactions (0–100).
merchantAccount.internetintegerYes (if merchantAccount provided)Percentage of internet transactions (0–100).
merchantAccount.accountTypestringNoAccount type. Enum: C (Checking), S (Savings), G (Government).
merchantAccount.highTicketintegerNoHighest expected single transaction amount in cents (1–999999).
merchantAccount.salesToConsumersnumberNoPercentage of sales to consumers (0–100).
merchantAccount.salesToBusinessnumberNoPercentage of sales to businesses (0–100).
merchantAccount.salesToGovernmentnumberNoPercentage of sales to government entities (0–100).
merchantAccount.bankNamestringNoName of the merchant's bank.
merchantAccount.goodsAndServicesstringNoDescription of goods or services sold.
merchantAccount.returnPolicystringNoMerchant's refund and return policy description.
merchantAccount.nextDayFundingbooleanNoWhether next-day funding is requested.
merchantAccount.sameDayFundingbooleanNoWhether same-day funding is requested.
merchantAccount.isVsMcDsNetworkbooleanNoWhether the merchant processes on the Visa/MC/Discover network.
merchantAccount.sellingRegulatedSubstancesbooleanNoWhether the merchant sells regulated substances.
merchantAccount.massageServicesbooleanNoWhether the merchant provides massage services.
merchantAccount.sellingGasFuelbooleanNoWhether the merchant sells gas or fuel.
merchantAccount.cardNotPresentInformationobjectNoAdditional details required for CNP/internet merchants.
{
  "id": 10482,
  "merchantAccount": {
    "sic": "5812",
    "typeOfOwnership": "LimitedLiabilityLlc",
    "businessType": "Restaurant",
    "accountNumber": "123456789012",
    "businessCheckingRoutingNumber": "061000104",
    "achMethod": "Combine",
    "averageTicket": 3500,
    "highTicket": 20000,
    "monthlyVolume": 130000,
    "retail": 90,
    "imprint": 0,
    "moto": 5,
    "internet": 5,
    "accountType": "C",
    "bankName": "Bank of America",
    "goodsAndServices": "Full-service restaurant, dine-in and takeout",
    "returnPolicy": "No refunds on food items; merchandise within 30 days with receipt",
    "nextDayFunding": false,
    "sameDayFunding": false,
    "salesToConsumers": 100,
    "salesToBusiness": 0,
    "salesToGovernment": 0
  }
}

Response

200 OK

FieldTypeDescription
dataobjectEmpty object on success.
statusstringHTTP status name (e.g., "OK").
errorstringError message if the update failed; otherwise null.
warningstringNon-fatal warning, if any.
validationResultsarrayField-level validation errors, if any.
requestIdintegerInternal request tracking ID.
{
  "data": {},
  "status": "OK",
  "error": null,
  "warning": null,
  "validationResults": [],
  "requestId": 66140
}

Error Codes

CodeWhen it happens
400id is missing, required merchantAccount fields are absent, or business volume percentages do not sum to 100.
401Invalid or missing Basic Auth credentials.
403User does not have permission to update this merchant's profile.
404No merchant application found with the given ID.
500Internal server error.

Common Mistakes

  • retail + imprint + moto + internet must sum to exactly 100; any other total causes a validation error.
  • businessCheckingRoutingNumber must be exactly 9 digits; leading zeros are significant.
  • accountNumber must contain only digits and be 17 characters or fewer.
  • averageTicket and monthlyVolume are in cents (integer), not dollars — for a $35 average ticket, send 3500.
  • For internet merchants, populating cardNotPresentInformation is expected by underwriters even if the schema marks it optional.

Related Endpoints

  • POST /api/v1/merchant/parameters — Update business and owner information (legal address, federal tax ID, owners).
  • POST /api/v1/merchant/productSetup — Update service acceptance (Amex, Discover, debit, EBT).
  • POST /api/v1/merchant/fees — Update the fee structure.

Example

curl -X POST https://hq.staging.netevia.dev/api/v1/merchant/account \
  -H "Authorization: Basic $(echo -n 'username:password' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 10482,
    "merchantAccount": {
      "sic": "5812",
      "typeOfOwnership": "LimitedLiabilityLlc",
      "businessType": "Restaurant",
      "accountNumber": "123456789012",
      "businessCheckingRoutingNumber": "061000104",
      "achMethod": "Combine",
      "averageTicket": 3500,
      "monthlyVolume": 130000,
      "retail": 90,
      "imprint": 0,
      "moto": 5,
      "internet": 5,
      "bankName": "Bank of America"
    }
  }'
Body Params
merchantAccount
object
int32
required
1 to 999999
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Response

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/json