---
title: "Add Lead (COPY)"
method: POST
path: "/v1/agent-hub/apply/add-lead (COPY)"
---

# Add Lead (COPY)

`POST /v1/agent-hub/apply/add-lead (COPY)`

## Request

- Base URL: `https://testapi.payarc.net`
- URL: `https://testapi.payarc.net/v1/agent-hub/apply/add-lead (COPY)`
- Auth: API key in header `Authorization`

## Request body

- object
  - `Lead` object, required: The company you would like to send to PayArc.
    - `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.
  - `Owners` object[], required: The owners of the company.
    - `Title` 'CEO' | 'Director' | 'Owner' | 'Partner' | 'President' | 'Secretary' | 'Treasurer' | 'Vice President', required: Title of the owner.
    - `FirstName` string, required: First name of the owner.
    - `LastName` string, required: Last name of the owner.
    - `Address` string, required
    - `City` string, required
    - `State` '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
    - `ZipCode` string, required: ZipCode MUST be a valid zip code associated with the state.
    - `PhoneNo` string, required
    - `BirthDate` string, required: <b>Allowed Formats:</b> mm-dd-yyyy, mm-dd-yy, mm/dd/yyyy, mm/dd/yy
    - `SSN` string, required
    - `Email` string, required
    - `OwnershipPct` integer, required
    - `DriverLicenseNo` string
    - `DriverLicenseState` string
  - `BeneficialOwners` object[]: The beneficial owners of the company.
    - `FirstName` string
    - `LastName` string
    - `Title` 'CEO' | 'CFO' | 'Director' | 'Owner' | 'Partner' | 'President' | 'Secretary' | 'Treasurer' | 'VicePresident'
    - `OwnershipPct` string
    - `Address` string
    - `City` string
    - `State` string
    - `Country` string
    - `ZipCode` string
    - `BirthDate` string
    - `SSN` string
    - `OtherIdNo` string
    - `OtherIdCountry` string
    - `OtherIdType` string
    - string
  - `TieredPricing` object: Enter Tiered Pricing data when Discount Program selected is Tiered Pricing.
    - `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
  - `InterchangePlusPricing` object: Enter Interchange Plus Pricing data when Discount Program selected is Interchange Plus.
    - `PricingPctVS` number, double
    - `PricingPctAX` number, double
    - `PricingPctDS` number, double
    - `AuthorizationsVS` number, double
    - `AuthorizationsAX` number, double
    - `AuthorizationsDS` number, double
    - string
  - `BlendedRatePricing` object: Enter Blended Rate data when Discount Program selected is Blended/Bundled Rate.
    - `FlatRatePct` number, double
    - `Authorizations` number, double
    - `CashDiscountRatePct` number, double
    - `CashDiscountFee` number, double
    - `SurchargeFeeRate` number, double
    - `SurchargeFeeAmount` number, double
  - `Questionnaire` object: Questionaire data.
    - `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
  - `MerchantDocuments` object[]: Upload merchant documents (image/pdf) as base 64 endcoded data.
    - `DocumentType` '501C3' | 'Articles of Incorporation' | 'Background Check Report' | 'Business Bank Statement' | 'Business Financials' | 'Business license' | 'Business Tax Return' | 'CBD Product Labels' | 'CBD Regulatory Disclosure' | 'Completed Universal Beneficial Ownership (UBO)' | 'Confirm Business Location' | 'Confirmation Page' | 'Copies of business certificates/articles' | 'Credit Frozen' | 'Credit Report' | 'DL' | 'Driving License or Government ID' | 'EIN' | 'Food Truck Picturez' | 'Fulfillment Agreement' | 'G2 Report' | 'Giact Report' | 'Inventory Photos' | 'Inventory/Fulfillment agreement' | 'Lease Agreement' | 'Lover Care Addendum' | 'MATCH Report' | 'Medical License' | 'Merchant Agreement' | 'Most recent two years CPA prepared financial statements' | 'OFAC Report' | 'Office Lease' | 'Operating Agreement' | 'Other Documentation' | 'Owner Bank Statement' | 'Owner Tax Return' | 'PCI Compliance' | 'PLAID Report' | 'Pricing List' | 'Processing Statement' | 'Proposals' | 'Signed and completed application' | 'Signed Cash Discount' | 'SSN' | 'State SOS' | 'Terminal Setup Questionnaire' | 'TIN Report' | 'TSYS account screenshots' | 'Underwriting Worksheet' | 'Utility Bill' | 'Voided Check/Bank Letter' | 'Website/Marketing Material/Ads': Type of document being added to the system.
    - `DocumentName` string: File name of the document. Must include the file extension and be a valid windows file name.
    - `DocumentDataBase64` string: Base64 encoded string of the binary data that makes up the image or pdf file being uploaded to the system.<br /> Ex. “data:image/png;base64,…..“
  - `AssignedAgentEmail` string: Email address of the agent that brought in the merchant

## Response `200`

200

- object

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `d3ee769894e4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/payarc/apis/payarc-sandbox/changes/v1/agent-hub/apply/add-lead%20%28COPY%29/post.md)

---

[API](https://skmtc.dev/payarc/apis/payarc-sandbox.md) - [All operations](https://skmtc.dev/payarc/apis/payarc-sandbox/llms.txt) - [OpenAPI document](https://skmtc.dev/payarc/apis/payarc-sandbox/revisions/d3ee769894e4?raw)