Lead

Parameter

Description

MerchantSSN Required for Payfac

Merchant Social Security Number
Format: Numeric, Length: 9

  • Example_:456456789

SalesAnnualMastercard
Required for Payfac

Total Number of current/estimated Annual Sales for Master Card
Format: Numeric

  • Example_:10000

SalesDeliveryOffer
Required for Payfac

Does the merchant offer delivery?
Format: String, Allowable Values: Yes, No

  • Example_:Yes

SalesDeliveryDays
Required for Payfac

Average Number of days for delivery
Whole number

SalesDeliveryDays0Pct
Required for Payfac

% of deliveries that are received in 0 days
Format: Numeric, Value: 0-100

  • Example_: 90

SalesDeliveryDays1Pct
Required for Payfac

% of deliveries that are received in 1 days
Format: Numeric, Value: 0-100

  • Example_: 10

SalesDeliveryDays8Pct
Required for Payfac

% of deliveries that are received in 8 days
Format: Numeric, Value: 0-100

  • Example_: 0

SalesDeliveryDays15Pct
Required for Payfac

% of deliveries that are received in 15 days
Format: Numeric, Value: 0-100

  • Example_: 0

SalesDeliveryDays30Pct
Required for Payfac

% of deliveries that are received in 30 days
Format: Numeric, Value: 0-100

  • Example_: 0

SalesKeyedInternetPct
Required for Payfac

% of Card Not Present sales that are keyed/internet
Format: Numeric, Value: 0-100

  • Example_: 60

SalesKeyedMailPct
Required for Payfac

% of Card Not Present sales that are mail
Format: Numeric, Value: 0-100

  • Example_: 33

SalesKeyedPhonePct
Required for Payfac

% of Card Not Present sales that are phone
Format: Numeric, Value: 0-100

  • Example_: 7

SalesTradeshowPct
Required for Payfac

% of sales from trade shows
Format: Numeric, Value: 0-100

  • Example_: 0

SalesTotalAnnual
Required for Payfac

Total sales, including card and cash annually
Format: Numeric

  • Example_: 500000.00 (decimals should be added to show cents)

SalesB2BPct
Required for Payfac

% of total sales B2B (Business to Business)
Format: Numeric, Value: 0-100

  • Example_: 33

SalesB2CPct
Required for Payfac

% of total sales B2C (Business to Consumer)
Format: Numeric, Value: 0-100

  • Example_: 67

SalesCardB2BPct
Required for Payfac

% of card sales B2B (Business to Business)
Format: Numeric, Value: 0-100

  • Example_: 34

SalesCardB2CPct
Required for Payfac

% of card sales B2C (Business to Consumer)
Format: Numeric, Value: 0-100

  • Example_: 66

SalesProductServices
Required for Payfac

Description of services sold by the merchant
Format: String, Length 5 - 500

  • Example_: Bakery

MerchantBankName
Required for Payfac

Name of the bank the merchant will use
Format: String, Length 50

MerchantAccountAddress
Required for Payfac

Address on file for the bank account the merchant is using. It should include Address Line 1 and Line 2
Format: String, Length 1-32

  • Example_: 559 Timber Ridge Road

MerchantAccountCity
Required for Payfac

Address on file for the bank account the merchant is using
Format: String, Length 1-13

  • Example_: Sacramento

MerchantAccountState
Required for Payfac

Address on file for the bank account the merchant is using
Format: String, Length 2

  • Example_: CA

MerchantZipCode
Required for Payfac

Address on file for the bank account the merchant is using
Format: String, Length 5-9

  • Example_: 95814

ProcessingType
Optional

To determine TSYS or Fiserv processor. If not passed, it will default to TSYS.
In order to create a Fiserv lead, you can pass Payfac or fiserv

Industry
Required

Industry the merchant that is applying is related to
Values: Business_ops_consulting, Consumer_lending, Credit_repair, Digital_goods, Discount_membership, Document_prep_services, Gadget, General_retail_service_restaurant, Idtheft_addresschange_visapassportservice, Marketplace_nontravel, Money_transfer_msb, Nutra, Online_dating, Online_gaming, Other_high_risk, Personal_credit_protections, Smoke_shop_cbd, warranties

  • Example_:Consumer_lending

MerchantName
Required

DoingBusinessAs name of the merchant that the application is going to
Format: String, Length 1-25

  • Example_: John's Toy Store

LegalName
Required

Legal name of the merchant that the application is going to (DBA Name and Legal name can be the same)
Format: String, Length 1-32

  • Example_: Greenwich Toys LLC

OfficeAddress
Required

Physical address for the merchant. This should include Adress Line 1 and Line 2
Format: String, Length 1-32

  • Example_: 237 West St

OfficeCity
Required

Physical address city.
Format: String, Length 1-13

  • Example_: Stone Mountain

Country
Required for Payfac

Physical address country. Required for Payfac, optional for ISO where it defaults to US.
Format: String, 2-Character Alpha Country Code

  • Example_:US

OfficeState
Required

Physical address state.
Format: String, Length 2

  • Example_:CA

OfficeZipCode
Required

Physical address zipcode.
Format: String, Length 5-9

  • Example_:06830

RegisteredAddress
Required

Legal address for the merchant. This should include Adress Line 1 and Line 2
Format: String, Length 1-32

  • Example_: 237 West St

RegisteredCity
Required

Legal address city.
Format: String, Length 1-13

  • Example_:Stone Mountain

RegisteredState
Required

Legal address state.
Format: String, Length 2

  • Example_:CA

RegisteredZipCode
Required

Legal address zipcode.
Format: String, Length 5-9

  • Example_:95814

ContactFirstName
Required

First name of the merchant contact that will receive the application.
Format: String, Length 1-50

  • Example_:John

ContactLastName
Required

Last name of the merchant contact that will receive the application.
Format: String, Length 1-50

  • Example_:Smith

ContactPhoneNo
Required

Phone number of the merchant contact that will receive the application.
Format: String, Length 10-10

  • Example_:5557895623

ContactEmail
Required

Email of the merchant contact that will receive the application.
Format: String, Length 5 - 75

TaxID
Required

TAX ID for the merchant that is apply for payment processing.
Format: Numeric, 9 digits

  • Example_:456987896

MerchantOtherTaxId
Required for Payfac

If other TAX ID is selected this is where they input that information (Identification Number type)
Format: Numeric, 9 digits

  • Example_:456987896

DateIncorporated
Required

Date in which the merchant that is apply was incorporated.
Format: Date (YYYY-MM-DD)

  • Example_:2023-02-03

StateofIncorporation
Required

2-character code state the merchant that is apply was incorporated in
Format: String, Length 2

  • Example_:CA

SicMccCode
Optional

MCC Code related to the merchant.
Format: Numeric 4, Max: 4

  • Example_:8099

OwnershipType
Required

Ownership type of the merchant that is applying for payment processing.
Values: Government, LLC, Non Profit, Partnership, Private Corp, Public Corp, Sole Prop

  • Example_:LLC

IrsFilingType
Required for Payfac

This is the IRS filing type (tax exempt, etc.) the merchant is set up as.
A: Foreign Entity Verification Pending
B: Foreign Entity Identified before 1/1/11
C: Non Profit Verified
D: Non Profit Verification Pending
F: Foreign Entity Verified
G: Government Entity
J: Financial Institution
N: Not Excluded
Format: String, Length 1

  • Example_: C

IdentificationNumberType
Required for Payfac

Type of identification number
For Sole Proprietor, you can only use SSN.
1: SSN
2: EIN
3: Other Tax ID
Format: Numeric, Length 1

FoundationDate
Required for Payfac

Date the merchant company was founded
Format: Date (YYYY-MM-DD)

Website
Optional

Merchant’s website.
Format: String, Length 0 - 60

  • Example_:merchantname.com

CustomerSupportNumber
Required

Phone number of the merchant’s customer support.
Format: String, Length 10 - 15

  • Example_:5557895623

BusinessSummary
Required

High-level business summary of what the merchant does
Format: String, Length 5 - 500

  • Example_:

DiscountRateProgram
Required

Pricing model that will be selected and applied to this merchant.
Values: Interchange, Tiered, bundleRate

  • Example_:bundleRate

AccountUpdater
Optional

Account updater transaction fee. This is a flat fee ($ amount)
Format: Numeric 0 - 100

  • Example_:3.05 (decimals should be added to show cents)

MonthlyFee
Required

Monthly fee charged to the merchant. This is a flat fee ($ amount)
Format: Numeric 0 - 5000

  • Example_:3.05 (decimals should be added to show cents)

MinMonthlyFee
Optional

Monthly minimum fee. This is a flat fee ($ amount)
Format: Numeric 0 - 5000

  • Example_:3.05 (decimals should be added to show cents)

PosFee
Optional

POS fee. This is a flat fee ($ amount)
Format: Numeric 0 - 5000

  • Example_:3.05 (decimals should be added to show cents)

PciFee
Optional

POS fee. This is a flat fee ($ amount)
Format: Numeric 0 - 500

  • Example_:3.05 (decimals should be added to show cents)

TerminalFee
Optional

Terminal fee. This is a flat fee ($ amount)
Format: Numeric 0 - 5000

  • Example_:3.05 (decimals should be added to show cents)

OnlineReportingFee
Optional

Online Reporting fee. This is a flat fee ($ amount)
Format: Numeric 0 - 5000

  • Example_:3.05 (decimals should be added to show cents)

GatewayFee
Optional

Gateway fee. This is a flat fee ($ amount)
Format: Numeric 0 - 500

  • Example_:3.05 (decimals should be added to show cents)

StatementFee
Optional

Statement fee. This is a flat fee ($ amount)
Format: Numeric 0 - 500

  • Example_:3.05 (decimals should be added to show cents)

RiskAnalysisFee
Optional

Risk Analysis fee. This is a flat fee ($ amount)
Format: Numeric 0 - 500

  • Example_:3.05 (decimals should be added to show cents)

WebMonitoringFee
Optional

Web Monitoring fee. This is a flat fee ($ amount)
Format: Numeric 0 - 500

  • Example_:3.05 (decimals should be added to show cents)

BankSponsorFee
Optional

Bank Sponsor fee. This is a percentage fee (% amount)
Format: Numeric 0 - 20

  • Example_:3.05 (decimals should be added to show cents)

AmexSponsorFee
Required

Amex Sponsor fee. This is a percentage fee (% amount)
Format: Numeric 0 - 20

  • Example_:3.05 (decimals should be added to show cents)

BatchFee
Optional

Batch fee. This is a flat fee ($ amount)
Format: Numeric 0 - 100

  • Example_:3.05 (decimals should be added to show cents)

ChargebackFee
Optional

Chargeback fee. This is a flat fee ($ amount)
Format: Numeric 0 - 200

  • Example_:3.05 (decimals should be added to show cents)

ChargebackReversalFee
Optional

Chargeback Reversal fee. This is a flat fee ($ amount)
Format: Numeric 0 - 200

  • Example_:3.05 (decimals should be added to show cents)

RetrievalFee
Optional

Retrieval fee. This is a flat fee ($ amount)
Format: Numeric 0 - 200

  • Example_:3.05 (decimals should be added to show cents)

ArbitrationFee
Optional

Abritration fee. This is a flat fee ($ amount)
Format: Numeric 0 - 200

  • Example_:3.05 (decimals should be added to show cents)

VoiceAuthFee
Optional

Voice Authorization fee. This is a flat fee ($ amount)
Format: Numeric 0 - 100

  • Example_:3.05 (decimals should be added to show cents)

DebitCardAuthsFee
Optional

Debit Card Authorization fee. This is a flat fee ($ amount)
Format: Numeric 0 - 100

  • Example_:3.05 (decimals should be added to show cents)

EbtAuthsFee
Optional

EBT Authorization fee. This is a flat fee ($ amount)
Format: Numeric 0 - 100

  • Example_:3.05 (decimals should be added to show cents)

AccountUpdateOtherFee
Optional

Account Updater Monthly fee. This is a flat fee ($ amount)
Format: Numeric 0 - 5000

  • Example_:3.05 (decimals should be added to show cents)

GatewayTranactionsFee
Optional

Gateway Transactions fee. This is a flat fee ($ amount)
Format: Numeric 0 - 100

  • Example_:3.05 (decimals should be added to show cents)

PerAchRejectFee
Optional

Per ACH Reject Fee. This is a flat fee ($ amount)
Format: Numeric 0 - 100

  • Example_:3.05 (decimals should be added to show cents)

DiscoverMAPAuthsFee
Required

Discover Auth Fee. This is a flat fee ($ amount)
Format: Numeric 0 - 100

  • Example_:3.05 (decimals should be added to show cents)

AmexEsaAuthFee
Required

Amex Auth Fee. This is a flat fee ($ amount)
Format: Numeric 0 - 100

  • Example_:3.05 (decimals should be added to show cents)

DeclinesFee
Optional

Decline Fee. This is a flat fee ($ amount)
Format: Numeric 0 - 100

  • Example_:3.05 (decimals should be added to show cents)

RefundsFee
Optional

Per Refund Fee. This is a flat fee ($ amount)
Format: Numeric 0 - 100

  • Example_:3.05 (decimals should be added to show cents)

AvsFee
Optional

AVS Fee. This is a flat fee ($ amount)
Format: Numeric 0 - 100

  • Example_:3.05 (decimals should be added to show cents)

EthocaVerifiAlertsFee
Optional

Ethoca/Verifi Alerts Fee. This is a flat fee ($ amount)
Format: Numeric 0 - 500

  • Example_:3.05 (decimals should be added to show cents)

RapidDisputeResolutionFee
Optional

Rapid Disputes Resolution (RDR) Fee. This is a flat fee ($ amount)
Format: Numeric 0 - 100

  • Example_:3.05 (decimals should be added to show cents)

CurrentyAcceptCreditCards
Required

To determine if the merchant applying currently accepts cards or not.
Values: Yes or No

  • Example_:Yes

CardPresentPct
Required

Percentage of card transactions that are Card Present.g. Note CardPresentPct and MotoPct fields must equal 100.
Format: Numeric (must be whole number), 0 - 100

  • Example_:22

MotoPct
Required

Percentage of card not present transactions/moto internet transactions.g. Note CardPresentPct and MotoPct fields must equal 100.
Format: Numeric (must be whole number), 0 - 100

  • Example_:22

BankAccountNo
Required

Bank account number of the merchant that is apply.
Format: Numeric Length 1-16

  • Example_:5145541511

BankRoutingNo
Required

Bank account routing number of the merchant that is apply.
Format: Numeric, Length: 9

  • Example_:211123265

TotalMonthlyProcessing
Required

Estimated dollar amount for the expected Monthly processing for the merchant.
Format: Numeric 1.00 - 100000000.00

  • Example_:50000.00 (decimals should be added to show cents)

AvgTicketValue
Required

Estimated dollar amount for the expected Average ticket the merchant expects to have.
Format: Numeric 1.00 - 200000.00

  • Example_:27.00 (decimals should be added to show cents)

HighTicketValue
Required

Estimated dollar amount for the expected High ticket the merchant expects to have.
Format: Numeric 1.00 - 200000.00

  • Example_:100.00 (decimals should be added to show cents)

DesiredDescriptor
Optional

Text that will appear on a customer’s statement. This is called the Descriptor. If this is not input, it will use Payarc’s Default.
Format: String, Length 0 - 50

  • Example_:Merchant 1 Name

EbtFnsNumber
Optional

EBT FNS Number is the number assigned by the government to accept food stamps. If the merchant is accepting food stamps this needs to be provided.
Format: String, Length 0 - 50

  • Example_:

ProcessingTerminated
Required

Has processing ever been terminated for this merchant with another payment processor before?
Values: Yes or No

  • Example_:Yes

AmexProcessingPerYear
Optional

Amex Processing per year fee.
Format: Numeric 1-10000000

  • Example_:200

OtherFee
Optional

If an “Other” fee that is not listed in fees already is needed, you can use this field. This will be the fee amount. This is a flat fee ($ amount) Note: If OtherFeeName is provided – otherfee must also be provided
Format: Numeric 0-5000

  • Example_:3.05 (decimals should be added to show cents)

OtherFeeName
Optional

If an “Other” fee that is not listed in fees already is needed, you can use this field. This will be the name of the new fee. Note: If OtherFee is provided – otherfeename must also be provided
Format: String, Length 0 - 50

  • Example_:Other Fee Name 1

CommentsOther
Optional

This is a space for any additional comments related to the fees or the other fee that has been created.
Format: String, Length 0 - 350

  • Example_:Please use fee XYZ for ABC.

MonthlyOtherFee
Optional

If an “Other” fee that is not listed in monthly fees already is needed, you can use this field. This will be the fee amount. This is a flat fee ($ amount) Note: If MonthlyOtherFeeName is provided – Monthlyotherfee must also be provided
Format: Numeric 0 - 5000

  • Example_:3.05 (decimals should be added to show cents

MonthlyOtherFeeName
Optional

If an “Other” fee that is not listed in monthly fees already is needed, you can use this field. This will be the name of the new fee. Note: If MonthlyOtherFee is provided – Monthlyotherfeename must also be provided
Format: String, Length 0 - 50

  • Example_:Other Fee Name 1

AmexEsaNumber
Optional

If a Merchant already has an ESA number with AMEX, this can be provided. If it is not, one will be created automatically by Payarc if applicable.
Format: String, Length 0 - 50