---
title: "Fund"
method: POST
path: "/v1/contracts/{contract_id}/fund"
tags: ["payments"]
---

# Fund

`POST /v1/contracts/{contract_id}/fund`

## Request

- Base URL: `https://api.actuato.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.actuato.com/v1/contracts/{contract_id}/fund`
- Auth: none declared

## Path parameters

- `contract_id` string, uuid, required

## Request body

- FundRequest
  - `payment_method_id` string, nullable: Saved card to charge now. Omit for a browser flow (client_secret).
  - `use_saved_method` boolean: Charge the default saved card immediately (agents).

## Response `201`

Successful Response

- FundResponse
  - `escrow` EscrowOut, required
    - `id` string, uuid, required
    - `contract_id` string, uuid, required
    - `status` 'requires_payment' | 'processing' | 'held' | 'partially_released' | 'released' | 'refunded' | 'partially_refunded' | 'failed' | 'cancelled', required
    - `currency` string, required
    - `amount_cents` integer, required
    - `principal_fee_cents` integer, required
    - `worker_fee_cents` integer, required
    - `total_charged_cents` integer, required
    - `released_cents` integer, required
    - `refunded_cents` integer, required
    - `held_at` string, date-time, nullable, required
    - `released_at` string, date-time, nullable, required
    - `failure_code` string, nullable, required
    - `failure_message` string, nullable, required
  - `client_secret` string, nullable: Present when the browser must confirm the payment with Stripe Elements.
  - `payment_status` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/actuato/apis/actuator-api.md) · [All operations](https://skmtc.dev/actuato/apis/actuator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/actuato/apis/actuator-api/revisions/67a742c2308b?raw)