--- updatedAt: 2026-06-09T17:02:17.000Z --- Fetch the complete documentation index at: https://hq.docs.netevia.com/llms.txt. Use this file to discover all available pages before exploring further. # Update merchant's sales and business profile ## 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 | Field | Type | Required | Description | | --------------------------------------------- | --------------- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | integer (int32) | Yes | Merchant profile ID to update (1–999999). | | merchantAccount | object | No | Sales and business profile data to update. | | merchantAccount.sic | string | Yes (if merchantAccount provided) | 4-digit Standard Industry Classification code. | | merchantAccount.typeOfOwnership | string | Yes (if merchantAccount provided) | Business ownership structure. Enum: `Corporation`, `SoleProprietorship`, `Partnership`, `AssociationEstateTrust`, `TaxExempt501C`, `International`, `LimitedLiabilityLlc`, `GovernmentAgency`. | | merchantAccount.businessType | string | Yes (if merchantAccount provided) | Business category. Enum: `Retail`, `Restaurant`, `Internet`, `MailOrder`, `Healthcare`, `Education`, `B2B`, `Service`, `QSR`, `Supermarket`, `Petroleum`, `Utilities`, `Government`, `Charity_NonProfit`, `Lodging`, `Other`. | | merchantAccount.accountNumber | string | Yes (if merchantAccount provided) | Bank account number (up to 17 digits). | | merchantAccount.businessCheckingRoutingNumber | string | Yes (if merchantAccount provided) | 9-digit ABA routing number. | | merchantAccount.achMethod | string | Yes (if merchantAccount provided) | ACH batch settlement method. Enum: `Combine`, `Individual`. | | merchantAccount.averageTicket | integer (int64) | Yes (if merchantAccount provided) | Average transaction amount in cents (minimum 1). | | merchantAccount.monthlyVolume | integer (int64) | Yes (if merchantAccount provided) | Expected monthly processing volume in cents (minimum 1). | | merchantAccount.retail | integer | Yes (if merchantAccount provided) | Percentage of card-present transactions (0–100). | | merchantAccount.imprint | integer | Yes (if merchantAccount provided) | Percentage of imprint transactions (0–100). | | merchantAccount.moto | integer | Yes (if merchantAccount provided) | Percentage of mail/phone order transactions (0–100). | | merchantAccount.internet | integer | Yes (if merchantAccount provided) | Percentage of internet transactions (0–100). | | merchantAccount.accountType | string | No | Account type. Enum: `C` (Checking), `S` (Savings), `G` (Government). | | merchantAccount.highTicket | integer | No | Highest expected single transaction amount in cents (1–999999). | | merchantAccount.salesToConsumers | number | No | Percentage of sales to consumers (0–100). | | merchantAccount.salesToBusiness | number | No | Percentage of sales to businesses (0–100). | | merchantAccount.salesToGovernment | number | No | Percentage of sales to government entities (0–100). | | merchantAccount.bankName | string | No | Name of the merchant's bank. | | merchantAccount.goodsAndServices | string | No | Description of goods or services sold. | | merchantAccount.returnPolicy | string | No | Merchant's refund and return policy description. | | merchantAccount.nextDayFunding | boolean | No | Whether next-day funding is requested. | | merchantAccount.sameDayFunding | boolean | No | Whether same-day funding is requested. | | merchantAccount.isVsMcDsNetwork | boolean | No | Whether the merchant processes on the Visa/MC/Discover network. | | merchantAccount.sellingRegulatedSubstances | boolean | No | Whether the merchant sells regulated substances. | | merchantAccount.massageServices | boolean | No | Whether the merchant provides massage services. | | merchantAccount.sellingGasFuel | boolean | No | Whether the merchant sells gas or fuel. | | merchantAccount.cardNotPresentInformation | object | No | Additional details required for CNP/internet merchants. | ```json { "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** | Field | Type | Description | | ----------------- | ------- | --------------------------------------------------- | | data | object | Empty object on success. | | status | string | HTTP status name (e.g., `"OK"`). | | error | string | Error message if the update failed; otherwise null. | | warning | string | Non-fatal warning, if any. | | validationResults | array | Field-level validation errors, if any. | | requestId | integer | Internal request tracking ID. | ```json { "data": {}, "status": "OK", "error": null, "warning": null, "validationResults": [], "requestId": 66140 } ``` ### Error Codes | Code | When it happens | | ---- | ---------------------------------------------------------------------------------------------------------------- | | 400 | `id` is missing, required `merchantAccount` fields are absent, or business volume percentages do not sum to 100. | | 401 | Invalid or missing Basic Auth credentials. | | 403 | User does not have permission to update this merchant's profile. | | 404 | No merchant application found with the given ID. | | 500 | Internal 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 ```bash 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" } }' ``` # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "version": "v1", "title": "Netevia HQ | API Documentation", "description": "Netevia HQ | API Documentation" }, "paths": { "/api/v1/merchant/account": { "post": { "tags": [ "Merchant applications/Merchants data management" ], "summary": "Update merchant's sales and business profile", "operationId": "Boarding_UpdateSalesAndBusinessProfile", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateTsysMerchantAccount" } }, "text/json": { "schema": { "$ref": "#/components/schemas/UpdateTsysMerchantAccount" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/UpdateTsysMerchantAccount" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/UpdateTsysMerchantAccount" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/UpdateTsysMerchantAccount" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse1_UpdateMerchantResponse" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ApiResponse1_UpdateMerchantResponse" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ApiResponse1_UpdateMerchantResponse" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ApiResponse1_UpdateMerchantResponse" } } } } } } } }, "security": [ { "Basic": [] } ], "servers": [ { "url": "https://hq.staging.netevia.dev" } ], "components": { "securitySchemes": { "Basic": { "type": "http", "description": "Basic HTTP Authentication", "scheme": "basic" } }, "schemas": { "ValidationResult": { "type": "object", "properties": { "memberNames": { "type": "array", "items": { "type": "string" }, "readOnly": true }, "errorMessage": { "type": "string" } } }, "TsysMerchantAccount": { "required": [ "sic", "typeOfOwnership", "businessType", "accountNumber", "businessCheckingRoutingNumber", "achMethod", "averageTicket", "monthlyVolume", "retail", "imprint", "moto", "internet" ], "type": "object", "properties": { "sic": { "type": "string" }, "sellingRegulatedSubstances": { "type": "boolean" }, "massageServices": { "type": "boolean" }, "sellingGasFuel": { "type": "boolean" }, "typeOfOwnership": { "enum": [ "Corporation", "SoleProprietorship", "Partnership", "AssociationEstateTrust", "TaxExempt501C", "International", "LimitedLiabilityLlc", "GovernmentAgency" ], "type": "string" }, "businessType": { "enum": [ "Other", "Internet", "Lodging", "MailOrder", "Restaurant", "Retail", "QSR", "Supermarket", "Petroleum", "Utilities", "Healthcare", "Education", "Government", "Charity_NonProfit", "B2B", "Service" ], "type": "string" }, "accountType": { "enum": [ "C", "S", "G" ], "type": "string" }, "accountNumber": { "maxLength": 17, "minLength": 0, "pattern": "^\\d*$", "type": "string" }, "businessCheckingRoutingNumber": { "pattern": "^\\d{9}$", "type": "string" }, "achMethod": { "enum": [ "Combine", "Deposit", "CombineAndDeposit" ], "type": "string" }, "averageTicket": { "format": "int64", "minimum": 1, "type": "integer" }, "highTicket": { "format": "int32", "maximum": 999999, "minimum": 1, "type": "integer" }, "salesToConsumers": { "format": "double", "maximum": 100, "minimum": 0, "type": "number" }, "salesToBusiness": { "format": "double", "maximum": 100, "minimum": 0, "type": "number" }, "salesToGovernment": { "format": "double", "maximum": 100, "minimum": 0, "type": "number" }, "bankName": { "type": "string" }, "goodsAndServices": { "type": "string" }, "returnPolicy": { "type": "string" }, "nextDayFunding": { "type": "boolean" }, "sameDayFunding": { "type": "boolean" }, "isVsMcDsNetwork": { "type": "boolean" }, "monthlyVolume": { "format": "int64", "minimum": 1, "type": "integer" }, "annualVolume": { "format": "int64", "minimum": 1, "type": "integer", "readOnly": true }, "retail": { "format": "int32", "maximum": 100, "minimum": 0, "type": "integer" }, "imprint": { "format": "int32", "maximum": 100, "minimum": 0, "type": "integer" }, "moto": { "format": "int32", "maximum": 100, "minimum": 0, "type": "integer" }, "internet": { "format": "int32", "maximum": 100, "minimum": 0, "type": "integer" }, "cardNotPresentInformation": { "$ref": "#/components/schemas/TsysCnpInformation" } } }, "TsysCnpInformation": { "type": "object", "properties": { "isWebHosting": { "type": "boolean" }, "isDomainRegistration": { "type": "boolean" }, "isWebPageDesign": { "type": "boolean" }, "isAuction": { "type": "boolean" }, "isInternetServiceGateway": { "type": "boolean" }, "isSellingDigitalService": { "type": "boolean" }, "isAdvertisement": { "type": "boolean" }, "isSellingHardGoods": { "type": "boolean" }, "isOther": { "type": "boolean" }, "otherInternetBusinessType": { "type": "string" }, "advertiseOrPromotion": { "type": "string" }, "secureTransactionInformation": { "type": "string" }, "vendors": { "type": "string" }, "productFulfillment": { "type": "string" }, "saleDescription": { "type": "string" }, "monthly": { "format": "int32", "type": "integer" }, "yearly": { "format": "int32", "type": "integer" }, "quarterly": { "format": "int32", "type": "integer" }, "oneTime": { "format": "int32", "type": "integer" }, "hourly": { "format": "int32", "type": "integer" }, "isMonthly": { "type": "boolean" }, "isYearly": { "type": "boolean" }, "isQuarterly": { "type": "boolean" }, "isOneTime": { "type": "boolean" }, "isHourly": { "type": "boolean" } } }, "ApiResponse1_UpdateMerchantResponse": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/UpdateMerchantResponse" }, "status": { "enum": [ "Continue", "SwitchingProtocols", "OK", "Created", "Accepted", "NonAuthoritativeInformation", "NoContent", "ResetContent", "PartialContent", "MultipleChoices", "Ambiguous", "MovedPermanently", "Moved", "Found", "Redirect", "SeeOther", "RedirectMethod", "NotModified", "UseProxy", "Unused", "TemporaryRedirect", "RedirectKeepVerb", "BadRequest", "Unauthorized", "PaymentRequired", "Forbidden", "NotFound", "MethodNotAllowed", "NotAcceptable", "ProxyAuthenticationRequired", "RequestTimeout", "Conflict", "Gone", "LengthRequired", "PreconditionFailed", "RequestEntityTooLarge", "RequestUriTooLong", "UnsupportedMediaType", "RequestedRangeNotSatisfiable", "ExpectationFailed", "UpgradeRequired", "InternalServerError", "NotImplemented", "BadGateway", "ServiceUnavailable", "GatewayTimeout", "HttpVersionNotSupported" ], "type": "string" }, "error": { "type": "string" }, "warning": { "type": "string" }, "validationResults": { "type": "array", "items": { "$ref": "#/components/schemas/ValidationResult" } }, "requestId": { "format": "int32", "type": "integer" } } }, "UpdateMerchantResponse": { "type": "object", "properties": {} }, "UpdateTsysMerchantAccount": { "required": [ "id" ], "type": "object", "properties": { "merchantAccount": { "$ref": "#/components/schemas/TsysMerchantAccount" }, "id": { "format": "int32", "maximum": 999999, "minimum": 1, "type": "integer" } } } } } } ```