Paying workers via Payroll

Overview

This guide details the steps needed for a business to pay its workers via a scheduled payroll. This workflow can be used for any platform that requires scheduled bulk payouts to wallets.

flowchart TD
    %% ───── PLATFORM & ACCOUNTS ─────
    subgraph PLATFORM
        direction TB
        B[Platform onboards workers]
        BA[(Platform Account)]

        subgraph USER_WALLETS
            direction LR
            W1[User Wallet #1]
            W2[User Wallet #2]
            Wn[User Wallet …]
        end
    end

    %% ───── EXTERNAL FUNDING ─────
    Bank[(External Bank)]

    %% ───── FLOWS ─────
    Bank -- "ACH credit/Wire (bulk)" --> BA
    BA   -- "Payroll payout" --> W1
    BA   -- "Payroll payout" --> W2
    BA   -- "Payroll payout" --> Wn

Running payroll

Running payroll is a three-step process:

a) Select the worker type employee/contractor and create a payroll.

Endpoint: Create Payroll API Reference

b) Provide the compensation information for each person for that payroll run.

Endpoint: Save Payroll API Reference

c) Approve the payroll.

Endpoint: Approve Payroll API Reference

If the business does not have sufficient funds, the payroll will move to an awaiting_funds state. If a bank account is connected, an ACH debit will be automatically initiated and the payroll will be processed once the funds are available. If the scheduled date is in the future, the payroll will get processed on the scheduled day.

Next Steps

With these steps, you should have successfully created and paid workers into their wallets. Check out the full API documentation for the rest of the functionality Full API Reference .