> ## Documentation Index > Fetch the complete documentation index at: https://docs.truust.io/llms.txt > Use this file to discover all available pages before exploring further. # Update Order > Updates an order's details. After payment, only `metadata`, `fee_value`, and `fee_percent` can be changed. ## OpenAPI ````yaml PUT /orders/{id} openapi: 3.1.0 info: title: Truust API version: '2.0' description: > The Truust API allows you to manage payment flows, orders, customers, wallets, and more. ## Authentication All authenticated endpoints require a Bearer token using your account's **Secret Key**. ``` Authorization: Bearer {your_secret_key} ``` Your API keys are available in the Dashboard under **Account Settings → API Developers**. contact: email: hello@truust.io license: name: Proprietary servers: - url: https://{subdomain}.truust.io/2.0 description: Production variables: subdomain: default: your-subdomain description: Your account subdomain - url: https://{subdomain}-sandbox.truust.io/2.0 description: Sandbox variables: subdomain: default: your-subdomain description: Your account subdomain security: - bearerAuth: [] tags: - name: Account description: Manage your Truust account - name: Customers description: Manage buyers and sellers (end users) - name: Orders description: Create and manage escrow payment orders - name: Payins description: Manage incoming payments for orders - name: Payouts description: Manage outgoing payments from orders - name: Wallets description: Manage customer and account wallets - name: Bank Accounts description: Manage bank accounts for payouts - name: Cards description: Manage tokenized payment cards - name: Subscriptions description: Manage recurring payment subscriptions - name: Verifications description: KYC verification for customers and accounts - name: Bundles description: Manage product bundles for orders - name: Refunds description: View refund records paths: /orders/{id}: put: tags: - Orders summary: Update order description: >- Updates an order's details. After payment, only `metadata`, `fee_value`, and `fee_percent` can be changed. operationId: updateOrder parameters: - $ref: '#/components/parameters/OrderId' requestBody: required: true content: application/json: schema: type: object example: name: Demo Order value: 15 properties: buyer_id: type: integer description: Customer ID of the buyer. name: type: string maxLength: 120 value: type: number minimum: 0 fee_value: type: number minimum: 0 fee_percent: type: number minimum: 0 maximum: 100 tag: type: string maxLength: 100 metadata: type: object additionalProperties: true template: type: object description: Custom template data for the checkout page. properties: btn_submit_text: type: string iframe_title: type: string expires_in: type: integer hide_cardholder: type: boolean password_cvv: type: boolean images: type: array maxItems: 10 items: type: string responses: '200': description: Updated order content: application/json: schema: $ref: '#/components/schemas/OrderResponse' '422': $ref: '#/components/responses/ValidationError' components: parameters: OrderId: name: id in: path required: true schema: type: integer description: Order ID. schemas: OrderResponse: type: object properties: id: type: integer self: type: string example: /2.0/orders/1234 public_id: type: string nullable: true name: type: string description: type: string nullable: true value: type: number description: Order amount. fee_value: type: number nullable: true fee_percent: type: number nullable: true currency: type: string example: EUR amount: type: string description: Formatted amount with currency symbol. example: 150.00 € payin_amount: type: string nullable: true payout_amount: type: string nullable: true fee_amount: type: string nullable: true shipping_amount: type: string nullable: true buyer_link: type: string format: uri description: Payment URL to share with the buyer. seller_link: type: string format: uri description: Acceptance URL to share with the seller. qr_link: type: string format: uri description: QR code image URL for the order. status: type: string enum: - DRAFT - PENDING_DETAILS - PENDING_PUBLISH - PUBLISHED - ACCEPTED - REJECTED - CANCELLED - RELEASED sandbox: type: boolean status_nicename: type: string description: Human-readable status label. images: type: array items: type: string tag: type: string nullable: true payin_intents: type: integer nullable: true payin_types: type: array nullable: true items: type: string payin_fallback: type: array nullable: true items: type: string metadata: type: object nullable: true additionalProperties: true template: type: object nullable: true additionalProperties: true published_units: type: integer nullable: true refund: type: object properties: status: type: string nullable: true reference_id: type: string nullable: true created_at: type: string format: date-time nullable: true published_at: type: string format: date-time nullable: true description: When the order was paid. accepted_at: type: string format: date-time nullable: true shipping_at: type: string format: date-time nullable: true cancelled_at: type: string format: date-time nullable: true validated_at: type: string format: date-time nullable: true released_at: type: string format: date-time nullable: true connections: $ref: '#/components/schemas/Connections' Connections: type: object description: Hypermedia links to related resources. additionalProperties: type: string responses: ValidationError: description: Validation error content: application/json: schema: type: object properties: message: type: string example: The given data was invalid. errors: type: object additionalProperties: type: array items: type: string example: name: - The name field is required. securitySchemes: bearerAuth: type: http scheme: bearer description: Use your account's **Secret Key** as the Bearer token. ````