---
title: "Fund a contractor payment [DEMO]"
method: PUT
path: "/v1/contractor_payments/{contractor_payment_uuid}/fund"
tags: ["Contractor Payments"]
---

# Fund a contractor payment \[DEMO\]

`PUT /v1/contractor_payments/{contractor_payment_uuid}/fund`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/contractor_payments/{contractor_payment_uuid}/fund`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/gusto/apis/gusto-api/docs/v1/contractor_payments/:contractor_payment_uuid/fund/put.ts> (a function with typed inputs; its response is checked against the schema)

> 🚧 Demo action
>
> This action is only available in the Demo environment

Simulate funding a contractor payment. Funding only occurs automatically in the production environment when bank transactions are generated. Use this action in the demo environment to transition a contractor payment's `status` from `Unfunded` to `Funded`. A `Funded` status is required for generating a contractor payment receipt.

scope: `payrolls:run`

## Path parameters

- `contractor_payment_uuid` string, required

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Response `200`

OK

- ContractorPayment: The representation of a single contractor payment.
  - `uuid` string, required: The unique identifier of the contractor payment in Gusto.
  - `contractor_uuid` string: The UUID of the contractor.
  - `bonus` string, float: The bonus amount in the payment.
  - `date` string: The payment date.
  - `hours` string, float: The number of hours worked for the payment.
  - `payment_method` 'Direct Deposit' | 'Check' | 'Historical Payment' | 'Correction Payment': The payment method.
  - `reimbursement` string, float: The reimbursement amount in the payment.
  - `status` 'Funded' | 'Unfunded': Contractor payment status
  - `hourly_rate` string, float: The rate per hour worked for the payment.
  - `may_cancel` boolean: Determine if the contractor payment can be cancelled.
  - `wage` string, float: The fixed wage of the payment, regardless of hours worked.
  - `wage_type` 'Hourly' | 'Fixed': The wage type for the payment.
  - `wage_total` string, float: (hours * hourly_rate) + wage + bonus
  - `invoice_number` string, nullable: An optional invoice number associated with this contractor payment. This will be visible to the contractor on their paystub. Maximum 25 characters.
  - `memo` string, nullable: An optional note or memo for this contractor payment. This will be visible to the contractor on their paystub.

## Other responses

- `404`: Not Found The requested resource does not exist. Make sure the provided UUID is valid.
- `422`: Unprocessable Entity This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details.

---

[API](https://skmtc.dev/gusto/apis/gusto-api.md) - [All operations](https://skmtc.dev/gusto/apis/gusto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gusto/apis/gusto-api/revisions/f98575fa2a5e?raw)