> ## Documentation Index > Fetch the complete documentation index at: https://docs.crossmint.com/llms.txt > Use this file to discover all available pages before exploring further. # Edit Order > Edit an existing order. You can update the recipient, the payment method, and/or the locale. **API scope required**: `orders.update` ## OpenAPI ````yaml patch /2022-06-09/orders/{orderId} openapi: 3.0.1 info: description: | N/A version: 1.0.0 title: Headless Checkout contact: name: Crossmint Headless Checkout APIs url: https://www.crossmint.com email: support@crossmint.com servers: - url: https://staging.crossmint.com/api description: Staging environment (testnets) - url: https://www.crossmint.com/api description: Production environment (mainnets) security: [] tags: - name: Headless Checkout description: APIs to use the headless checkout paths: /2022-06-09/orders/{orderId}: patch: tags: - Headless summary: Edit Order description: > Edit an existing order. You can update the recipient, the payment method, and/or the locale. **API scope required**: `orders.update` operationId: edit-order parameters: - $ref: '#/components/parameters/orderId' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/OrderDTO' responses: '200': description: Order successfully created. content: application/json: schema: $ref: '#/components/schemas/OrderObject' '400': description: >- Invalid arguments, please make sure you're following the api specification. content: application/json: schema: $ref: '#/components/schemas/400Response' '403': description: Forbidden error, please ensure the credentials are correct. content: application/json: schema: $ref: '#/components/schemas/403Response' '404': description: Not found error. content: application/json: schema: $ref: '#/components/schemas/404Response' '503': description: >- Please try again in a few minutes. If the issue still persists, contact Crossmint support. content: application/json: schema: $ref: '#/components/schemas/503Response' '524': description: A timeout occurred. content: application/json: schema: $ref: '#/components/schemas/524Response' security: - apiKey: [] - orderClientSecret: [] components: parameters: orderId: name: orderId in: path description: | This is the identifier for the order with UUID format. **Example:** `9c82ef99-617f-497d-9abb-fd355291681b` required: true schema: type: string schemas: OrderDTO: type: object additionalProperties: false properties: recipient: $ref: '#/components/schemas/Recipient' locale: $ref: '#/components/schemas/Locale' payment: $ref: '#/components/schemas/Payment' OrderObject: type: object properties: orderId: type: string example: b2959ca5-65e4-466a-bd26-1bd05cb4f837 phase: type: string example: payment locale: type: string example: en-US lineItems: type: array items: type: object properties: chain: type: string example: polygon-amoy quantity: type: number example: 1 callData: type: object properties: quantity: type: number example: 1 ADDITIONAL_PROPERTIES: type: string example: Your other mint function arguments metadata: type: object properties: name: type: string example: Headless Checkout Demo description: type: string example: NFT Description imageUrl: type: string example: https://cdn.io/image.png quote: type: object properties: status: type: string example: valid charges: type: object properties: unit: type: object properties: amount: type: string example: '0.0001' currency: type: string example: eth salesTax: type: object description: Sales tax applied to physical product purchases properties: amount: type: string example: '0.34' currency: type: string example: usdc shipping: type: object description: Shipping costs for physical product purchases properties: amount: type: string example: '0' currency: type: string example: usdc totalPrice: type: object properties: amount: type: string example: '0.0001' currency: type: string example: eth delivery: type: object properties: status: type: string enum: - awaiting-payment - in-progress - completed - failed description: >- Status of the delivery. 'awaiting-payment': Initial state before payment is made. 'in-progress': Payment received, transaction submitted but not yet completed. 'completed': Successfully delivered with transaction ID and tokens. 'failed': Delivery failed, typically for refunded transactions. example: awaiting-payment recipient: type: object properties: locator: type: string example: email:: email: type: string example: testy@crossmint.com walletAddress: type: string example: 0x1234abcd... txId: type: string description: >- The blockchain transaction ID. Only present when status is 'completed'. example: >- 0x2e69f11dae7869b92e3d5eaf4cadd50c48b5c6803d1232815f979d744521ad4c tokens: type: array description: >- Array of tokens delivered. Only present when status is 'completed'. items: type: object properties: locator: type: string description: >- Universal token locator in the format chain:address:tokenId example: polygon:0xE04Cf294985282Ddc088E6433c064cfB85eD9EdA:3 contractAddress: type: string description: The contract address (EVM chains) example: '0xE04Cf294985282Ddc088E6433c064cfB85eD9EdA' tokenId: type: string description: The token ID (EVM chains) example: '3' mintHash: type: string description: The mint hash or address (Solana) example: MintHashAbc123 quantity: type: string description: >- The quantity of tokens delivered in smallest units (optional, only for fungible tokens in exact-in mode) example: '1500000' symbol: type: string description: >- The token symbol (optional, only when quantity is present) example: USDC decimals: type: number description: >- The number of decimals for the token (optional, only when quantity is present) example: 6 quote: type: object properties: status: type: string enum: - valid - expired - all-line-items-unavailable - requires-physical-address description: >- Status of the quote. 'requires-physical-address' indicates that a shipping address is required for physical products. example: valid quotedAt: type: string example: '2024-06-07T16:55:44.653Z' expiresAt: type: string example: '2024-06-07T17:55:44.653Z' totalPrice: type: object properties: amount: type: string example: '0.0001375741' currency: type: string example: eth payment: type: object properties: status: type: string enum: - requires-kyc - failed-kyc - manual-kyc - awaiting-payment - requires-recipient - requires-crypto-payer-address - failed - in-progress - completed description: >- Status of the payment. View the status codes for more information. example: awaiting-payment method: type: string example: base-sepolia currency: type: string example: eth preparation: type: object properties: chain: type: string example: base-sepolia payerAddress: type: string example: 0x1234abcd... serializedTransaction: type: string example: 0x02f90..... 400Response: type: object properties: error: type: boolean example: true message: type: string description: Human-readable error message describing what went wrong code: type: string description: Machine-readable error code for programmatic handling enum: - single_purchase_exceeded - daily_transaction_exceeded - token_daily_volume_exceeded parameters: type: object description: Additional parameters providing context for the error properties: amount: type: string description: Transaction amount that caused the error limit: type: string description: The limit that was exceeded hoursUntilReset: type: string description: Hours until the limit resets remainingAmount: type: string description: Remaining amount available before hitting the limit 403Response: type: object properties: error: type: boolean example: true message: type: string example: Malformed API key. / API key provided doesn't have required scopes. 404Response: type: object properties: error: type: boolean example: true message: type: string example: Not found 503Response: type: object properties: error: type: boolean example: true message: type: string example: >- Please try again in a few minutes. If the issue still persists, contact Crossmint support. 524Response: type: object properties: error: type: boolean example: true message: type: string example: A timeout occurred. Recipient: oneOf: - type: object title: Email properties: email: type: string format: email physicalAddress: type: object properties: name: type: string description: Full name of the recipient line1: type: string description: Street address, P.O. box, company name, c/o line2: type: string description: Apartment, suite, unit, building, floor, etc. city: type: string description: City, district, suburb, town, or village state: type: string description: >- State, county, province, or region. Required for US addresses. postalCode: type: string description: ZIP or postal code country: type: string description: >- Two-letter country code (ISO 3166-1 alpha-2). Currently only US is supported. required: - name - line1 - city - postalCode - country description: >- Physical shipping address for the recipient. Required when purchasing physical products. required: - email additionalProperties: false description: >- Recipient of the items being purchased. Crossmint will create a custodial wallet address for the user on the fly, that they can later log in to. If no recipient is passed, an order will be created with the status 'requires-recipient', until you pass one. - type: object title: Wallet properties: walletAddress: type: string physicalAddress: type: object properties: name: type: string description: Full name of the recipient line1: type: string description: Street address, P.O. box, company name, c/o line2: type: string description: Apartment, suite, unit, building, floor, etc. city: type: string description: City, district, suburb, town, or village state: type: string description: >- State, county, province, or region. Required for US addresses. postalCode: type: string description: ZIP or postal code country: type: string description: >- Two-letter country code (ISO 3166-1 alpha-2). Currently only US is supported. required: - name - line1 - city - postalCode - country description: >- Physical shipping address for the recipient. Required when purchasing physical products. required: - walletAddress additionalProperties: false description: >- Recipient of the items being purchased. If specifying a recipient by wallet address, ensure the address is valid for the chain your **collection** is on, which may differ from the chain the payment is performed on. Locale: default: en-US type: string enum: - en-US - es-ES - fr-FR - it-IT - ko-KR - pt-PT - ja-JP - zh-CN - zh-TW - de-DE - ru-RU - tr-TR - uk-UA - th-TH - vi-VN - Klingon example: en-US description: >- Locale for the checkout, in IETF BCP 47. It impacts the email receipt language. Ensure your UI is set to the same language as specified here. Throws an error if passed an invalid language. Payment: discriminator: propertyName: method oneOf: - type: object title: EVM additionalProperties: false properties: receiptEmail: type: string format: email description: Email that the receipt will be sent to. method: type: string enum: - arbitrum-sepolia - base-sepolia - ethereum-sepolia - optimism-sepolia - arbitrum - bsc - ethereum - optimism currency: type: string enum: - eth - usdc - degen - brett - toshi - usdxm - credit payerAddress: type: string pattern: ^0x[0-9a-fA-F]{40}$ description: An EVM wallet address. required: - method - currency - type: object title: Solana additionalProperties: false properties: receiptEmail: type: string format: email description: Email that the receipt will be sent to. method: type: string enum: - solana currency: type: string enum: - sol - usdc - bonk payerAddress: type: string pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ description: A Solana public key. required: - method - currency - type: object title: Fiat additionalProperties: false properties: receiptEmail: type: string format: email description: Email that the receipt will be sent to. method: type: string enum: - card currency: default: usd type: string enum: - usd - eur - aud - gbp - jpy - sgd - hkd - krw - inr - vnd required: - method securitySchemes: apiKey: type: apiKey name: X-API-KEY in: header orderClientSecret: type: apiKey name: Authorization in: header ````