---
title: "Update a cash transfer"
method: PATCH
path: "/cash/{id}"
tags: ["Cash Orders and Deposits (alpha)"]
---

# Update a cash transfer

`PATCH /cash/{id}`

To cancel a transfer, update the status to 'CANCELLED'. Only 'INITIATED' or 'PENDING` transfers can be cancelled.
> 🚧 Alpha > This is an Alpha spec-only endpoint. Feedback from the community is welcome. We may make breaking changes.

## Path parameters

- `id` string, uuid, required

## Headers

- `Idempotency-Key` string

## Request body

- CashPatch — Properties for updating a transfer
  - `destination_account_id` string, uuid — The UUID of the Synctera account resource that is the destination of the transfer for incoming transfers. This can only be updated if the transfer is suspended.
  - `source_data` object — Additional information to be added to the transfer
  - `status` 'CANCELLED'

## Response `200`

The updated Cashier transfer.

- CashResponse — Cash transfer
  - `amount` integer, required — Transfer amount in cents
  - `dc_sign` 'CREDIT' | 'DEBIT', required — Debit or credit sign
  - `source_data` object — Additional information to be added to the transfer
  - `client_bank_account` string — The bank account of the client.
  - `client_name` string — The name of the client.
  - `customer_id` string — The UUID of the Synctera customer resource that is the originator of the transfer.
  - `destination_account_id` string — The UUID of the Synctera account that is the destination of the transfer. For a transfer originated by the Synctera platform, this will be an external account resource, while for a transfer originated by the external account, this account will be an account resource.
  - `destination_account_number` string, string — The account number of the destination account.
  - `destination_account_owner_name` string — The account owner name of the destination account.
  - `effective_date` string, date, required — The effective date of the transaction once it gets posted
  - `failed` boolean — Whether the transfer failed or not.
  - `history` Action[]
    - `data` object, required
    - `message` string, required
    - `timestamp` string, date-time, required
  - `id` string, uuid, required — ID of the transfer
  - `is_same_day` boolean, required — Send the same day (use only is_same_day without specific effective_date).
  - `network_status` 'PENDING' | 'POSTED' | 'RETURNED' | 'REVERSED' — The network status of the transfer in the Synctera platform.
  - `original_reference_id` string — The original reference id of the transfer if it's a return.
  - `originating_account_id` string — The UUID of the Synctera account that is the origination of the transfer. For a transfer originated by the Synctera platform, this will be an account resource, while for a transfer originated by the external account, this will be an external account resource.
  - `originating_account_number` string, string — The account number of the originating account.
  - `originating_account_owner_name` string — The account owner name of the origination account.
  - `posting_date` string, date — The posting date of the transaction once it gets posted
  - `reference_id` string, required — The reference id of the transfer.
  - `status` 'CANCELLED' | 'EXPIRED' | 'INITIATED' | 'PENDING' | 'POSTED', required — The status of the transfer in the Synctera platform. This is automatically set upon the creation of a transfer. To cancel a transfer, the current status must be 'INITIATED' or 'PENDING' and the request status set to 'CANCELLED'. To trigger a return, the current status must be 'POSTED' and the returned status will be set to 'RETURNED' if successful.
  - `subtype` 'CASH_ORDER' | 'CASH_ORDER_REVERSAL' | 'DEPOSIT' | 'DEPOSIT_REVERSAL', required — The subtype of the transfer
  - `suspended` boolean — Whether the transfer is suspended or not.
  - `tenant_id` string, required — The id of the tenant containing the resource. This is relevant for Fintechs that have multiple workspaces.
  - `transaction_id` string, uuid — The related transaction id of the transfer.

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `403` — Forbidden error
- `404` — Resource not found
- `422` — Unprocessable entity request response
- `500` — Internal server error

---

[API](https://skmtc.net/synctera/apis/synctera-api.md) · [All operations](https://skmtc.net/synctera/apis/synctera-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synctera/synctera-api/versions/b0d812e6cdd0/schema)