Requirement guidance

Guidance on how to fulfill a requirement.

The guidance object provides additional information about how to fulfill a requirement. For instance, this guidance information can include a list of the document type accepted for a particular documentation request, or it can include information about the funding state and retry status of a failed payroll debit.

Below is the list of document options provided via the guidance object's document_options for document upload requirements.

RequirementDocument Option Name and Label
signatory_identity_verificationsignatory_photo_id - Non-expired government-issued photo ID for authorized signer
signatory_authorization_verificationarticles_of_incorporation - Articles of Incorporation (Company registration document)

articles_of_incorporation_signatory_amendment - Amendment to Articles of Incorporation showing the addition of Signer
company_identity_verificationarticles_of_incorporation - Articles of Incorporation (Company registration document)

bank_statement - Full bank statement including bank name, account number, and account owner's name and address
federal_ein_verificationss4 - IRS Form SS4

cp_575 - IRS Form CP-575 (This option is not recommended and will be removed soon.)

147_C - IRS Form 147-C (This option is not recommended and will be removed soon.)

940 - IRS Form 940 (This option is not recommended and will be removed soon.)

941 - IRS Form 941 (This option is not recommended and will be removed soon.)

943 - IRS Form 943 (This option is not recommended and will be removed soon.)

944 - IRS Form 944 (This option is not recommended and will be removed soon.)

945 - IRS Form 945 (This option is not recommended and will be removed soon.)
company_financial_verification (enables 2-day upgrade)profit_and_loss - Profit & Loss Statement

balance_sheet - Balance Sheet

cash_flow_statement - Cash Flow Statement

bank_statement - Two months of bank statements including bank name, account number, account owner's name and address, and monthly balances
state_registration_verificationstate_registration - State registration document, proving registration of company in the state of legal address
bank_account_verificationbank_letter - Bank letter, on bank letterhead, including last four of the account number and account owner’s name

bank_statement - Full bank statement including bank name, account number, and account owner's name and address

For funding failure requirements, the guidance object will contain information about the failed debit recovery status. This information is available via the funding_detail object, and contains the failed payment ID, payroll ID, as well as a funding status and funding message pair. These last two fields can take on the following values during the funding recovery lifecycle:

Funding statusFunding message
failedThe employer has failed to fund payroll.
ach_redebit_inflightAn ACH redebit attempt has been issued for this employer.
ach_redebit_awaiting_return_windowAn ACH redebit attempt has successfully completed for this employer, and is waiting for the three day ACH return window to clear on YYYY-MM-DD.
expecting_wireCheck is waiting for the failed debit attempt to be retried via wire.
resolvedThe payroll has been successfully funded and the funding failure has been resolved.