---
title: "Update order"
method: PUT
path: "/orders/{id}"
tags: ["Orders"]
---

# Update order

`PUT /orders/{id}`

Updates an order's details. After payment, only `metadata`, `fee_value`, and `fee_percent` can be changed.

## Path parameters

- `id` integer, required

## Request body

- object
  - `buyer_id` integer — Customer ID of the buyer.
  - `name` string
  - `value` number
  - `fee_value` number
  - `fee_percent` number
  - `tag` string
  - `metadata` object
  - `template` object — Custom template data for the checkout page.
    - `btn_submit_text` string
    - `iframe_title` string
    - `expires_in` integer
    - `hide_cardholder` boolean
    - `password_cvv` boolean
  - `images` string[]

## Response `200`

Updated order

- OrderResponse
  - `id` integer
  - `self` string
  - `public_id` string, nullable
  - `name` string
  - `description` string, nullable
  - `value` number — Order amount.
  - `fee_value` number, nullable
  - `fee_percent` number, nullable
  - `currency` string
  - `amount` string — Formatted amount with currency symbol.
  - `payin_amount` string, nullable
  - `payout_amount` string, nullable
  - `fee_amount` string, nullable
  - `shipping_amount` string, nullable
  - `buyer_link` string, uri — Payment URL to share with the buyer.
  - `seller_link` string, uri — Acceptance URL to share with the seller.
  - `qr_link` string, uri — QR code image URL for the order.
  - `status` 'DRAFT' | 'PENDING_DETAILS' | 'PENDING_PUBLISH' | 'PUBLISHED' | 'ACCEPTED' | 'REJECTED' | 'CANCELLED' | 'RELEASED'
  - `sandbox` boolean
  - `status_nicename` string — Human-readable status label.
  - `images` string[]
  - `tag` string, nullable
  - `payin_intents` integer, nullable
  - `payin_types` string[], nullable
  - `payin_fallback` string[], nullable
  - `metadata` object, nullable
  - `template` object, nullable
  - `published_units` integer, nullable
  - `refund` object
    - `status` string, nullable
    - `reference_id` string, nullable
  - `created_at` string, date-time, nullable
  - `published_at` string, date-time, nullable — When the order was paid.
  - `accepted_at` string, date-time, nullable
  - `shipping_at` string, date-time, nullable
  - `cancelled_at` string, date-time, nullable
  - `validated_at` string, date-time, nullable
  - `released_at` string, date-time, nullable
  - `connections` Connections — Hypermedia links to related resources.

## Other responses

- `422` — Validation error

## Changes

- **2026-03-11** `ff825f6602c8` — 6 info
  - added the new optional request property `buyer_id`
  - added the new optional request property `template/btn_submit_text`
  - added the new optional request property `template/expires_in`
  - added the new optional request property `template/hide_cardholder`
  - …2 more

[Change history](https://skmtc.dev/truust-io/apis/truust-api/changes/orders/:id/put.md)

---

[API](https://skmtc.dev/truust-io/apis/truust-api.md) · [All operations](https://skmtc.dev/truust-io/apis/truust-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/truust-io/truust-api/revisions/cc81e28726b9/schema)