---
updatedAt: 2026-09-04T11:23:53.000Z
agentTools:
  projectIndex: https://docs.us.zip.co/llms.txt
---

# Retrieve a checkout

Sandbox (Testing): https://global-api.sand.au.edge.zip.co/merchant/checkouts/{Id}

Retrieves the details of a checkout that has previously been created. Supply the unique checkout ID that was returned from your previous request, and Zip will return the corresponding checkout information.

## /checkouts/{Id}

## Useful Notes

* Call this method on your redirect\_uri page, when charging or creating a token if you don’t have server-side session handling to get full cart, customer details, and metadata.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "single-merchant-interface-smi-api",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://global-api.prod.au.edge.zip.co/merchant"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/checkouts/{Id}": {
      "get": {
        "summary": "Retrieve a checkout",
        "description": "Sandbox (Testing): https://global-api.sand.au.edge.zip.co/merchant/checkouts/{Id}\n\nRetrieves the details of a checkout that has previously been created. Supply the unique checkout ID that was returned from your previous request, and Zip will return the corresponding checkout information.",
        "operationId": "checkoutsid",
        "parameters": [
          {
            "name": "Id",
            "in": "path",
            "description": "The unique identifier of the checkout",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "description": "Bearer {{API key}}",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n   \"id\":\"co_P9GOgSVE9qMnL0VA6Jy8z6\",\n   \"uri\": \"https://gateway.sand.us.zip.co/orders/authorize?orderId=eaa26ff3-eba9-4598-a493-86c263b5a239&merchantId=5901c42b-f41f-476b-a2d4-7d4bc383f7db&merchantReference=ref_1646065022&order.orderNumber=220228-857819&order.firstName=Test&order.lastName=Tester&order.email=firstname.lastname%2b1646065022%40domain.com&order.phone=4154154455&order.billingAddress.line1=10+Spring+St&order.billingAddress.city=New+york&order.billingAddress.state=New+york&order.billingAddress.postalCode=1000&order.billingAddress.country=US&order.amount=200&capture=False&callbackUrl=https%3a%2f%2fapi-ut.quadpay.com%2forder%2fcomplete&redirectCancelUrl=https%3a%2f%2fapi-ut.quadpay.com%3a443%2forder%2fcancel%3forderId%3deaa26ff3-eba9-4598-a493-86c263b5a239&redirectConfirmUrl=https%3a%2f%2fapi-ut.quadpay.com%2forder%2fcomplete&metadata.confirmUrl=https%3a%2f%2fglobal-api.sand.au.edge.zip.co%3a443%2fmerchant%2fcallback%3fredirect%3dhttps%253A%252F%252Flocalhost%252Fzip_order_complete%26region%3dus%26ppStatus%3dsuccess%26token%3deaa26ff3-eba9-4598-a493-86c263b5a239%26OrderStatus%3dApproved&metadata.cancelUrl=https%3a%2f%2fglobal-api.sand.au.edge.zip.co%3a443%2fmerchant%2fcallback%3fredirect%3dhttps%253A%252F%252Flocalhost%252Fzip_order_complete%26region%3dus%26ppStatus%3dcancelled%26token%3deaa26ff3-eba9-4598-a493-86c263b5a239%26OrderStatus%3dAbandoned&X-QP-Signature=vlf4pW8hded1b0FbKWVNAuInTMQmHBuMkdMoDX6kEt0%3d\",\n   \"type\":\"standard\",\n   \"shopper\":{\n      \"title\":\"Mr\",\n      \"first_name\":\"John\",\n      \"last_name\":\"Smith\",\n      \"middle_name\":\"Joe\",\n      \"phone\":\"0400000000\",\n      \"email\":\"test@emailaddress.com\",\n      \"birth_date\":\"2017-10-10\",\n      \"gender\":\"Male\",\n      \"billing_address\":{\n         \"line1\":\"10 Test st\",\n         \"city\":\"New York\",\n         \"state\":\"NY\",\n         \"postal_code\":\"10001\",\n         \"country\":\"US\",\n         \"first_name\":\"John\",\n         \"last_name\":\"Smith\"\n      }\n   },\n   \"order\":{\n      \"reference\":\"testcheckout1\",\n      \"amount\":200,\n      \"currency\":\"USD\",\n      \"shipping\":{\n         \"pickup\":false,\n         \"address\":{\n            \"line1\":\"10 Test st\",\n            \"city\":\"New York\",\n            \"state\":\"NY\",\n            \"postal_code\":\"10001\",\n            \"country\":\"US\",\n         }\n      },\n      \"items\":[\n         {\n            \"name\":\"Awesome shoes\",\n            \"amount\":200,\n            \"reference\":\"1\",\n            \"quantity\":1,\n            \"type\":\"sku\"\n         }\n      ]\n   },\n   \"metadata\":{\n      \"name1\":\"value1\"\n   },\n   \"created\":\"2018-05-07T05:37:56.4794801Z\",\n   \"state\":\"created\",\n   \"config\":{\n      \"https://localhost/zip_order_complete\"\n   }\n}"
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```