---
updatedAt: 2026-06-18T18:55:55.000Z
agentTools:
  projectIndex: https://docs.checkhq.com/llms.txt
---

# The contractor payment object

Represents a payment from a company to a contractor for work performed.

Contractor payments are created during [payroll creation](https://docs.checkhq.com/reference/create-payroll), or via directly creating one [via the Contractor Payment API](https://docs.checkhq.com/reference/create-a-contractor-payment).

Note only one contractor payment is allowed per contractor per payroll.

```json Sample contractor payment object
{
    "id": "cpa_TVtTrPuPOgLuMDlt7FqJ",
    "payroll": "pay_jIjPJa7Q8cG6s0TWUdLm",
    "contractor": "ctr_90QzaH9xPRI7JRLXnRoU",
    "status": "pending",
    "payment_method": "direct_deposit",
    "amount": "2100.00",
    "reimbursement_amount": "0.00",
    "net_pay": "2100.00",
    "paper_check_number": null,
    "workplace": "wrk_qbCnBhUIDzduGrwLJ83p",
    "metadata": {}
}
```

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Attribute
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `id`  
        _string_
      </td>

      <td>
        Unique identifier for the contractor payment.
      </td>
    </tr>

    <tr>
      <td>
        `payroll`  
        _string_
      </td>

      <td>
        ID of the payroll object that this contractor payment relates to.
      </td>
    </tr>

    <tr>
      <td>
        `contractor`  
        _string_
      </td>

      <td>
        ID of the contractor that this contractor payment relates to.
      </td>
    </tr>

    <tr>
      <td>
        `status`  
        _string_
      </td>

      <td>
        Status of the contractor payment.  

        One of `draft`, `pending`, `processing`, `failed`, `partially_paid`, or `paid`.
      </td>
    </tr>

    <tr>
      <td>
        `payment_method`  
        _string_
      </td>

      <td>
        Payment method for the contractor payment. Possible values are `manual` and `direct_deposit`.
      </td>
    </tr>

    <tr>
      <td>
        `amount`  
        _string_
      </td>

      <td>
        Amount paid to the contractor for this payment.
      </td>
    </tr>

    <tr>
      <td>
        `reimbursement_amount`  
        _string_
      </td>

      <td>
        Reimbursement amount paid to the contractor for this payment.  

        **Note:** This field will not be included on the contractor’s 1099.
      </td>
    </tr>

    <tr>
      <td>
        `net_pay`  
        _string_
      </td>

      <td>
        Read only. The total amount of net pay earned by the contractor for this payroll item. The formula for net pay is `amount` + `reimbursement_amount`. This will be `null` except during payroll preview and/or after approval.
      </td>
    </tr>

    <tr>
      <td>
        `paper_check_number`  
        _string_
      </td>

      <td>
        For accounting. The check number associated with any printed checks. Can be updated even after the associated payroll has been approved. See [Get a paper check](https://docs.checkhq.com/reference/get-a-paper-check-2) for more details.
      </td>
    </tr>

    <tr>
      <td>
        `workplace`  
        _string_
      </td>

      <td>
        The Workplace ID associated with this payment.
      </td>
    </tr>

    <tr>
      <td>
        `metadata`  
        _object_
      </td>

      <td>
        Additional loosely structured information to associate with this contractor payment.
      </td>
    </tr>
  </tbody>
</Table>