Payroll settings

Payroll settings are configured during your initial account set up. However, you can always change payroll settings in the application or by using the Wingspan API.

When configuring payroll settings, you can set your payroll schedule by defining the day(s) of the month when your Collaborators are paid, the Paid Date. By default, payroll processes two business days before the pay date on the Payroll Date. You can choose from:

• Monthly: The payment(s) will be received on the last day of each month.
• Semi-Monthly: The payment(s) will be received on the 15th and last day of each month.
• Everyday: The payment(s) will be received daily.
• Weekly: You decide which day of the week, and the weekly frequency.

Weekend and Holidays

If Payroll Date falls on a weekend or a holiday, it runs on the preceding business day. For example, if it falls on Saturday, the payment runs on Friday.

If the Check Date falls on a weekend or a holiday, it is deposited the next business day. For example, if the 15th is a Sunday, the Check Date will be the 16th.

During US bank holidays, the payroll schedule might be updated to accommodate.

Payables in payroll runs

By design, only approved Payable invoices are included in a payroll run. However, this means that all approved payables are included on the payroll run regardless of the Payable invoice’s due date. Depending on your needs, you might want to only pay approved invoices when due. You can control this setting in the application or with the API. If you choose, approved payables are only paid at the last possible payroll such that the payment arrives before the Due Date. Otherwise, all approved payables are paid out at the next payroll run.

To find your payroll setting by using the API

Retrieve your payroll settings with GET /payments/payroll-settings/{id}. Use the member ID of the account whose payroll settings you are reading as {id}. It must match the account authenticated by your API token.

curl --request GET \
     --url "https://api.wingspan.app/payments/payroll-settings/YOUR_MEMBER_ID" \
     --header "accept: application/json" \
     --header "Authorization: Bearer YOUR_ACCESS_TOKEN"

A successful request returns HTTP 200 and the account's current payroll settings. Use PATCH /payments/payroll-settings/{id} to update the settings.