---
title: "Update a transaction"
method: PUT
path: "/transactions/{id}"
---

# Update a transaction

`PUT /transactions/{id}`

## Path parameters

- `id` integer, required

## Request body

- object
  - `description` string — Description of the transaction.
  - `amount` integer — Amount of the transaction.
  - `callback_url` string, url — URL to receive transaction updates.
  - `status` string — Transaction status (e.g., 'pending', 'approved', 'canceled').

## Response `200`

Transaction updated successfully.

- object
  - `id` integer — Transaction ID.
  - `reference` string — Transaction reference.
  - `amount` integer — Transaction amount.
  - `description` string — Transaction description.
  - `callback_url` string — Transaction callback URL.
  - `status` string — Transaction status (e.g., 'pending', 'approved', 'canceled').
  - `customer_id` integer — Customer ID associated with the transaction.
  - `currency_id` integer — Currency ID associated with the transaction.
  - `metadata` object — Additional metadata related to the transaction.
  - `commission` integer — Transaction commission.
  - `fees` integer — Transaction fees.
  - `fixed_commission` integer — Fixed commission applied to the transaction.
  - `amount_transferred` integer — Amount transferred to the beneficiary.
  - `created_at` string, date-time — Date and time of transaction creation.
  - `updated_at` string, date-time — Date and time of last transaction update.
  - `approved_at` string, date-time — Date and time of transaction approval.
  - `canceled_at` string, date-time — Date and time of transaction cancellation.
  - `declined_at` string, date-time — Date and time of transaction decline.
  - `refunded_at` string, date-time — Date and time of transaction refund.
  - `transferred_at` string, date-time — Date and time of transaction transfer.
  - `deleted_at` string, date-time — Date and time of transaction deletion.
  - `last_error_code` string — Last error code encountered during the transaction.
  - `custom_metadata` object — Custom metadata associated with the transaction.
  - `amount_debited` integer — Amount debited from the payer.
  - `receipt_url` string, url — URL to the transaction receipt.
  - `payment_method_id` integer — Payment method ID used for the transaction.
  - `sub_accounts_commissions` unknown[] — Commissions applied to sub-accounts.
    - unknown
  - `transaction_key` string — Unique key associated with the transaction.
  - `merchant_reference` string — Merchant reference provided for the transaction.
  - `account_id` integer — Account ID associated with the transaction.
  - `balance_id` integer — Balance ID associated with the transaction.

## Other responses

- `400` — Invalid request body.
- `404` — Transaction not found.

---

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