Configure payroll funding

As you set up your Wingspan account for the first time, the application takes you through the steps of configuring your financial settings. This is a standard part of the onboarding process and Wingspan uses this information to verify identity and tax information.

Under typical circumstances, the procedure for payroll funding and distribution is expedited immediately after a payroll run. Consider this scenario:

• Assume your account is configured with a one-day funding window.
• Your collaborator opts for standard payouts.

Given these conditions, executing a payroll run on a Wednesday will prioritize and incorporate only those approved payables that are set for a pay date of the upcoming Friday (or any preceding date).

To use an external bank account (Account object) you will have to verify that you are the owner of that account first. This can be done by adding the account in the frontend through Plaid - or by requesting verification through microdeposits. In the latter case Wingspan will wire you 2 amounts below 1 USD which you will have to confirm after receiving them.

To set up the Wingspan Wallet as a funding source for your payroll through the API, use:

Endpoint:

PATCH /payments/payroll-settings/:id

Headers

• accept: application/json
• Content-Type: application/json
• authorization: Bearer <YOUR TOKEN>

Body:

fundingSource: {
	fundingSourceType: ‘InternalAccount‘ // Wingspan Wallet (InternalAccount)
	fundingSourceCurrency: ‘USD‘
	fundingSourceId: ‘1234567890‘ // The id of your Wallet’s internalAccountId
}

Response

Upon a successful request, the API will return a status code of 200 and a response body.

To set up a bank account as the funding source for your payroll use:

Endpoint:

PATCH /payments/payroll-settings/:id

Headers

• accept: application/json
• Content-Type: application/json
• authorization: Bearer

Body:

fundingSource: {
	fundingSourceType: ‘Account‘ // External Bank Account (Account)
	fundingSourceCurrency: ‘USD‘
	fundingSourceId: ‘1234567890‘ // The id of you bank account’s accountId
}

Response

Upon a successful request, the API will return a status code of 200 and a response body.