Skip to main content
PUT
/
checkout
Update checkout data
curl --request PUT \
  --url {protocol}://{host}/wp-json/cocart/preview/checkout \
  --header 'Content-Type: application/json' \
  --data '
{
  "billing_address": {
    "first_name": "<string>",
    "last_name": "<string>",
    "company": "<string>",
    "address_1": "<string>",
    "address_2": "<string>",
    "city": "<string>",
    "state": "<string>",
    "postcode": "<string>",
    "country": "<string>",
    "phone": "<string>",
    "email": "jsmith@example.com"
  },
  "shipping_address": {
    "first_name": "<string>",
    "last_name": "<string>",
    "company": "<string>",
    "address_1": "<string>",
    "address_2": "<string>",
    "city": "<string>",
    "state": "<string>",
    "postcode": "<string>",
    "country": "<string>"
  },
  "payment_method": "<string>",
  "shipping_method": "<string>",
  "currency": "EUR"
}
'
{
  "cart_key": "abc123def456",
  "cart_hash": "d41d8cd98f00b204e9800998ecf8427e",
  "currency": {
    "code": "USD",
    "symbol": "$",
    "base_currency": "USD",
    "exchange_rate": 1
  },
  "customer_id": 123,
  "billing_address": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "john@example.com",
    "phone": "+1234567890",
    "address_1": "123 Main St",
    "address_2": "Apt 4B",
    "city": "Anytown",
    "state": "CA",
    "postcode": "12345",
    "country": "US",
    "company": ""
  },
  "shipping_address": {
    "first_name": "John",
    "last_name": "Doe",
    "address_1": "123 Main St",
    "address_2": "Apt 4B",
    "city": "Anytown",
    "state": "CA",
    "postcode": "12345",
    "country": "US",
    "company": ""
  },
  "cart_contents": {
    "c4ca4238a0b923820dcc509a6f75849b": {
      "key": "c4ca4238a0b923820dcc509a6f75849b",
      "product_id": 456,
      "variation_id": 0,
      "quantity": 2,
      "product_name": "Premium T-Shirt",
      "product_title": "Premium T-Shirt",
      "product_price": "$19.99",
      "line_total": "39.98",
      "line_subtotal": "39.98"
    }
  },
  "cart_totals": {
    "subtotal": "39.98",
    "subtotal_tax": "0.00",
    "shipping_total": "5.00",
    "shipping_tax": "0.00",
    "discount_total": "0.00",
    "discount_tax": "0.00",
    "cart_contents_total": "39.98",
    "cart_contents_tax": "0.00",
    "fee_total": "0.00",
    "fee_tax": "0.00",
    "total": "44.98",
    "total_tax": "0.00"
  },
  "shipping_methods": {
    "flat_rate:1": {
      "id": "flat_rate:1",
      "label": "Flat Rate",
      "cost": "5.00",
      "method_id": "flat_rate",
      "instance_id": "1"
    }
  },
  "needs_payment": true,
  "needs_shipping": true,
  "payment_method": "stripe"
}
This endpoint is currently shown as a preview of what’s currently in development and is subject to change.

​
Overview

This endpoint updates checkout information such as billing/shipping addresses, payment method, or shipping method. Both PUT and PATCH methods are supported and function identically.

Body

application/json

Checkout data to update

​
billing_address
object
​
shipping_address
object
​
payment_method
string

Payment method ID

​
shipping_method
string

Shipping method ID

​
currency
string

Currency code for the order (e.g., USD, EUR, GBP). If not provided, store default will be used.

Pattern: ^[A-Z]{3}$
Example:

"EUR"

Response

Checkout data updated successfully

​
cart_key
string | null

Unique identifier for the cart session

​
cart_hash
string

MD5 hash of cart contents

​
currency
object

Currency information including code, symbol, and exchange rate

​
customer_id
integer

Customer ID, if logged in

​
billing_address
object
​
shipping_address
object
​
cart_contents
object

Cart contents with product details

​
cart_totals
object
​
shipping_methods
object

Available shipping methods

​
needs_payment
boolean

Whether the cart needs payment

​
needs_shipping
boolean

Whether the cart needs shipping

​
payment_method
string

Selected payment method