POST
/
Boarding
/
app

Authorizations

requestToken
string
header
required

Most endpoints require an organization token. Some endpoints require an application token, and those endpoints are noted.

Body

avgmonthly
number | null
required

Average total amount of transactions in your local currency that are processed each month.

baddress
string | null
required

Business address.

bcity
string | null
required

Business city

bcountry
string | null
required

Business country in ISO-3166-1 alpha 2 format
Check out https://en.wikipedia.org/wiki/ISO_3166-1 for reference

binperson
integer | null
required

Numeric percent of volume processed in person. To pass validation, binperson, binweb, and binphone must total 100 together.

binphone
integer | null
required

Numeric percent of volume processed by phone. To pass validation, binperson, binweb, and binphone must total 100 together.

binweb
integer | null
required

Numeric percent of volume processed on web. To pass validation, binperson, binweb, and binphone must total 100 together.

bstate
string | null
required

Business state.

bsummary
string | null
required

A summary of what the business sells in terms of goods or services.

btype
enum<string> | null
required

The business ownership type.

Available options:
Limited Liability Company,
Non-Profit Org,
Partnership,
Private Corp,
Public Corp,
Tax Exempt,
Government,
Sole Proprietor
bzip
string | null
required

Business ZIP.

contacts
object[] | null
required

List of contacts for the business.

depositAccount
object
required

Object that contains bank account details.

ein
string | null
required

Business EIN or tax ID.

highticketamt
number | null
required

High ticket amount.

Business legal name.

mcc
string | null
required

Business Merchant Category Code (MCC). This resource lists MCC codes.

phonenumber
string
required

The business's phone number.

processingRegion
enum<string>
required

The business's processing region.

Available options:
US,
CA
services
object
required

Controls which services will be enabled for the merchant.

signer
object
required

Information about the application's signer.

startdate
string | null
required

Business start date.
Accepted formats:

  • YYYY-MM-DD
  • MM/DD/YYYY
ticketamt
number | null
required

The average transaction size that the business expects to process. For example, if you process $10,000 a month across 10 transactions, that's an average ticket of $1000.

website
string | null
required

The business website address. Include only the domain and TLD, do not enter the protocol (http/https). For example: www.example.com is acceptable.

whenCharged
enum<string>
required

Describes when customers are charged for goods or services. Accepted values:

Available options:
When Service Provided,
In Advance
whenDelivered
enum<string>
required

When goods and services are delivered.

Available options:
0-7 Days,
8-14 Days,
15-30 Days,
Over 30 Days
whenProvided
enum<string>
required

Describes when goods or services are provided, from time of transaction.

Available options:
30 Days or Less,
31 to 60 Days,
60+ Days
whenRefunded
enum<string>
required

Describes the business refund policy.

Available options:
Exchange Only,
No Refund or Exchange,
More than 30 days,
30 Days or Less
withdrawalAccount
object
required

Object that contains bank account details.

annualRevenue
number | null

Annual revenue amount.

averageBillSize
string

This is the average amount of each bill you pay through our service. For example, if your business paid 3 bills for a total of $1,500 then your average bill size is $500.

averageMonthlyBill
string

This is the total number of bills the business pays each month. For example, if your business pays an electric bill of $500, a internet bill of $150, and various suppliers $5,000 every motnh then your monthly bill volume would be $5,650.

baddress1
string | null

Business address additional line.

Boarding link ID for the application. Either templateId or boardingLinkId are required.

creditLimit
string

The maximum amount of credit that our lending partner, has authorized to your business. It's the upper boundary on how much you can spend or owe on a credit account at any given time.

dbaName
string | null

The alternate or common name that this business is doing business under usually referred to as a DBA name. Payabli strongly recommends including this information.

externalpaypointID
string | null

Optional field for the external paypoint ID. This field is helpful if the merchant has an existing ID in your system.

faxnumber
string

The business's fax number.

license
string | null

Business license ID or state ID number.

licstate
string | null

Business license issuing state or province.

maddress
string | null

The business's mailing address.

maddress1
string | null

Additional line for the business's mailing address.

mcity
string | null

The business's mail city.

mcountry
string | null

Business mailing country.

mstate
string | null

The business's mailing address state.

mzip
string | null

Business mailing ZIP.

ownership
object[] | null

List of Owners with at least a 25% ownership.

recipientEmail
string | null

Email address for the applicant. This is used to send the applicant a boarding link.

recipientEmailNotification
boolean
default:
true

When true, Payabli will send the applicant a boarding link. Set this value to false if you are sending pre-filled applications via the API and don't want Payabli to send the applicant an email to complete the boarding application.

resumable
boolean
default:
true

When true, the applicant can save an incomplete application and resume it later. When false, the applicant won't have an option to save their progress, and must complete the application in one session.

taxFillName
string | null

Business name in tax document. This is only relevant if a government entity has given you an alternative name to file tax documents with.

templateId
integer | null

The associated boarding template's ID in Payabli. Either templateId or boardingLinkId are required.

Response

200 - application/json
isSuccess
boolean

Boolean indicating whether the operation was successful. A true value indicates success. A false value indicates failure.

pageIdentifier
string | null

Auxiliary validation used internally by payment pages and components.

responseCode
integer | null

Code for the response. Learn more in API Response Codes.

responseData

The response data.

responseText
string | null

Response text for operation: 'Success' or 'Declined'.