---
title: "Update a transfer"
method: PUT
path: "/transfers/{id}"
tags: ["Transfers"]
---

# Update a transfer

`PUT /transfers/{id}`

This can only be used to update instructions about a deferred payout.

## Path parameters

- `id` string, required — ID of the transfer

## Headers

- `X-Trace-Id` string

## Request body

- TransferUpdateIn
  - `initiate` boolean — Used to initiate a deferred or scheduled transfer
  - `close` boolean — Used to close a deferred or scheduled transfer.
  - `disburse_option` DisburseOption — To specify the date and time for disbursement, this is required when action is set to scheduled.
    - `date_time` string — the scheduled date and time for when the transfer should be disbursed to the recipient's account. It should be in the 'YYYY-MM-DD HH:MM:SS' 24hr format.
    - `timezone` 'Africa/Cairo' | 'Africa/Accra' | 'Africa/Nairobi' | 'Africa/Lagos' | 'Africa/Freetown' | 'Africa/Dar_es_Salaam' | 'Africa/Kampala' | 'Africa/Douala' | 'Africa/Ndjamena' | 'Africa/Kinshasa' | 'Africa/Lubumbashi' | 'Africa/Libreville' | 'Africa/Porto-Novo' | 'Africa/Abidjan' | 'Africa/Dakar' | 'Africa/Johannesburg' | 'America/New_York' | 'America/Los_Angeles' | 'America/Sao_Paulo' | 'Asia/Dubai' | 'Asia/Kolkata' | 'Asia/Tokyo' | 'Australia/Sydney' | 'Europe/London' | 'Europe/Berlin' | 'Europe/Moscow' | 'Pacific/Auckland' | 'Pacific/Honolulu' | 'UTC'

## Response `200`

OK

- TransferPutResponse
  - `status` 'success' | 'failed'
  - `message` string
  - `data` object
    - `id` string — The unique identifier for the transfer.
    - `action` 'instant' | 'deferred' | 'scheduled' | 'retry' | 'duplicate' | 'closed' — Specifies if the transfer is processed immediately or later.
    - `status` 'NEW' | 'PENDING' | 'INITIATED' | 'CANCELLED' — The current status of the transfer. `NEW` indicates the transfer is being processed, while `CANCELLED` indicates the transfer has been cancelled.
    - `disburse_option` DisburseOption — To specify the date and time for disbursement, this is required when action is set to scheduled.
      - `date_time` string — the scheduled date and time for when the transfer should be disbursed to the recipient's account. It should be in the 'YYYY-MM-DD HH:MM:SS' 24hr format.
      - `timezone` 'Africa/Cairo' | 'Africa/Accra' | 'Africa/Nairobi' | 'Africa/Lagos' | 'Africa/Freetown' | 'Africa/Dar_es_Salaam' | 'Africa/Kampala' | 'Africa/Douala' | 'Africa/Ndjamena' | 'Africa/Kinshasa' | 'Africa/Lubumbashi' | 'Africa/Libreville' | 'Africa/Porto-Novo' | 'Africa/Abidjan' | 'Africa/Dakar' | 'Africa/Johannesburg' | 'America/New_York' | 'America/Los_Angeles' | 'America/Sao_Paulo' | 'Asia/Dubai' | 'Asia/Kolkata' | 'Asia/Tokyo' | 'Australia/Sydney' | 'Europe/London' | 'Europe/Berlin' | 'Europe/Moscow' | 'Pacific/Auckland' | 'Pacific/Honolulu' | 'UTC'
    - `updated_datetime` string, date-time — The date and time when the transfer was submitted for processing.

## Other responses

- `400` — Bad request
- `401` — Unauthorised request
- `403` — Forbidden

---

[API](https://skmtc.net/flutterwave/apis/flutterwave-apis.md) · [All operations](https://skmtc.net/flutterwave/apis/flutterwave-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/flutterwave/flutterwave-apis/revisions/6014190df2e9/schema)