Skip to main content
Leads represent merchant applications in progress. A lead captures everything needed to underwrite and board a new merchant — business details, ownership, pricing, equipment, and e-signatures. Once approved, a lead is transitioned into an active merchant record.

Subsections

Lead Sources

Track referral channels and marketing campaigns that originate leads.

Addresses

Manage business addresses on a lead record.

Principals

Manage beneficial owners and signatories on a lead record.

Deposit Info

Manage bank account and deposit routing information for a lead.

Documents

Manage documents attached to a lead record.

Notes

Add and manage internal notes on a lead record.

Pricing

Manage pricing items, packages, and rules for a lead.

Equipment

Manage terminal equipment models and deployment orders for a lead.

Validations

Run identity, credit, and compliance checks against a lead.

Signing

Manage e-signature sessions for merchant application agreements.

Clear Identity Verification

Initiate and check Clear identity verification sessions for a lead.

Fast Apply

Streamlined public-facing MPA form endpoints for lead capture.

Lifecycle

Leads move through a configurable pipeline of statuses:

What’s included

Core

EndpointDescription
List leadsRetrieve a paginated list of leads
Create leadCreate a new merchant lead
Get leadRetrieve a single lead by ID
Update leadUpdate an existing lead record
Delete leadPermanently delete a lead record
Transition statusMove a lead to a new status in the pipeline
Submit for reviewSubmit a lead for underwriting or compliance review
Get MIDRetrieve the assigned merchant identifier once boarding is complete
Update risk profileUpdate the lead’s risk classification
Get service acceptanceRetrieve service terms acceptance status
Update service acceptanceUpdate service terms acceptance
Decrypt sensitive dataDecrypt a protected field (SSN, bank account, etc.) on demand

Lead sources

EndpointDescription
List lead sourcesRetrieve all lead sources
Create lead sourceCreate a new referral or campaign source
Get lead sourceRetrieve a single lead source by ID
Update lead sourceUpdate an existing lead source
Get source summaryRetrieve an aggregate summary for a lead source
List leads for sourceRetrieve all leads associated with a lead source
List sources for leadRetrieve all sources associated with a lead
Add source to leadAssociate a lead source with a lead
Remove source from leadRemove a lead source association from a lead

Business addresses

EndpointDescription
List addressesRetrieve all business addresses for a lead
Add addressAdd a business address to a lead
Get addressRetrieve a single business address
Update addressUpdate a business address

Principals

EndpointDescription
List principalsRetrieve all principals associated with a lead
Add principalAdd a beneficial owner or signer to a lead
Get principalRetrieve a single principal by ID
Update principalUpdate a lead principal’s information
Delete principalRemove a principal from a lead record
Decrypt principal dataDecrypt a sensitive field on a principal

Deposit info

EndpointDescription
List deposit infoRetrieve all deposit info records for a lead
Create deposit infoAdd a deposit info record to a lead
Get deposit infoRetrieve a single deposit info record
Update deposit infoUpdate a deposit info record
Delete deposit infoRemove a deposit info record from a lead
Decrypt deposit infoDecrypt a sensitive field on a deposit info record

Documents

EndpointDescription
List documentsRetrieve all documents for a lead
Create documentAttach a document to a lead
Get documentRetrieve a single lead document
Update documentUpdate document metadata
Delete documentRemove a document from a lead

Notes

EndpointDescription
List notesRetrieve all notes on a lead record
Create noteAdd a note to a lead record
Get noteRetrieve a single note
Update noteEdit a note on a lead record

Pricing items

EndpointDescription
List pricing itemsRetrieve all pricing items for a lead
Create pricing itemAdd a pricing item (e.g. interchange, basis points) to a lead
Get pricing itemRetrieve a single pricing item
Update pricing itemUpdate a lead pricing item
Delete pricing itemRemove a pricing item from a lead

Pricing packages

EndpointDescription
List pricing packagesRetrieve all pricing packages for a lead
Create pricing packageAdd a pricing package to a lead
Get pricing packageRetrieve a single pricing package
Update pricing packageUpdate a lead pricing package
Delete pricing packageRemove a pricing package from a lead

Pricing rules

EndpointDescription
List pricing rulesRetrieve all pricing rules for a lead
Create pricing ruleAdd a pricing rule to a lead
Get pricing ruleRetrieve a single pricing rule
Update pricing ruleUpdate a lead pricing rule
Delete pricing ruleRemove a pricing rule from a lead

Equipment models

EndpointDescription
List equipment modelsRetrieve all equipment models for a lead
Create equipment modelAdd an equipment model to a lead
Get equipment modelRetrieve a single equipment model
Update equipment modelUpdate a lead equipment model
Delete equipment modelRemove an equipment model from a lead

Equipment orders

EndpointDescription
List equipment ordersRetrieve all equipment orders for a lead
Create equipment orderCreate a new equipment order for a lead
Get equipment orderRetrieve a single equipment order
Update equipment orderUpdate a lead equipment order
Delete equipment orderRemove an equipment order from a lead
List order itemsRetrieve all items in an equipment order
Create order itemAdd an item to an equipment order
Get order itemRetrieve a single order item
Update order itemUpdate an equipment order item
Delete order itemRemove an item from an equipment order
Create gatewayAdd gateway configuration to an equipment order
Get gatewayRetrieve the gateway configuration
Update gatewayUpdate the gateway configuration
Delete gatewayRemove the gateway configuration
Create file build typeSet the file build type for an equipment order
Get file build typeRetrieve the file build type
Update file build typeUpdate the file build type
Delete file build typeRemove the file build type from an equipment order

Compliance & validation

EndpointDescription
Validate completenessCheck all required fields before submission
DataX verificationRun a DataX identity verification
Equifax creditRun an Equifax credit report
Equifax state IDRun an Equifax state ID verification
GIACT validationRun a GIACT bank account validation
MATCH inquiryRun a MATCH Pro terminated merchant screening
TinCheckRun a TinCheck tax ID verification
List validationsRetrieve all validation records for a lead
Get validationRetrieve a single validation record

Signing

EndpointDescription
Create signing sessionCreate an e-signature session for MPA agreement delivery
Verify signing tokenVerify a signing session token

Clear identity verification

EndpointDescription
Create Clear sessionInitiate a Clear identity verification session
Get Clear statusRetrieve the result of a Clear verification

Fast Apply

Streamlined public-facing MPA form flow for lead capture:
EndpointDescription
Update generalUpdate the general section of a Fast Apply form
Update businessUpdate the business details section
Save principalsSave the principals section
Create principalAdd a principal via the Fast Apply form
Update principalUpdate a specific principal via the Fast Apply form