--- title: "Update Traditional Lead" method: PATCH path: "/v1/agent-hub/apply/lead/{id}/" --- # Update Traditional Lead `PATCH /v1/agent-hub/apply/lead/{id}/` ## Path parameters - `id` string, required ## Request body - object - `Lead` object - `MerchantName` string, required — Name of the merchant. - `ContactFirstName` string, required - `ContactLastName` string, required - `ContactEmail` string, required - `DiscountRateProgram` 'tiered' | 'interchange' | 'bundleRate', required - `Industry` 'nutra' | 'cloud-based-storage-internet-provider-tech-support' | 'money_transfer_msb' | 'medical-dental-device-sales' | 'general-retail-rest-low-risk' | 'smokeshope-cbd' | 'hemp-hemp-derived-CBD-paraphernalia-supplement' | 'card-present-firearms-CNP-b-2-b-firearms' | 'gadget' | 'digital-goods-marketplace-nontravel' | 'marijuana-marketing' | 'other_high_risk' | 'consumer-lending' | 'debt-relief-mobile-payment-application-short-term-lender' | 'timeshare-sales' | 'online-dating' | 'document_prep_services' | 'credit_repair' | 'debt-collection' | 'seo' | 'business_ops_consutling' | 'idtheft_addresschange_visapassportservice-personal-credit-protection-warranties' | 'deferred-delivery-multilevel-marketing' | 'online-gaming' | 'telemedicine-services' | 'charitable-crowd-funding' | 'medical-plan-discount' | 'discount-membership', required — All options are listed here: https://docs.payarc.net/v1.1.0/docs/industry_codes_trad - `LegalName` string, required — Legal name of the merchant. - `OfficeAddress` string, required — Office address of the merchant. - `OfficeCity` string, required — Office city of the merchant. - `OfficeState` 'AR' | 'AS' | 'AZ' | 'CA' | 'CO' | 'CT' | 'DC' | 'DE' | 'FL' | 'FM' | 'GA' | 'GU' | 'HI' | 'IA' | 'ID' | 'IL' | 'IN' | 'KS' | 'KY' | 'LA' | 'MA' | 'MD' | 'ME' | 'MH' | 'MI' | 'MN' | 'MO' | 'MP' | 'MS' | 'MT' | 'NC' | 'ND' | 'NE' | 'NH' | 'NJ' | 'NM' | 'NV' | 'NY' | 'OH' | 'OK' | 'OR' | 'PA' | 'PR' | 'PW' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VA' | 'VI' | 'VT' | 'WA' | 'WI' | 'WV' | 'WY', required — Office state of the merchant. - `OfficeZipCode` string, required — Zip code. - `RegisteredAddress` string, required - `RegisteredCity` string, required - `RegisteredState` 'AR' | 'AS' | 'AZ' | 'CA' | 'CO' | 'CT' | 'DC' | 'DE' | 'FL' | 'FM' | 'GA' | 'GU' | 'HI' | 'IA' | 'ID' | 'IL' | 'IN' | 'KS' | 'KY' | 'LA' | 'MA' | 'MD' | 'ME' | 'MH' | 'MI' | 'MN' | 'MO' | 'MP' | 'MS' | 'MT' | 'NC' | 'ND' | 'NE' | 'NH' | 'NJ' | 'NM' | 'NV' | 'NY' | 'OH' | 'OK' | 'OR' | 'PA' | 'PR' | 'PW' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VA' | 'VI' | 'VT' | 'WA' | 'WI' | 'WV' | 'WY', required - `RegisteredZipCode` string, required - `ContactPhoneNo` string, required — ex: "9966882211" - `TaxId` string, required — ex: 123456789 - `DateIncorporated` string, date, required - `StateOfIncorporation` 'AR' | 'AS' | 'AZ' | 'CA' | 'CO' | 'CT' | 'DC' | 'DE' | 'FL' | 'FM' | 'GA' | 'GU' | 'HI' | 'IA' | 'ID' | 'IL' | 'IN' | 'KS' | 'KY' | 'LA' | 'MA' | 'MD' | 'ME' | 'MH' | 'MI' | 'MN' | 'MO' | 'MP' | 'MS' | 'MT' | 'NC' | 'ND' | 'NE' | 'NH' | 'NJ' | 'NM' | 'NV' | 'NY' | 'OH' | 'OK' | 'OR' | 'PA' | 'PR' | 'PW' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VA' | 'VI' | 'VT' | 'WA' | 'WI' | 'WV' | 'WY', required - `OwnershipType` 'sole_prop' | 'private_corp' | 'llc' | 'partnership' | 'public_corporation' | 'government' | 'non_profit', required - `CustomerSupportNumber` string, required - `BusinessSummary` string, required - `BankAccountNo` string, required - `BankRoutingNo` string, required - `Website` string - `AccountUpdater` number, double - `MinMonthlyFee` number, double - `MonthlyFee` number, double - `PosFee` number, double - `PciFee` number, double - `TerminalFee` number, double - `GatewayFee` number, double - `StatementFee` number, double - `RiskAnalysisFee` number, double - `WebMonitoringFee` number, double - `BankSponsorFee` number, double - `AmexSponsorFee` number, double - `BatchFee` number, double - `ChargebackFee` number, double - `ChargebackReversalFee` number, double - `RetrievalFee` number, double - `ArbitrationFee` number, double - `VoiceAuthFee` number, double - `DebitCardAuthsFee` number, double - `EbtAuthsFee` number, double - `AccountUpdateOtherFee` number, double - `GatewayTranactionsFee` number, double - `PerAchRejectFee` number, double - `DeclinesFee` number, double - `RefundsFee` number, double - `AvsFee` number, double - `EthocaVerifiAlertsFee` number, double - `RapidDisputeResolutionFee` number, double - `CurrentyAcceptCreditCards` number, double - `CardPresentPct` integer — CardPresentPct + MotoPct must equal to 100 - `MotoPct` integer — MotoPct + CardPresentPct must equal to 100 - `TotalMonthlyProcessing` number, double - `AvgTicketValue` number, double - `HighTicketValue` number, double - `DesiredDescriptor` string - `EbtFnsNumber` string - `ProcessingTerminated` boolean - `PersonalOrBusiness` 'Personal' | 'Business' - `Bankruptcy` boolean - `BankruptcyType` 'Personal' | 'Business' - `AmexProcessingPerYear` number, double - `OtherFee` number, double - `OtherFeeName` string - `CommentsOther` string - `MonthlyOtherFee` number, double - `MonthlyOtherFeeName` string - `AmexEsaNumber` string - `DriverLicenseOrId` string - `NotProcessingInfo` string - `RiskLevel` 'LowRisk' | 'MidRisk' | 'HighRisk' - `AdditionalComments` string — Free text coments max 254 chars - `SameDayFunding` 'yes' | 'no' — if the day must be same day - `timeZoneDiff` 'est' | 'cst' | 'mst' | 'pst' | 'ast' | 'hst' — Time Zone - `MerchantPciFeeYearly` number, double - `MerchantAnnualFee` number, double - `MerchantDebitAccess` number, double - `MerchantBreachProtectionFee` number, double - `MerchantSameDayFundingRate` number, double — % - `MerchantWirelessFee` number, double - `MerchantResidualTemplates` string — Specifies the agent rep code used to determine the residual schedule applied to the merchant account. - `BlendedRatePricing` object - `FlatRatePct` number, double - `Authorizations` number, double - `CashDiscountRatePct` number, double - `CashDiscountFee` number, double - `SurchargeFeeRate` number, double - `SurchargeFeeAmount` number, double - `TieredPricing` object - `QualifiedPctVS` number, double - `QualifiedPctAX` number, double - `QualifiedPctDS` number, double - `QualifiedPctDB` number, double - `MidQualifiedPctVS` number, double - `MidQualifiedPctAX` number, double - `MidQualifiedPctDS` number, double - `MidQualifiedPctDB` number, double - `NonQualifiedPctVS` number, double - `NonQualifiedPctAX` number, double - `NonQualifiedPctDS` number, double - `NonQualifiedPctDB` number, double - `QualifiedAuthVS` number, double - `QualifiedAuthAX` number, double - `QualifiedAuthDS` number, double - `QualifiedAuthDB` number, double - `MidQualifiedAuthVS` number, double - `MidQualifiedAuthAX` number, double - `MidQualifiedAuthDS` number, double - `MidQualifiedAuthDB` number, double - `NonQualifiedAuthVS` number, double - `NonQualifiedAuthAX` number, double - `NonQualifiedAuthDS` number, double - `NonQualifiedAuthDB` number, double - `Owners` object — Passing this object will cause the whole owners field to be overwritten. - `WebsitePayments` 'No' | 'Yes' | 'NoWebSite' - `SSLProvider` string - `ProdSoldNorthAmericaPct` integer - `ProdSoldEuropePct` integer - `ProdSoldOtherMarketsPct` integer - `SellBusinessPct` integer - `SellConsumerPct` integer - `ReturnPolicy` 'GreaterThan30Days' | 'LessThan30Days' | 'NoReturns' | 'OtherReason' - `NoRefundsInfo` string - `ReturnPolicyOther` string - `MonthlyRefundsPct` integer - `RefundDays` integer - `Refund100Pct` boolean - `RefundLess100PctInfo` string - `WhenIsCustomerCharged` 'ShipmentOrCompletionOfService' | 'Order' - `IsShipmentTraceable` boolean - `IsDeliveryReceiptRequested` boolean - `OrderTurnaroundTime` integer - `AdvancedDeposits` boolean - `DepositPct` integer - `DepositAmt` number, double - `WarehouseAddress` string - `WarehouseCity` string - `WarehouseState` string - `WarehouseCountry` string - `WarehouseZipCode` string - `OwnProductAtTimeOfSale` boolean - `OtherCompaniesInvolved` boolean - `OtherCompaniesInvolvedInfo` string - `AdvertiseInfo` string - `WhoEntersCardInfo` 'Consumer' | 'FulfillmentCenter' | 'Merchant' - `IsProcessingSeasonal` boolean - `ProcessingSeasonalMonth1` boolean - `ProcessingSeasonalMonth2` boolean - `ProcessingSeasonalMonth3` boolean - `ProcessingSeasonalMonth4` boolean - `ProcessingSeasonalMonth5` boolean - `ProcessingSeasonalMonth6` boolean - `ProcessingSeasonalMonth7` boolean - `ProcessingSeasonalMonth8` boolean - `ProcessingSeasonalMonth9` boolean - `ProcessingSeasonalMonth10` boolean - `ProcessingSeasonalMonth11` boolean - `ProcessingSeasonalMonth12` boolean - `MembershipPayments` boolean - `MembershipPaymentsPct` number, double - `PackageUsageTime` integer - `WhoManagesRecurringPayments` 'PayArcsVaultModule' | 'Other' - `RecurringPaymentProvider` string - `CaptureAVS` boolean - `CaptureAVSAction` 'Decline' | 'SendResponse' - `CaptureCVV` boolean - `PerformVerifiedByVisa` boolean - `DoPayArcFraudCheck` boolean - string - `InterchangePlusPricing` object - `PricingPctVS` number, double - `PricingPctAX` number, double - `PricingPctDS` number, double - `AuthorizationsVS` number, double - `AuthorizationsAX` number, double - `AuthorizationsDS` number, double - string - `Questionnaire` object - `WebsitePayments` 'No' | 'Yes' | 'NoWebSite' - `SSLProvider` string - `ProdSoldNorthAmericaPct` integer - `ProdSoldEuropePct` integer - `ProdSoldOtherMarketsPct` integer - `SellBusinessPct` integer - `SellConsumerPct` integer - `ReturnPolicy` 'GreaterThan30Days' | 'LessThan30Days' | 'NoReturns' | 'OtherReason' - `NoRefundsInfo` string - `ReturnPolicyOther` string - `MonthlyRefundsPct` integer - `RefundDays` integer - `Refund100Pct` boolean - `RefundLess100PctInfo` string - `WhenIsCustomerCharged` 'ShipmentOrCompletionOfService' | 'Order' - `IsShipmentTraceable` boolean - `IsDeliveryReceiptRequested` boolean - `OrderTurnaroundTime` integer - `AdvancedDeposits` boolean - `DepositPct` integer - `DepositAmt` number, double - `WarehouseAddress` string - `WarehouseCity` string - `WarehouseState` string - `WarehouseCountry` string - `WarehouseZipCode` string - `OwnProductAtTimeOfSale` boolean - `OtherCompaniesInvolved` boolean - `OtherCompaniesInvolvedInfo` string - `AdvertiseInfo` string - `WhoEntersCardInfo` 'Consumer' | 'FulfillmentCenter' | 'Merchant' - `IsProcessingSeasonal` boolean - `ProcessingSeasonalMonth1` boolean - `ProcessingSeasonalMonth2` boolean - `ProcessingSeasonalMonth3` boolean - `ProcessingSeasonalMonth4` boolean - `ProcessingSeasonalMonth5` boolean - `ProcessingSeasonalMonth6` boolean - `ProcessingSeasonalMonth7` boolean - `ProcessingSeasonalMonth8` boolean - `ProcessingSeasonalMonth9` boolean - `ProcessingSeasonalMonth10` boolean - `ProcessingSeasonalMonth11` boolean - `ProcessingSeasonalMonth12` boolean - `MembershipPayments` boolean - `MembershipPaymentsPct` number, double - `PackageUsageTime` integer - `WhoManagesRecurringPayments` 'PayArcsVaultModule' | 'Other' - `RecurringPaymentProvider` string - `CaptureAVS` boolean - `CaptureAVSAction` 'Decline' | 'SendResponse' - `CaptureCVV` boolean - `PerformVerifiedByVisa` boolean - `DoPayArcFraudCheck` boolean - string - `TSQuestionery` object - `MerchantCurvPos` integer, required — Responsible for indicating if the merchant will use Curv tools or not. If CURV tools are not needed set 0. - `TerminalType` string[], required — with 0..2 items one is "emv" other is “3rdParty” this parameter allows you to select the type of the terminal to be used. If “3rdParty” makes sense to use “TerminalType3rdParty” of type string with max 256 chars as description of the terminal type. - `TerminalGatewaySetup` string, required — values “payarc” or “agent” indicates who is in charge to set-up the gateway. - `TerminalGateway` string, required — Values “ePay”, “nmi”, “payarc” and “authorize.net”. It is used to set the way terminal is comunicating. In case you must set USAePay you have to use value “ePay” as well not mandatory comment in “TerminalGatewayUSAePay“ of type string max 254 chars. - `TerminalPinDebit` string, required — with values ‘yes’, ‘no’ is responsible for Pin-debit Enabled (Customer will have to enter PIN) if set to ‘yes’. - `TerminalEbtFns` string, required — with values “yes”, “no”, if set to “yes” the the EBT number mist be provide in attribute “MerchantEbtFnsNumber” of type string max 254. - `TerminalPrimaryMethod` string, required — with values “wifi”, “ethernet” or “4g” determines the physical connection of a terminal. - `TerminalEmvQuantity` object — JSON object used to enumerate the physical devices. This object could have following attributes: "dejavoo", "dejavoo", "pax" representing the maker of the terminal, those attributes are JSON object as well consisting of attributes equal to the model of the terminal. Those attributes are int values that indicates the quantity of the teminals - `dejavoo` object — Maker of the terminal - `qd2` integer — Model - `qd3` integer — Model - `qd2wifi` integer — Model - `qd4` integer — Model - `qd5` integer — Model - `z11` integer — Model - `z8` integer — Model - `z9` integer — Model - `mobileReaders` object — Maker of the terminal - `b250` integer — Model - `bbpos` integer — Model - `idynamo5` integer — Model - `pax` object — Maker of the terminal - `a80` integer — Model - `a920` integer — Model - `a920pro` integer — Model - `sp30` integer — Model - `sp300` integer — Model - `TerminalPaxPos` string, required — with values “payarc”, “SwipeSimple”, “TSYSTransit” and “TSYSSierra” is responsible for pax pos method. - `TerminalDejavooPosDebit` string, required — with values “retail” and “restaurant” is responsible for debit type of dejavoo terminal - `TerminalDejavooPosCash` string, required — with values “retail” and “restaurant” is responsible for cash type of dejavoo terminal - `TerminalDejavooPosGift` string, required — with values “retail”, “valutec”, “gift” and “restaurant” is responsible for cash type of dejavoo terminal. If value is gift it is possible to add additional information as string max 254 for the following attributes: “TerminalDejavooPosGiftCid”, “TerminalDejavooPosGiftIAuth”, “TerminalDejavooPosGiftIPass”, “TerminalDejavooPosGiftLid”, “TerminalDejavooPosGiftTId” - `TerminalBatchAutoClose` string, required — with values “yes” and “no” is indicating the day closure batch. in case “no”, you will manually batch out every day. (WARNING: this may cause lost batches). In case of “yes” you have to specify the HH:MM when this will happen in attribute “TerminalBatchAutoTime”. - `TerminalOptionTip` string — with values “no”, “tips”, “both” and “custom” is responsible for allowing customers to leave tips. In case “custom” is selected it will be an empty line for the tip, if “both” also add suggested tip amounts (i.e., 15% = $##.##, 18%=$##.##, 20% = $##.##). If “tips” at time of sale with suggested tip amounts (i.e., 15% = $##.##, 18%=$##.##, 20%=$##.##), and= if “no” no tips are allowed. - `TerminalTrackClerks` string, required — with values “yes” and “no” will allow you to track servers/clerks that check out guests. - `TerminalOptionInvoice` string, required — with values “yes” and “no” give you ability to enter Invoice or Order numbers. - `TerminalOptionTax` string, required — with values “yes” and “no” allows you to add tax to the amount, tax could be city and state tax. Amounts are set with additional attributes “TerminalStateTaxPct” and “TerminalCityTaxPct”. - `TerminalCityTaxPct` number, float, required — with min 0.00 max 100.00 is representing the % of the city tax. - `TerminalStateTaxPct` number, float, required — with min 0.00 max 100.00 is representing the % of the state tax - `TerminalOptionSignature` string, required — with values “yes” and “no” is responsible for signature line in the receipt. - `TerminalHeader` string — max 50 chars is responsible for specific text in the header of the receipt. If no specific header is needed omit this property in the flow. - `TerminalFooter` string — max 50 chars is responsible for specific text in the footer of the receipt. If no specific footer is needed omit this property in the flow. - `TerminalDeployment` string, required — with values “agent”, “merchant” and “other” is responsible for indicating how the terminal will be delivered to merchant. If agent is selected the terminal(s) will be sent to agent's address if merchant is selected the terminal(s) will be sent to merchant's address. If other is selected the terminal will be sent to address compound of the following attributes: “TerminalShippingName”, “TerminalShippingContactName”, “TerminalShippingAddress”, “TerminalShippingCity” “TerminalShippingState”, “TerminalShippingZipCode”, “TerminalShippingPhoneNo” - `TerminalShippingName` string — max 50 chars is the addressee's name - `TerminalShippingContactName` string — max 100 chars is the addressee's contact name - `TerminalShippingAddress` string — max 32 chars is the address line 1 - `TerminalShippingCity` string — max 13 chars is the destination city - `TerminalShippingState` string — max 2 chars is the state code, upper case - `TerminalShippingZipCode` string — max 6 chars is the zip code - `TerminalShippingPhoneNo` string — max 10 digits is the addressee’s phone. - `TerminalShippingPreferred` string — with values “ground” “2ndDay” and “saturday” is to determine Fedex Preferred Shipping mode. - `TerminalComments` string — max 254chars is responsble for additional comments you might need to add to terminal questionary ## Response `200` 200 - object - `data` object - `object` string - `id` string - `name` string - `industry` string - `isv_merchant_type` unknown - `isv_process_own_transactions` unknown - `merchant_category` unknown - `hubspot_record_id` unknown - `bank_account_type` unknown - `agent_name` string - `apply_pricing_template_id` unknown - `apply_pricing_template_name` string - `step` unknown - `is_copied` integer - `created_at` string - `updated_at` string - `status` string - `completed` integer - `lead_status` unknown - `status_id` integer - `signature_override` integer - `meta` object - `include` unknown[] - unknown - `custom` unknown[] - unknown ## Other responses - `422` — 422 --- [API](https://skmtc.net/payarc/apis/payarc-sandbox.md) · [All operations](https://skmtc.net/payarc/apis/payarc-sandbox/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payarc/payarc-sandbox/revisions/face82bdd778/schema)