GoDaddy
Support
API ReferenceShoppingShopping APICheckoutUpdate a checkout session PUT

Update a checkout session

View as Markdown

Replace the writable checkout session state.

Full description

Replace the writable checkout session state. Send the full line_items[] collection on every request. Omitted writable values are cleared, and server-generated fields are ignored. For POS and hardware products, retain the commerce_location input. If a submitted product cannot be priced, the response excludes it and includes a line_item_removed warning.

PUT
/checkout-sessions/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

Personal Access Token presented through Authorization: Bearer $GODADDY_PAT. The PAT must include the scope documented for the operation.

In: header

Path Parameters

id*string

The unique identifier of the checkout session.

Header Parameters

Request-Id*string

For tracing the request across network layers and components.

Formatuuid
Idempotency-Key*string

Ensures duplicate operations don't happen during retries.

Request Body

application/json

Shared UCP 2026-04-08 writable Checkout fields for create and update requests.

Response Body

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/checkout-sessions/string" \  -H "Request-Id: 6ba7b810-9dad-41d1-80b4-00c04fd430c8" \  -H "Idempotency-Key: 2f6f5b2b-6764-4a62-93f0-703980f08180" \  -H "Content-Type: application/json" \  -d '{    "line_items": [      {        "id": "li_hosting_1",        "item": {          "id": "hosting-deluxeapi:1mo"        },        "quantity": 1      }    ],    "payment": {      "instruments": [        {          "id": "profile_mastercard",          "handler_id": "com.godaddy.payments",          "type": "card",          "selected": true        }      ]    }  }'

{  "ucp": {    "version": "2026-04-08",    "capabilities": {      "dev.ucp.shopping.checkout": [        {          "version": "2026-04-08"        }      ],      "com.godaddy.shopping.input": [        {          "version": "2026-04-08"        }      ],      "com.godaddy.shopping.catalog_offer": [        {          "version": "2026-04-08"        }      ]    },    "payment_handlers": {      "com.godaddy.payments": [        {          "id": "com.godaddy.payments",          "version": "2026-04-08"        }      ]    }  },  "id": "d9cf79e3-b39b-4e58-8f30-ddfe1619e969",  "line_items": [    {      "id": "li_1",      "item": {        "id": "hosting-deluxeapi:1mo",        "title": "Web Hosting Deluxe — 1 Month",        "price": 1099      },      "quantity": 1,      "totals": [        {          "type": "subtotal",          "amount": 1099        },        {          "type": "total",          "amount": 1099        }      ]    }  ],  "status": "ready_for_complete",  "currency": "USD",  "totals": [    {      "type": "subtotal",      "amount": 1099    },    {      "type": "total",      "amount": 1099    }  ],  "links": [    {      "type": "privacy_policy",      "url": "https://www.godaddy.com/legal/agreements/privacy-policy"    },    {      "type": "terms_of_service",      "url": "https://www.godaddy.com/legal/agreements/terms-of-service"    }  ],  "payment": {    "instruments": [      {        "id": "profile_visa",        "handler_id": "com.godaddy.payments",        "type": "card",        "selected": true,        "display": {          "brand": "visa",          "last_digits": "4242"        }      },      {        "id": "profile_mastercard",        "handler_id": "com.godaddy.payments",        "type": "card",        "selected": false,        "display": {          "brand": "mastercard",          "last_digits": "4444"        }      }    ]  }}

Last updated on

How is this guide?