Send payments

This section shows you how to pay the people and businesses you work with through the V3 API. A payment starts as a payable: the payer's record of what it owes one payee. You approve payables and pay them directly, import them in bulk, or collect them into a payroll run that funds everything in one movement. The pages also cover payroll funding and cadence, work logs that turn into payables, deductions, recurring payables, and what happens when a payment is refunded or returned.

Read the pages in this order if you're new to Wingspan payments:

1. Payables overview: what a payable is, how it relates to an invoice, and the ways to pay one.
2. Components of a payable: every field you send and read on a payable, including line items and splits.
3. Payable lifecycle and statuses: the three status fields on a payable and what moves each one.
4. Create a payable: create, open, approve, and pay a single payable, step by step.
5. Bulk payables: import many payables at once with a PayableImport batch.
6. Payroll runs: pay a set of approved payables in one funded run, and reconcile the result.
7. Payroll schedules: read and change your contractor and employee payroll cadence.
8. Payroll settings and funding: choose the account Wingspan debits to fund payroll.
9. Payment and payout methods: the instruments you pay from, and where your payees get paid.
10. Find incomplete payables: locate payables stuck in Pending and fix what's blocking them.
11. Refunds and returns: refund a paid payable and handle a payment the bank sends back.
12. Work logs and rate cards: capture structured work, price it with a rate card, and turn it into a payable.
13. Deductions and credits: withhold amounts from a payee's payments.
14. Recurring payables: generate a payable on a schedule.

End-to-end examples live in Recipes, including Process a payable and Import payables in bulk.