Checkout

If you're building an app with the Sales Channel SDK, then you can use the Checkout API to let customers purchase products from Shopify stores that install your sales channel. You can also use this API to customize the checkout user experience for your sales channel, while taking full advantage of the commerce engine that powers every Shopify store.

Shopify uses a Checkout object to manage a user's cart as it transitions to a paid order. This process includes calculating taxes and shipping rates, attaching a shipping address, and associating one or more payments. For a detailed tutorial that walks you through the key capabilities of the Checkout API, see Sell through the Checkout API.

Note

You can't use the Checkout API to create a new checkout user experience for an individual store. For that you need to use an SDK that's powered by the Storefront API instead, such as the JavaScript Buy, iOS Buy, and Android Buy SDKs.

The Checkout API can be used only with direct payment gateways. For a list of all supported payment gateways, see Direct and external credit card payment providers.

What you can do with Checkout

The Shopify API lets you do the following with the Checkout resource. More detailed versions of these general actions may be available:

Checkout properties

applied_discount
"applied_discount": {
  "amount": "30.00",
  "title": "XYZ Promotion",
  "description": "Promotional item for blackfriday.",
  "value": "30.00",
  "value_type": "fixed_amount",
  "non_applicable_reason": null,
  "applicable": true
}

The discount metadata generated by applying a discount code. A custom discount can also be added by specifying values for amount, title, description, value, and value_type.

  • amount: The amount that is deducted from payment_due.
  • title: The title to categorize the applied discount.
  • description: The description of the applied discount.
  • value: The value that was used to calculate the final applied discount amount.
  • value_type: The type of value that was used to calculate the final applied discount amount. Valid values: fixed_amount and percentage.
  • non_applicable_reason: The reason why the discount is not applicable, if the discount cannot be applied to the checkout.
  • applicable: Whether this discount code can be applied to the checkout.

billing_address
"billing_address": {
  "address1": "Chestnut Street 92",
  "address2": "Suite 300",
  "city": "Louisville",
  "company": null,
  "country": "US",
  "first_name": null,
  "id": 207119551,
  "last_name": null,
  "phone": "555-625-1199",
  "province": "KY",
  "zip": "40202",
  "province_code": null,
  "country_code": null
}

The mailing address associated with the payment method. It has the following properties:

  • address1: The street address of the billing address.
  • address2: An optional additional field for the street address of the billing address.
  • city: The city of the billing address.
  • company: The company of the person associated with the billing address.
  • country: The name of the country of the billing address.
  • country_code: The two-letter code (ISO 3166-1 alpha-2 format) for the country of the billing address.
  • first_name: The first name of the person associated with the payment method.
  • last_name: The last name of the person associated with the payment method.
  • phone: The phone number at the billing address.
  • province: The name of the state or province of the billing address.
  • province_code: The two-letter abbreviation of the state or province of the billing address.
  • zip: The zip or postal code of the billing address.

buyer_accepts_marketing
"buyer_accepts_marketing": false

Whether the customer has consented to receive marketing material via email.

created_at
"created_at": "2008-01-10T11:00:00-05:00"

The date and time (ISO 8601 format) when the checkout was created.

currency
"currency": "USD"

The three-letter code (ISO 4217 format) for the currency used for the payment.

customer_id
"customer_id": 1234

The ID of the customer associated with this checkout.

discount_code
"discount_code": "30_DOLLARS_OFF"

The discount code that is applied to the checkout. This populates applied_discount with the appropriate metadata for that discount code. To remove a discount code, send an empty string or null.

email
"email": "bob.norman@hostmail.com"

The customer's email address. A checkout needs to have a value for email or phone before it can be completed.

gift_cards
"gift_cards": [
  {
    "amount_used": "30.00",
    "balance": "70.00",
    "id": 1014759463,
    "last_characters": "abdr"
  }
]

A list of gift card objects, each containing information about a gift card applied to this checkout. Gift cards can be applied to a checkout by passing { "checkout": { "gift_cards": [{ "code": "a gift card code" }, { "code": "another gift card code" }] } }. Each gift card object has the following properties:

  • amount_used: The amount of the gift card used by this checkout.
  • code: The gift card code.
  • balance: The amount left on the gift card after being applied to this checkout.
  • id: The ID for the applied gift card.
  • last_characters: The last four characters of the applied gift card for display back to the user.
Updating the gift card list overwrites any previous list already defined in the checkout. To remove a gift card from the list of applied gift cards, re-apply the gift_cards array without that gift card.

line_items
"line_items": [
  {
    "compare_at_price": "9.99",
    "fulfillment_service": "manual",
    "grams": "20",
    "id": 39072856,
    "line_price": "19.99",
    "price": "19.99",
    "product_id": 632910392,
    "quantity": "",
    "requires_shipping": false,
    "sku": "IPOD2008GREEN",
    "taxable": true,
    "title": "IPod Nano - 8GB",
    "variant_id": 39072856,
    "variant_title": "Green",
    "vendor": "Apple"
  }
]

A list of line item objects, each containing information about an item in the checkout. Each line item object has the following properties:

  • compare_at_price: The original selling price of the product, if applicable.
  • fulfillment_service: If the variant is a gift card, allows to override the fulfillment service so the gift card can be activated with a custom code. Valid values: manual.
  • grams: The weight of the item in grams.
  • id: The checkout-specific ID of the line item.
  • line_price: The line price of the item, based on price multiplied by quantity.
  • price: The price of the item.
  • product_id: The product of the line item.
  • properties: The customization information for a line item (optional).
  • quantity: The number of products that were purchased.
  • requires_shipping: Whether the fulfillment requires shipping.
  • sku: The unique identifier of the item in the fulfillment.
  • taxable: Whether this product is taxable.
  • title: The title of the product.
  • variant_id: The variant ID of the line item.
  • variant_title: The title of the product variant.
  • vendor: The name of the item's supplier.

order
"order": {
  "id": 123,
  "name": "#0123",
  "status_url": "https://checkout.shopify.com/123/checkouts/4207896aad57dfb159?key=123abc"
}

An object containing the ID, name, and status page URL of the associated order when the checkout is complete. Default value: null.

payment_due
"payment_due": "99.95"

The amount left to be paid. This is equal to the sum of the checkout line prices, taxes, and shipping minus discounts and gift cards.

payment_url
"payment_url": "https://elb.deposit.shopifycs.com/sessions"

The URL that must be used to store credit cards in Shopify's card vault. These URLs are subject to change, so you should always use the one supplied here. The general pattern for the URLs is https://elb.deposit.shopifycs.com/sessions.

phone
"phone": "+13125551212"

The customer's phone number. A checkout needs to have a value for email or phone before it can be completed.

requires_shipping
"requires_shipping": true

Whether the checkout requires shipping. If true, then shipping_line must be set before creating a payment.

reservation_time
"reservation_time": null

The reservation time in seconds for the line item products. Default value: null. This property is not writable.

reservation_time_left
"reservation_time_left": 0

The time in seconds that the line item products will be held. Default value: 0. This property is not writable.

shipping_address
"shipping_address": {
  "address1": "Chestnut Street 92",
  "address2": "Apt 2",
  "city": "Louisville",
  "company": null,
  "country": "United States",
  "first_name": "Bob",
  "last_name": "Norman",
  "phone": "555-625-1199",
  "province": "Kentucky",
  "zip": "40202",
  "country_code": "US",
  "province_code": "KY"
}

The mailing address to where the checkout will be shipped. It has the following properties:

  • address1: The street address of the shipping address.
  • address2: An optional additional field for the street address of the shipping address.
  • city: The city of the shipping address.
  • company: The company of the person associated with the shipping address.
  • country: The name of the country of the shipping address.
  • country_code: The two-letter code (ISO 3166-1 alpha-2 format) for the country of the shipping address.
  • first_name: The first name of the person associated with the shipping address.
  • last_name: The last name of the person associated with the shipping address.
  • phone: The phone number at the shipping address.
  • province: The name of the state or province of the shipping address.
  • province_code: The two-letter abbreviation of the state or province of the shipping address.
  • zip: The zip or postal code of the shipping address.

shipping_line
"shipping_line": {
  "handle": "shopify-Standard-10.00",
  "price": "10.00",
  "title": "Standard"
}

The selected shipping rate. If the customer decides to pick a different shipping rate, then the shipping lines on checkouts can be updated via the API by updating the value for handle. Learn more about selecting shipping rates.

shipping_rate
"shipping_rate": {
  "id": "shopify-Standard-10.00",
  "price": "10.00",
  "title": "Standard"
}

The selected shipping rate. This property is not writable.

source_name
"source_name": "my_app"

The source of the checkout. Apart from the reserved values of web, pos, iphone, and android, you can set this value to whatever you like.

subtotal_price
"subtotal_price": "398.00"

The price of the checkout before shipping and taxes.

tax_lines
"tax_lines": [
  {
    "price": "11.94",
    "rate": "0.06",
    "title": "State Tax"
  }
]

An array of tax_line objects, each of which represents a tax rate applicable to the checkout. Each tax line object has the following properties:

  • price: The amount of tax to be charged.
  • rate: The rate of tax to be applied.
  • title: The name of the tax.

taxes_included
"taxes_included": false

Whether taxes are included in the subtotal price.

token
"token": "b1946ac92492d2347c6235b4d2611184"

A unique identifier for a particular checkout.

total_price
"total_price": "409.94"

The sum of the the checkout line prices, taxes, shipping costs, and discounts.

total_tax
"total_tax": "11.94"

The sum of all the taxes applied to the checkout.

updated_at
"updated_at": "2012-08-24T14:02:15-04:00"

The date and time (ISO 8601 format format) when the checkout was last modified.

user_id
"user_id": 1234

The ID of the user who created the checkout. This value is passed to the order. Default value: null.

web_url
"web_url": "https://checkout.shopify.com/112233/checkouts/4207896aad57dfb159?key=123abc"

The URL pointing to the checkout accessible from the web.

Endpoints

POST /admin/checkouts.json
Create a checkout

Create a checkout with a product variant and quantity

POST /admin/checkouts.json
{
  "checkout": {
    "line_items": [
      {
        "variant_id": 39072856,
        "quantity": 5
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
Location: https://apple.myshopify.com/admin/checkouts/493e5ce459e420de18cdd31bb4b8fd09.json
{
  "checkout": {
    "clone_url": "https://apple.myshopify.com/690933842/checkouts/493e5ce459e420de18cdd31bb4b8fd09/clone",
    "completed_at": null,
    "created_at": "2018-05-18T18:59:13-04:00",
    "currency": "USD",
    "customer_id": null,
    "customer_locale": "en",
    "device_id": null,
    "discount_code": null,
    "email": null,
    "location_id": null,
    "name": "#1066348319",
    "note": "",
    "note_attributes": {},
    "order_id": null,
    "order_status_url": null,
    "order": null,
    "payment_due": "995.00",
    "payment_url": "https://app.local/cardserver/sessions",
    "payments": [],
    "phone": null,
    "shopify_payments_account_id": null,
    "privacy_policy_url": null,
    "refund_policy_url": null,
    "requires_shipping": true,
    "reservation_time_left": 0,
    "reservation_time": null,
    "source_identifier": null,
    "source_name": "755357713",
    "source_url": null,
    "subtotal_price": "995.00",
    "tax_exempt": false,
    "taxes_included": false,
    "terms_of_service_url": null,
    "token": "493e5ce459e420de18cdd31bb4b8fd09",
    "total_price": "995.00",
    "total_tax": "0.00",
    "total_line_items_price": "995.00",
    "updated_at": "2018-05-18T18:59:13-04:00",
    "user_id": null,
    "web_url": "https://apple.myshopify.com/690933842/checkouts/493e5ce459e420de18cdd31bb4b8fd09",
    "line_items": [
      {
        "id": "649f1b248730bf5261517e279fc7b228",
        "key": "649f1b248730bf5261517e279fc7b228",
        "product_id": 632910392,
        "variant_id": 39072856,
        "sku": "IPOD2008GREEN",
        "vendor": "Apple",
        "title": "IPod Nano - 8GB",
        "variant_title": "Green",
        "image_url": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1526682736",
        "taxable": true,
        "requires_shipping": true,
        "gift_card": false,
        "price": "199.00",
        "compare_at_price": "0.00",
        "line_price": "995.00",
        "properties": {},
        "quantity": 5,
        "grams": 567,
        "fulfillment_service": "manual",
        "applied_discounts": []
      }
    ],
    "gift_cards": [],
    "tax_lines": [],
    "tax_manipulations": [],
    "shipping_line": null,
    "shipping_rate": null,
    "shipping_address": null,
    "credit_card": null,
    "billing_address": null,
    "applied_discount": null
  }
}

Creating a checkout with errors, such as using the ID of a variant that doesn't exist or that isn't published to your sales channel, fails with a 422 response and returns errors

POST /admin/checkouts.json
{
  "checkout": {
    "line_items": [
      {
        "variant_id": 123456789,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "errors": {
    "line_items": {
      "0": {
        "variant_id": [
          {
            "code": "invalid",
            "message": "is invalid",
            "options": {}
          }
        ]
      }
    }
  }
}

Create a checkout without any line items

POST /admin/checkouts.json
{
  "checkout": {
    "email": "me@example.com"
  }
}
View Response
HTTP/1.1 201 Created
Location: https://apple.myshopify.com/admin/checkouts/16c159bfe30e733b66f078c022ce598c.json
{
  "checkout": {
    "clone_url": "https://apple.myshopify.com/690933842/checkouts/16c159bfe30e733b66f078c022ce598c/clone",
    "completed_at": null,
    "created_at": "2018-05-18T18:59:14-04:00",
    "currency": "USD",
    "customer_id": 1073339458,
    "customer_locale": "en",
    "device_id": null,
    "discount_code": null,
    "email": "me@example.com",
    "location_id": null,
    "name": "#1066348320",
    "note": "",
    "note_attributes": {},
    "order_id": null,
    "order_status_url": null,
    "order": null,
    "payment_due": "0.00",
    "payment_url": "https://app.local/cardserver/sessions",
    "payments": [],
    "phone": null,
    "shopify_payments_account_id": null,
    "privacy_policy_url": null,
    "refund_policy_url": null,
    "requires_shipping": false,
    "reservation_time_left": 0,
    "reservation_time": null,
    "source_identifier": null,
    "source_name": "755357713",
    "source_url": null,
    "subtotal_price": "0.00",
    "tax_exempt": false,
    "taxes_included": false,
    "terms_of_service_url": null,
    "token": "16c159bfe30e733b66f078c022ce598c",
    "total_price": "0.00",
    "total_tax": "0.00",
    "total_line_items_price": "0.00",
    "updated_at": "2018-05-18T18:59:14-04:00",
    "user_id": null,
    "web_url": "https://apple.myshopify.com/690933842/checkouts/16c159bfe30e733b66f078c022ce598c",
    "line_items": [],
    "gift_cards": [],
    "tax_lines": [],
    "tax_manipulations": [],
    "shipping_line": null,
    "shipping_rate": null,
    "shipping_address": null,
    "credit_card": null,
    "billing_address": null,
    "applied_discount": null
  }
}

Creating a checkout with line item errors fails and returns the errors mapped by index

POST /admin/checkouts.json
{
  "checkout": {
    "line_items": [
      {
        "variant_id": 39072856,
        "quantity": 1
      },
      {
        "variant_id": 1,
        "quantity": 1
      },
      {
        "variant_id": 1,
        "quantity": 1
      },
      {
        "variant_id": 49148385,
        "quantity": 1
      },
      {
        "variant_id": 1,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "errors": {
    "line_items": {
      "1": {
        "variant_id": [
          {
            "code": "invalid",
            "message": "is invalid",
            "options": {}
          }
        ]
      },
      "2": {
        "variant_id": [
          {
            "code": "invalid",
            "message": "is invalid",
            "options": {}
          }
        ]
      },
      "4": {
        "variant_id": [
          {
            "code": "invalid",
            "message": "is invalid",
            "options": {}
          }
        ]
      }
    }
  }
}
POST /admin/checkouts/b490a9220cd14d7344024f4874f640a6/complete.json
Completes a checkout

Complete a checkout without requiring payment

POST /admin/checkouts/#{token}/complete.json
{
}
View Response
HTTP/1.1 202 Accepted
Location: https://apple.myshopify.com/admin/checkouts/b490a9220cd14d7344024f4874f640a6.json
Retry-After: 1
{
  "checkout": {
    "clone_url": "https://checkout.local/690933842/checkouts/b490a9220cd14d7344024f4874f640a6/clone",
    "completed_at": null,
    "created_at": "2012-10-12T07:05:27-04:00",
    "currency": "USD",
    "customer_id": 207119551,
    "customer_locale": null,
    "device_id": null,
    "discount_code": null,
    "email": "bob.norman@hostmail.com",
    "location_id": null,
    "name": "#86568385",
    "note": "",
    "note_attributes": {
      "custom engraving": "Happy Birthday",
      "colour": "green"
    },
    "order_id": null,
    "order_status_url": null,
    "order": null,
    "payment_due": "0.00",
    "payment_url": "https://app.local/cardserver/sessions",
    "payments": [],
    "phone": null,
    "shopify_payments_account_id": null,
    "privacy_policy_url": null,
    "refund_policy_url": null,
    "requires_shipping": false,
    "reservation_time_left": 0,
    "reservation_time": null,
    "source_identifier": null,
    "source_name": "web",
    "source_url": null,
    "subtotal_price": "0.00",
    "tax_exempt": false,
    "taxes_included": false,
    "terms_of_service_url": null,
    "token": "b490a9220cd14d7344024f4874f640a6",
    "total_price": "0.00",
    "total_tax": "0.00",
    "total_line_items_price": "0.00",
    "updated_at": "2018-05-18T18:59:24-04:00",
    "user_id": null,
    "web_url": "https://checkout.local/690933842/checkouts/b490a9220cd14d7344024f4874f640a6",
    "line_items": [
      {
        "id": 49148385,
        "key": 49148385,
        "product_id": 632910392,
        "variant_id": 49148385,
        "sku": "IPOD2008RED",
        "vendor": "Apple",
        "title": "IPod Nano - 8GB",
        "variant_title": "Red",
        "image_url": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1526682736",
        "taxable": true,
        "requires_shipping": false,
        "gift_card": false,
        "price": "0.00",
        "compare_at_price": null,
        "line_price": "0.00",
        "properties": {},
        "quantity": 1,
        "grams": 200,
        "fulfillment_service": "manual",
        "applied_discounts": []
      }
    ],
    "gift_cards": [],
    "tax_lines": [],
    "tax_manipulations": [],
    "shipping_line": null,
    "shipping_rate": null,
    "shipping_address": {
      "id": 550558813,
      "first_name": "Bob",
      "last_name": "Norman",
      "phone": "555-625-1199",
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "province_code": "KY",
      "country": "United States",
      "country_code": "US",
      "zip": "40202"
    },
    "credit_card": null,
    "billing_address": {
      "id": 550558813,
      "first_name": "Bob",
      "last_name": "Norman",
      "phone": "555-625-1199",
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "province_code": "KY",
      "country": "United States",
      "country_code": "US",
      "zip": "40202"
    },
    "applied_discount": null
  }
}
GET /admin/checkouts/exuw7apwoycchjuwtiqg8nytfhphr62a.json
Retrieves a checkout

Retrieve an existing checkout

GET /admin/checkouts/#{token}.json
View Response
HTTP/1.1 202 Accepted
Location: https://apple.myshopify.com/admin/checkouts/exuw7apwoycchjuwtiqg8nytfhphr62a.json
Retry-After: 1
{
  "checkout": {
    "clone_url": "https://checkout.local/690933842/checkouts/exuw7apwoycchjuwtiqg8nytfhphr62a/clone",
    "completed_at": null,
    "created_at": "2012-10-12T07:05:27-04:00",
    "currency": "USD",
    "customer_id": 207119551,
    "customer_locale": null,
    "device_id": null,
    "discount_code": null,
    "email": "bob.norman@hostmail.com",
    "location_id": null,
    "name": "#862052962",
    "note": "",
    "note_attributes": {
      "custom engraving": "Happy Birthday",
      "colour": "green"
    },
    "order_id": null,
    "order_status_url": null,
    "order": null,
    "payment_due": "419.49",
    "payment_url": "https://app.local/cardserver/sessions",
    "payments": [],
    "phone": null,
    "shopify_payments_account_id": null,
    "privacy_policy_url": null,
    "refund_policy_url": null,
    "requires_shipping": true,
    "reservation_time_left": 0,
    "reservation_time": null,
    "source_identifier": null,
    "source_name": "web",
    "source_url": null,
    "subtotal_price": "398.00",
    "tax_exempt": false,
    "taxes_included": false,
    "terms_of_service_url": null,
    "token": "exuw7apwoycchjuwtiqg8nytfhphr62a",
    "total_price": "419.49",
    "total_tax": "21.49",
    "total_line_items_price": "398.00",
    "updated_at": "2012-10-12T07:05:27-04:00",
    "user_id": null,
    "web_url": "https://checkout.local/690933842/checkouts/exuw7apwoycchjuwtiqg8nytfhphr62a",
    "line_items": [
      {
        "id": "904ae1f852b2ba5c",
        "key": "904ae1f852b2ba5c",
        "product_id": 632910392,
        "variant_id": 49148385,
        "sku": "IPOD2008RED",
        "vendor": "Apple",
        "title": "IPod Nano - 8GB",
        "variant_title": "Red",
        "image_url": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1526682736",
        "taxable": true,
        "requires_shipping": true,
        "gift_card": false,
        "price": "199.00",
        "compare_at_price": null,
        "line_price": "199.00",
        "properties": {},
        "quantity": 1,
        "grams": 200,
        "fulfillment_service": "manual",
        "applied_discounts": []
      },
      {
        "id": "0aa2a23be03397ac",
        "key": "0aa2a23be03397ac",
        "product_id": 632910392,
        "variant_id": 808950810,
        "sku": "IPOD2008PINK",
        "vendor": "Apple",
        "title": "IPod Nano - 8GB",
        "variant_title": "Pink",
        "image_url": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano-2.png?v=1526682736",
        "taxable": true,
        "requires_shipping": true,
        "gift_card": false,
        "price": "199.00",
        "compare_at_price": null,
        "line_price": "199.00",
        "properties": {},
        "quantity": 1,
        "grams": 200,
        "fulfillment_service": "manual",
        "applied_discounts": []
      }
    ],
    "gift_cards": [],
    "tax_lines": [
      {
        "price": "21.49",
        "rate": 0.06,
        "title": "State Tax",
        "compare_at": 0.06
      }
    ],
    "tax_manipulations": [],
    "shipping_line": {
      "handle": "shopify-Free%20Shipping-0.00",
      "price": "0.00",
      "title": "Free Shipping"
    },
    "shipping_rate": {
      "id": "shopify-Free%20Shipping-0.00",
      "price": "0.00",
      "title": "Free Shipping"
    },
    "shipping_address": {
      "id": 550558813,
      "first_name": "Bob",
      "last_name": "Norman",
      "phone": "555-625-1199",
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "province_code": "KY",
      "country": "United States",
      "country_code": "US",
      "zip": "40202"
    },
    "credit_card": null,
    "billing_address": {
      "id": 550558813,
      "first_name": "Bob",
      "last_name": "Norman",
      "phone": "555-625-1199",
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "province_code": "KY",
      "country": "United States",
      "country_code": "US",
      "zip": "40202"
    },
    "applied_discount": null
  }
}

Retrieve a completed checkout

GET /admin/checkouts/#{token}.json
View Response
HTTP/1.1 200 OK
Location: https://apple.myshopify.com/admin/checkouts/bd5a8aa1ecd019dd3520ff791ee3a24c.json
{
  "checkout": {
    "clone_url": "https://checkout.local/690933842/checkouts/bd5a8aa1ecd019dd3520ff791ee3a24c/clone",
    "completed_at": "2005-07-31T11:57:11-04:00",
    "created_at": "2012-10-12T07:05:27-04:00",
    "currency": "USD",
    "customer_id": 207119551,
    "customer_locale": null,
    "device_id": null,
    "discount_code": null,
    "email": "bob.norman@hostmail.com",
    "location_id": null,
    "name": "#901414060",
    "note": "",
    "note_attributes": {
      "custom engraving": "Happy Birthday",
      "colour": "green"
    },
    "order_id": 450789469,
    "order_status_url": "https://checkout.local/690933842/checkouts/bd5a8aa1ecd019dd3520ff791ee3a24c/thank_you",
    "order": {
      "id": 450789469,
      "name": "#1001",
      "status_url": "https://checkout.local/690933842/checkouts/bd5a8aa1ecd019dd3520ff791ee3a24c/thank_you"
    },
    "payment_due": "408.99",
    "payment_url": "https://app.local/cardserver/sessions",
    "payments": [],
    "phone": null,
    "shopify_payments_account_id": null,
    "privacy_policy_url": null,
    "refund_policy_url": null,
    "requires_shipping": true,
    "reservation_time_left": 0,
    "reservation_time": null,
    "source_identifier": null,
    "source_name": "web",
    "source_url": null,
    "subtotal_price": "398.00",
    "tax_exempt": false,
    "taxes_included": false,
    "terms_of_service_url": null,
    "token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "total_price": "408.99",
    "total_tax": "0.00",
    "total_line_items_price": "398.00",
    "updated_at": "2012-10-12T07:05:27-04:00",
    "user_id": null,
    "web_url": "https://checkout.local/690933842/checkouts/bd5a8aa1ecd019dd3520ff791ee3a24c",
    "line_items": [
      {
        "id": "904ae1f852b2ba5c",
        "key": "904ae1f852b2ba5c",
        "product_id": 632910392,
        "variant_id": 49148385,
        "sku": "IPOD2008RED",
        "vendor": "Apple",
        "title": "IPod Nano - 8GB",
        "variant_title": "Red",
        "image_url": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1526682736",
        "taxable": true,
        "requires_shipping": true,
        "gift_card": false,
        "price": "199.00",
        "compare_at_price": null,
        "line_price": "199.00",
        "properties": {},
        "quantity": 1,
        "grams": 200,
        "fulfillment_service": "manual",
        "applied_discounts": []
      },
      {
        "id": "0aa2a23be03397ac",
        "key": "0aa2a23be03397ac",
        "product_id": 632910392,
        "variant_id": 808950810,
        "sku": "IPOD2008PINK",
        "vendor": "Apple",
        "title": "IPod Nano - 8GB",
        "variant_title": "Pink",
        "image_url": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano-2.png?v=1526682736",
        "taxable": true,
        "requires_shipping": true,
        "gift_card": false,
        "price": "199.00",
        "compare_at_price": null,
        "line_price": "199.00",
        "properties": {},
        "quantity": 1,
        "grams": 200,
        "fulfillment_service": "manual",
        "applied_discounts": []
      }
    ],
    "gift_cards": [],
    "tax_lines": [],
    "tax_manipulations": [],
    "shipping_line": {
      "handle": "shopify-Standard%20Shipping-10.99",
      "price": "10.99",
      "title": "Standard Shipping"
    },
    "shipping_rate": {
      "id": "shopify-Standard%20Shipping-10.99",
      "price": "10.99",
      "title": "Standard Shipping"
    },
    "shipping_address": {
      "id": 550558813,
      "first_name": "Bob",
      "last_name": "Norman",
      "phone": "555-625-1199",
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "province_code": "KY",
      "country": "United States",
      "country_code": "US",
      "zip": "40202"
    },
    "credit_card": null,
    "billing_address": {
      "id": 550558813,
      "first_name": "Bob",
      "last_name": "Norman",
      "phone": "555-625-1199",
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "province_code": "KY",
      "country": "United States",
      "country_code": "US",
      "zip": "40202"
    },
    "applied_discount": null
  }
}

Retrieve a processing checkout

GET /admin/checkouts/#{token}.json
View Response
HTTP/1.1 202 Accepted
Location: https://apple.myshopify.com/admin/checkouts/7yjf4v2we7gamku6a6h7tvm8h3mmvs4x.json
Retry-After: 1
{
  "checkout": {
    "clone_url": "https://checkout.local/690933842/checkouts/7yjf4v2we7gamku6a6h7tvm8h3mmvs4x/clone",
    "completed_at": null,
    "created_at": "2012-10-12T07:05:27-04:00",
    "currency": "USD",
    "customer_id": 207119551,
    "customer_locale": null,
    "device_id": null,
    "discount_code": null,
    "email": "bob.norman@hostmail.com",
    "location_id": null,
    "name": "#446514532",
    "note": "",
    "note_attributes": {
      "custom engraving": "Happy Birthday",
      "colour": "green"
    },
    "order_id": null,
    "order_status_url": null,
    "order": null,
    "payment_due": "430.48",
    "payment_url": "https://app.local/cardserver/sessions",
    "payments": [
      {
        "id": 25428999,
        "unique_token": "e01e661f4a99acd9dcdg6f1422d0d6f7",
        "payment_processing_error_message": null,
        "fraudulent": false,
        "transaction": null,
        "credit_card": null
      }
    ],
    "phone": null,
    "shopify_payments_account_id": null,
    "privacy_policy_url": null,
    "refund_policy_url": null,
    "requires_shipping": true,
    "reservation_time_left": 0,
    "reservation_time": null,
    "source_identifier": null,
    "source_name": "web",
    "source_url": null,
    "subtotal_price": "398.00",
    "tax_exempt": false,
    "taxes_included": false,
    "terms_of_service_url": null,
    "token": "7yjf4v2we7gamku6a6h7tvm8h3mmvs4x",
    "total_price": "430.48",
    "total_tax": "21.49",
    "total_line_items_price": "398.00",
    "updated_at": "2012-10-12T07:05:27-04:00",
    "user_id": null,
    "web_url": "https://checkout.local/690933842/checkouts/7yjf4v2we7gamku6a6h7tvm8h3mmvs4x",
    "line_items": [
      {
        "id": "904ae1f852b2ba5c",
        "key": "904ae1f852b2ba5c",
        "product_id": 632910392,
        "variant_id": 49148385,
        "sku": "IPOD2008RED",
        "vendor": "Apple",
        "title": "IPod Nano - 8GB",
        "variant_title": "Red",
        "image_url": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1526682736",
        "taxable": true,
        "requires_shipping": true,
        "gift_card": false,
        "price": "199.00",
        "compare_at_price": null,
        "line_price": "199.00",
        "properties": {},
        "quantity": 1,
        "grams": 200,
        "fulfillment_service": "manual",
        "applied_discounts": []
      },
      {
        "id": "0aa2a23be03397ac",
        "key": "0aa2a23be03397ac",
        "product_id": 632910392,
        "variant_id": 808950810,
        "sku": "IPOD2008PINK",
        "vendor": "Apple",
        "title": "IPod Nano - 8GB",
        "variant_title": "Pink",
        "image_url": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano-2.png?v=1526682736",
        "taxable": true,
        "requires_shipping": true,
        "gift_card": false,
        "price": "199.00",
        "compare_at_price": null,
        "line_price": "199.00",
        "properties": {},
        "quantity": 1,
        "grams": 200,
        "fulfillment_service": "manual",
        "applied_discounts": []
      }
    ],
    "gift_cards": [],
    "tax_lines": [
      {
        "price": "21.49",
        "rate": 0.06,
        "title": "State Tax",
        "compare_at": 0.06
      }
    ],
    "tax_manipulations": [],
    "shipping_line": {
      "handle": "shopify-Standard%20Shipping-10.99",
      "price": "10.99",
      "title": "Standard Shipping"
    },
    "shipping_rate": {
      "id": "shopify-Standard%20Shipping-10.99",
      "price": "10.99",
      "title": "Standard Shipping"
    },
    "shipping_address": {
      "id": 550558813,
      "first_name": "Bob",
      "last_name": "Norman",
      "phone": "555-625-1199",
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "province_code": "KY",
      "country": "United States",
      "country_code": "US",
      "zip": "40202"
    },
    "credit_card": {
      "first_name": "Bob",
      "last_name": "Norman",
      "first_digits": "1",
      "last_digits": "1",
      "brand": "bogus",
      "expiry_month": 8,
      "expiry_year": 2042
    },
    "billing_address": {
      "id": 550558813,
      "first_name": "Bob",
      "last_name": "Norman",
      "phone": "555-625-1199",
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "province_code": "KY",
      "country": "United States",
      "country_code": "US",
      "zip": "40202"
    },
    "applied_discount": null
  }
}
PUT /admin/checkouts/exuw7apwoycchjuwtiqg8nytfhphr62a.json
Modifies an existing checkout

Update the shipping address and email of a checkout

PUT /admin/checkouts/#{token}.json
{
  "checkout": {
    "token": "exuw7apwoycchjuwtiqg8nytfhphr62a",
    "email": "john.smith@example.com",
    "shipping_address": {
      "first_name": "John",
      "last_name": "Smith",
      "address1": "126 York St.",
      "city": "Los Angeles",
      "province_code": "CA",
      "country_code": "US",
      "phone": "(123)456-7890",
      "zip": "90002"
    }
  }
}
View Response
HTTP/1.1 202 Accepted
Location: https://apple.myshopify.com/admin/checkouts/exuw7apwoycchjuwtiqg8nytfhphr62a.json
Retry-After: 1
{
  "checkout": {
    "clone_url": "https://checkout.local/690933842/checkouts/exuw7apwoycchjuwtiqg8nytfhphr62a/clone",
    "completed_at": null,
    "created_at": "2012-10-12T07:05:27-04:00",
    "currency": "USD",
    "customer_id": 1073339459,
    "customer_locale": null,
    "device_id": null,
    "discount_code": null,
    "email": "john.smith@example.com",
    "location_id": null,
    "name": "#862052962",
    "note": "",
    "note_attributes": {
      "custom engraving": "Happy Birthday",
      "colour": "green"
    },
    "order_id": null,
    "order_status_url": null,
    "order": null,
    "payment_due": "398.00",
    "payment_url": "https://app.local/cardserver/sessions",
    "payments": [],
    "phone": null,
    "shopify_payments_account_id": null,
    "privacy_policy_url": null,
    "refund_policy_url": null,
    "requires_shipping": true,
    "reservation_time_left": 0,
    "reservation_time": null,
    "source_identifier": null,
    "source_name": "web",
    "source_url": null,
    "subtotal_price": "398.00",
    "tax_exempt": false,
    "taxes_included": false,
    "terms_of_service_url": null,
    "token": "exuw7apwoycchjuwtiqg8nytfhphr62a",
    "total_price": "398.00",
    "total_tax": "0.00",
    "total_line_items_price": "398.00",
    "updated_at": "2018-05-18T18:59:19-04:00",
    "user_id": null,
    "web_url": "https://checkout.local/690933842/checkouts/exuw7apwoycchjuwtiqg8nytfhphr62a",
    "line_items": [
      {
        "id": "904ae1f852b2ba5c",
        "key": "904ae1f852b2ba5c",
        "product_id": 632910392,
        "variant_id": 49148385,
        "sku": "IPOD2008RED",
        "vendor": "Apple",
        "title": "IPod Nano - 8GB",
        "variant_title": "Red",
        "image_url": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1526682736",
        "taxable": true,
        "requires_shipping": true,
        "gift_card": false,
        "price": "199.00",
        "compare_at_price": null,
        "line_price": "199.00",
        "properties": {},
        "quantity": 1,
        "grams": 200,
        "fulfillment_service": "manual",
        "applied_discounts": []
      },
      {
        "id": "0aa2a23be03397ac",
        "key": "0aa2a23be03397ac",
        "product_id": 632910392,
        "variant_id": 808950810,
        "sku": "IPOD2008PINK",
        "vendor": "Apple",
        "title": "IPod Nano - 8GB",
        "variant_title": "Pink",
        "image_url": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano-2.png?v=1526682736",
        "taxable": true,
        "requires_shipping": true,
        "gift_card": false,
        "price": "199.00",
        "compare_at_price": null,
        "line_price": "199.00",
        "properties": {},
        "quantity": 1,
        "grams": 200,
        "fulfillment_service": "manual",
        "applied_discounts": []
      }
    ],
    "gift_cards": [],
    "tax_lines": [],
    "tax_manipulations": [],
    "shipping_line": null,
    "shipping_rate": null,
    "shipping_address": {
      "id": 550558813,
      "first_name": "John",
      "last_name": "Smith",
      "phone": "(123)456-7890",
      "company": null,
      "address1": "126 York St.",
      "address2": "",
      "city": "Los Angeles",
      "province": "California",
      "province_code": "CA",
      "country": "United States",
      "country_code": "US",
      "zip": "90002"
    },
    "credit_card": null,
    "billing_address": {
      "id": 550558813,
      "first_name": "Bob",
      "last_name": "Norman",
      "phone": "555-625-1199",
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "province_code": "KY",
      "country": "United States",
      "country_code": "US",
      "zip": "40202"
    },
    "applied_discount": null
  }
}

Select a shipping rate

PUT /admin/checkouts/#{token}.json
{
  "checkout": {
    "token": "exuw7apwoycchjuwtiqg8nytfhphr62a",
    "shipping_line": {
      "handle": "shopify-Standard%20Shipping-10.99"
    }
  }
}
View Response
HTTP/1.1 200 OK
Location: https://apple.myshopify.com/admin/checkouts/exuw7apwoycchjuwtiqg8nytfhphr62a.json
{
  "checkout": {
    "clone_url": "https://checkout.local/690933842/checkouts/exuw7apwoycchjuwtiqg8nytfhphr62a/clone",
    "completed_at": null,
    "created_at": "2012-10-12T07:05:27-04:00",
    "currency": "USD",
    "customer_id": 207119551,
    "customer_locale": null,
    "device_id": null,
    "discount_code": null,
    "email": "bob.norman@hostmail.com",
    "location_id": null,
    "name": "#862052962",
    "note": "",
    "note_attributes": {
      "custom engraving": "Happy Birthday",
      "colour": "green"
    },
    "order_id": null,
    "order_status_url": null,
    "order": null,
    "payment_due": "408.99",
    "payment_url": "https://app.local/cardserver/sessions",
    "payments": [],
    "phone": null,
    "shopify_payments_account_id": null,
    "privacy_policy_url": null,
    "refund_policy_url": null,
    "requires_shipping": true,
    "reservation_time_left": 0,
    "reservation_time": null,
    "source_identifier": null,
    "source_name": "web",
    "source_url": null,
    "subtotal_price": "398.00",
    "tax_exempt": false,
    "taxes_included": false,
    "terms_of_service_url": null,
    "token": "exuw7apwoycchjuwtiqg8nytfhphr62a",
    "total_price": "408.99",
    "total_tax": "0.00",
    "total_line_items_price": "398.00",
    "updated_at": "2018-05-18T18:59:20-04:00",
    "user_id": null,
    "web_url": "https://checkout.local/690933842/checkouts/exuw7apwoycchjuwtiqg8nytfhphr62a",
    "line_items": [
      {
        "id": "904ae1f852b2ba5c",
        "key": "904ae1f852b2ba5c",
        "product_id": 632910392,
        "variant_id": 49148385,
        "sku": "IPOD2008RED",
        "vendor": "Apple",
        "title": "IPod Nano - 8GB",
        "variant_title": "Red",
        "image_url": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1526682736",
        "taxable": true,
        "requires_shipping": true,
        "gift_card": false,
        "price": "199.00",
        "compare_at_price": null,
        "line_price": "199.00",
        "properties": {},
        "quantity": 1,
        "grams": 200,
        "fulfillment_service": "manual",
        "applied_discounts": []
      },
      {
        "id": "0aa2a23be03397ac",
        "key": "0aa2a23be03397ac",
        "product_id": 632910392,
        "variant_id": 808950810,
        "sku": "IPOD2008PINK",
        "vendor": "Apple",
        "title": "IPod Nano - 8GB",
        "variant_title": "Pink",
        "image_url": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano-2.png?v=1526682736",
        "taxable": true,
        "requires_shipping": true,
        "gift_card": false,
        "price": "199.00",
        "compare_at_price": null,
        "line_price": "199.00",
        "properties": {},
        "quantity": 1,
        "grams": 200,
        "fulfillment_service": "manual",
        "applied_discounts": []
      }
    ],
    "gift_cards": [],
    "tax_lines": [],
    "tax_manipulations": [],
    "shipping_line": {
      "handle": "shopify-Standard%20Shipping-10.99",
      "price": "10.99",
      "title": "Standard Shipping"
    },
    "shipping_rate": {
      "id": "shopify-Standard%20Shipping-10.99",
      "price": "10.99",
      "title": "Standard Shipping"
    },
    "shipping_address": {
      "id": 550558813,
      "first_name": "Bob",
      "last_name": "Norman",
      "phone": "555-625-1199",
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "province_code": "KY",
      "country": "United States",
      "country_code": "US",
      "zip": "40202"
    },
    "credit_card": null,
    "billing_address": {
      "id": 550558813,
      "first_name": "Bob",
      "last_name": "Norman",
      "phone": "555-625-1199",
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "province_code": "KY",
      "country": "United States",
      "country_code": "US",
      "zip": "40202"
    },
    "applied_discount": null
  }
}

Updating a shipping address with an invalid zip code fails and returns errors

PUT /admin/checkouts/#{token}.json
{
  "checkout": {
    "token": "exuw7apwoycchjuwtiqg8nytfhphr62a",
    "shipping_address": {
      "first_name": "John",
      "last_name": "Smith",
      "address1": "126 York St.",
      "city": "Beverly Hills",
      "province_code": "CA",
      "country_code": "US",
      "phone": "(123)456-7890",
      "zip": "1234"
    }
  }
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "errors": {
    "shipping_address": {
      "zip": [
        {
          "code": "invalid_for_country",
          "message": "is not valid for United States",
          "options": {
            "country": "United States"
          }
        }
      ]
    }
  }
}
GET /admin/checkouts/exuw7apwoycchjuwtiqg8nytfhphr62a/shipping_rates.json
Retrieves a list of available shipping rates for the specified checkout. Implementers need to poll this endpoint until rates become available. Each shipping rate contains the checkout's new subtotal price, total tax, and total price in the event that this shipping rate is selected. This can be used to update the UI without performing further API requests.

To apply a shipping rate, update the checkout’s shipping line with the handle of the selected rate.

Retrieving shipping rates before they're available returns an empty array

GET /admin/checkouts/#{token}/shipping_rates.json
View Response
HTTP/1.1 202 Accepted
Location: https://apple.myshopify.com/admin/checkouts/exuw7apwoycchjuwtiqg8nytfhphr62a/shipping_rates.json
Retry-After: 1
{
  "shipping_rates": []
}

Retrieve available shipping rates

GET /admin/checkouts/#{token}/shipping_rates.json
View Response
HTTP/1.1 200 OK
Location: https://apple.myshopify.com/admin/checkouts/exuw7apwoycchjuwtiqg8nytfhphr62a/shipping_rates.json
{
  "shipping_rates": [
    {
      "id": "shopify-Standard%20Shipping-10.99",
      "price": "10.99",
      "title": "Standard Shipping",
      "checkout": {
        "total_tax": "0.00",
        "total_price": "408.99",
        "subtotal_price": "398.00"
      },
      "phone_required": false,
      "delivery_range": null,
      "handle": "shopify-Standard%20Shipping-10.99"
    },
    {
      "id": "shopify-Expensive%20Shipping-99.99",
      "price": "99.99",
      "title": "Expensive Shipping",
      "checkout": {
        "total_tax": "0.00",
        "total_price": "497.99",
        "subtotal_price": "398.00"
      },
      "phone_required": false,
      "delivery_range": null,
      "handle": "shopify-Expensive%20Shipping-99.99"
    }
  ]
}

Retrieving shipping rates when none are available for the current shipping address or cart returns an empty array

GET /admin/checkouts/#{token}/shipping_rates.json
View Response
HTTP/1.1 200 OK
Location: https://apple.myshopify.com/admin/checkouts/zs9ru89kuqcdagk8bz4r9hnxt22wwd42/shipping_rates.json
{
  "shipping_rates": []
}
GET /admin/checkouts/7yjf4v2we7gamku6a6h7tvm8h3mmvs4x/payments.json
Retrieves a list of payments on a particular checkout. Sales channels require special privileges to interact with checkout payments. For more information, see Request Payment Processing.

Retrieve all the payments on a checkout

GET /admin/checkouts/#{token}/payments.json
View Response
HTTP/1.1 200 OK
{
  "payments": [
    {
      "id": 25428999,
      "unique_token": "e01e661f4a99acd9dcdg6f1422d0d6f7",
      "payment_processing_error_message": null,
      "transaction": null,
      "credit_card": null,
      "checkout": {
        "clone_url": "https://checkout.local/690933842/checkouts/7yjf4v2we7gamku6a6h7tvm8h3mmvs4x/clone",
        "completed_at": null,
        "created_at": "2012-10-12T07:05:27-04:00",
        "currency": "USD",
        "customer_id": 207119551,
        "customer_locale": null,
        "device_id": null,
        "discount_code": null,
        "email": "bob.norman@hostmail.com",
        "location_id": null,
        "name": "#446514532",
        "note": "",
        "note_attributes": {
          "custom engraving": "Happy Birthday",
          "colour": "green"
        },
        "order_id": null,
        "order_status_url": null,
        "order": null,
        "payment_due": "430.48",
        "payment_url": "https://app.local/cardserver/sessions",
        "payments": [
          {
            "id": 25428999,
            "unique_token": "e01e661f4a99acd9dcdg6f1422d0d6f7",
            "payment_processing_error_message": null,
            "transaction": null,
            "credit_card": null
          }
        ],
        "phone": null,
        "shopify_payments_account_id": null,
        "privacy_policy_url": null,
        "refund_policy_url": null,
        "requires_shipping": true,
        "reservation_time_left": 0,
        "reservation_time": null,
        "source_identifier": null,
        "source_name": "web",
        "source_url": null,
        "subtotal_price": "398.00",
        "tax_exempt": false,
        "taxes_included": false,
        "terms_of_service_url": null,
        "token": "7yjf4v2we7gamku6a6h7tvm8h3mmvs4x",
        "total_price": "430.48",
        "total_tax": "21.49",
        "total_line_items_price": "398.00",
        "updated_at": "2012-10-12T07:05:27-04:00",
        "user_id": null,
        "web_url": "https://checkout.local/690933842/checkouts/7yjf4v2we7gamku6a6h7tvm8h3mmvs4x",
        "line_items": [
          {
            "id": "904ae1f852b2ba5c",
            "key": "904ae1f852b2ba5c",
            "product_id": 632910392,
            "variant_id": 49148385,
            "sku": "IPOD2008RED",
            "vendor": "Apple",
            "title": "IPod Nano - 8GB",
            "variant_title": "Red",
            "image_url": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1526682736",
            "taxable": true,
            "requires_shipping": true,
            "gift_card": false,
            "price": "199.00",
            "compare_at_price": null,
            "line_price": "199.00",
            "properties": {},
            "quantity": 1,
            "grams": 200,
            "fulfillment_service": "manual",
            "applied_discounts": []
          },
          {
            "id": "0aa2a23be03397ac",
            "key": "0aa2a23be03397ac",
            "product_id": 632910392,
            "variant_id": 808950810,
            "sku": "IPOD2008PINK",
            "vendor": "Apple",
            "title": "IPod Nano - 8GB",
            "variant_title": "Pink",
            "image_url": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano-2.png?v=1526682736",
            "taxable": true,
            "requires_shipping": true,
            "gift_card": false,
            "price": "199.00",
            "compare_at_price": null,
            "line_price": "199.00",
            "properties": {},
            "quantity": 1,
            "grams": 200,
            "fulfillment_service": "manual",
            "applied_discounts": []
          }
        ],
        "gift_cards": [],
        "tax_lines": [
          {
            "price": "21.49",
            "rate": 0.06,
            "title": "State Tax",
            "compare_at": 0.06
          }
        ],
        "tax_manipulations": [],
        "shipping_line": {
          "handle": "shopify-Standard%20Shipping-10.99",
          "price": "10.99",
          "title": "Standard Shipping"
        },
        "shipping_rate": {
          "id": "shopify-Standard%20Shipping-10.99",
          "price": "10.99",
          "title": "Standard Shipping"
        },
        "shipping_address": {
          "id": 550558813,
          "first_name": "Bob",
          "last_name": "Norman",
          "phone": "555-625-1199",
          "company": null,
          "address1": "Chestnut Street 92",
          "address2": "",
          "city": "Louisville",
          "province": "Kentucky",
          "province_code": "KY",
          "country": "United States",
          "country_code": "US",
          "zip": "40202"
        },
        "credit_card": {
          "first_name": "Bob",
          "last_name": "Norman",
          "first_digits": "1",
          "last_digits": "1",
          "brand": "bogus",
          "expiry_month": 8,
          "expiry_year": 2042
        },
        "billing_address": {
          "id": 550558813,
          "first_name": "Bob",
          "last_name": "Norman",
          "phone": "555-625-1199",
          "company": null,
          "address1": "Chestnut Street 92",
          "address2": "",
          "city": "Louisville",
          "province": "Kentucky",
          "province_code": "KY",
          "country": "United States",
          "country_code": "US",
          "zip": "40202"
        },
        "applied_discount": null
      }
    }
  ]
}
POST /admin/checkouts/7yjf4v2we7gamku6a6h7tvm8h3mmvs4x/payments.json
Creates a payment on a checkout using the session ID returned by the card vault. Sales channels require special privileges to interact with checkout payments. For more information, see Request Payment Processing.

Create an authorization using a valid session_id stored in the vault

POST /admin/checkouts/#{token}/payments.json
{
  "payment": {
    "request_details": {
      "ip_address": "123.1.1.1",
      "accept_language": "en-US,en;q=0.8,fr;q=0.6",
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/54.0.2840.98 Safari/537.36"
    },
    "amount": "408.99",
    "session_id": "global-29de7a9728faabba",
    "unique_token": "client-side-idempotency-token"
  }
}
View Response
HTTP/1.1 202 Accepted
Location: https://apple.myshopify.com/admin/checkouts/7yjf4v2we7gamku6a6h7tvm8h3mmvs4x/payments/1068492619.json
Retry-After: 1
{
  "payment": {
    "id": 1068492619,
    "unique_token": "client-side-idempotency-token",
    "payment_processing_error_message": null,
    "fraudulent": false,
    "transaction": null,
    "credit_card": {
      "first_name": "Bob",
      "last_name": "Norman",
      "first_digits": "424242",
      "last_digits": "4242",
      "brand": "bogus",
      "expiry_month": 9,
      "expiry_year": 2019
    },
    "checkout": {
      "clone_url": "https://checkout.local/690933842/checkouts/7yjf4v2we7gamku6a6h7tvm8h3mmvs4x/clone",
      "completed_at": null,
      "created_at": "2012-10-12T07:05:27-04:00",
      "currency": "USD",
      "customer_id": 207119551,
      "customer_locale": null,
      "device_id": null,
      "discount_code": null,
      "email": "bob.norman@hostmail.com",
      "location_id": null,
      "name": "#446514532",
      "note": "",
      "note_attributes": {
        "custom engraving": "Happy Birthday",
        "colour": "green"
      },
      "order_id": null,
      "order_status_url": null,
      "order": null,
      "payment_due": "408.99",
      "payment_url": "https://app.local/cardserver/sessions",
      "payments": [
        {
          "id": 25428999,
          "unique_token": "e01e661f4a99acd9dcdg6f1422d0d6f7",
          "payment_processing_error_message": null,
          "fraudulent": false,
          "transaction": null,
          "credit_card": null
        },
        {
          "id": 1068492619,
          "unique_token": "client-side-idempotency-token",
          "payment_processing_error_message": null,
          "fraudulent": false,
          "transaction": null,
          "credit_card": {
            "first_name": "Bob",
            "last_name": "Norman",
            "first_digits": "424242",
            "last_digits": "4242",
            "brand": "bogus",
            "expiry_month": 9,
            "expiry_year": 2019
          }
        }
      ],
      "phone": null,
      "shopify_payments_account_id": null,
      "privacy_policy_url": null,
      "refund_policy_url": null,
      "requires_shipping": true,
      "reservation_time_left": 0,
      "reservation_time": null,
      "source_identifier": null,
      "source_name": "web",
      "source_url": null,
      "subtotal_price": "398.00",
      "tax_exempt": false,
      "taxes_included": false,
      "terms_of_service_url": null,
      "token": "7yjf4v2we7gamku6a6h7tvm8h3mmvs4x",
      "total_price": "408.99",
      "total_tax": "0.00",
      "total_line_items_price": "398.00",
      "updated_at": "2018-05-18T18:59:26-04:00",
      "user_id": null,
      "web_url": "https://checkout.local/690933842/checkouts/7yjf4v2we7gamku6a6h7tvm8h3mmvs4x",
      "line_items": [
        {
          "id": "904ae1f852b2ba5c",
          "key": "904ae1f852b2ba5c",
          "product_id": 632910392,
          "variant_id": 49148385,
          "sku": "IPOD2008RED",
          "vendor": "Apple",
          "title": "IPod Nano - 8GB",
          "variant_title": "Red",
          "image_url": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1526682736",
          "taxable": true,
          "requires_shipping": true,
          "gift_card": false,
          "price": "199.00",
          "compare_at_price": null,
          "line_price": "199.00",
          "properties": {},
          "quantity": 1,
          "grams": 200,
          "fulfillment_service": "manual",
          "applied_discounts": []
        },
        {
          "id": "0aa2a23be03397ac",
          "key": "0aa2a23be03397ac",
          "product_id": 632910392,
          "variant_id": 808950810,
          "sku": "IPOD2008PINK",
          "vendor": "Apple",
          "title": "IPod Nano - 8GB",
          "variant_title": "Pink",
          "image_url": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano-2.png?v=1526682736",
          "taxable": true,
          "requires_shipping": true,
          "gift_card": false,
          "price": "199.00",
          "compare_at_price": null,
          "line_price": "199.00",
          "properties": {},
          "quantity": 1,
          "grams": 200,
          "fulfillment_service": "manual",
          "applied_discounts": []
        }
      ],
      "gift_cards": [],
      "tax_lines": [],
      "tax_manipulations": [],
      "shipping_line": {
        "handle": "shopify-Standard%20Shipping-10.99",
        "price": "10.99",
        "title": "Standard Shipping"
      },
      "shipping_rate": {
        "id": "shopify-Standard%20Shipping-10.99",
        "price": "10.99",
        "title": "Standard Shipping"
      },
      "shipping_address": {
        "id": 550558813,
        "first_name": "Bob",
        "last_name": "Norman",
        "phone": "555-625-1199",
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "province_code": "KY",
        "country": "United States",
        "country_code": "US",
        "zip": "40202"
      },
      "credit_card": {
        "first_name": "Bob",
        "last_name": "Norman",
        "first_digits": "424242",
        "last_digits": "4242",
        "brand": "bogus",
        "expiry_month": 9,
        "expiry_year": 2019
      },
      "billing_address": {
        "id": 550558813,
        "first_name": "Bob",
        "last_name": "Norman",
        "phone": "555-625-1199",
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "province_code": "KY",
        "country": "United States",
        "country_code": "US",
        "zip": "40202"
      },
      "applied_discount": null
    }
  }
}

Creating an authorization with a valid session ID but an invalid credit card number fails and returns errors

POST /admin/checkouts/#{token}/payments.json
{
  "payment": {
    "request_details": {
      "ip_address": "123.1.1.1",
      "accept_language": "en-US,en;q=0.8,fr;q=0.6",
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/54.0.2840.98 Safari/537.36"
    },
    "amount": "430.48",
    "session_id": "global-9b116afed7a23013",
    "unique_token": "client-side-idempotency-token"
  }
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "errors": {
    "amount": [
      {
        "code": "total_price_mismatch",
        "message": "The amount of the payment must match the total of 408.99.",
        "options": {
          "amount": "408.99"
        }
      }
    ],
    "credit_card": {
      "number": [
        {
          "code": "invalid",
          "message": "is invalid",
          "options": {}
        }
      ]
    }
  }
}

Creating an authorization with an invalid session ID fails and returns errors

POST /admin/checkouts/#{token}/payments.json
{
  "payment": {
    "request_details": {
      "ip_address": "123.1.1.1",
      "accept_language": "en-US,en;q=0.8,fr;q=0.6",
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/54.0.2840.98 Safari/537.36"
    },
    "amount": "430.48",
    "session_id": "global-an_invalid_session_id",
    "unique_token": "client-side-idempotency-token"
  }
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "errors": {
    "amount": [
      {
        "code": "total_price_mismatch",
        "message": "The amount of the payment must match the total of 408.99.",
        "options": {
          "amount": "408.99"
        }
      }
    ],
    "payment_gateway": [
      {
        "code": "invalid",
        "message": "is invalid",
        "options": {}
      }
    ],
    "checkout": {
      "payment_gateway": [
        {
          "code": "invalid",
          "message": "is invalid",
          "options": {}
        }
      ]
    }
  }
}

Creating an authorization with a valid session can fail for various reasons

POST /admin/checkouts/#{token}/payments.json
{
  "payment": {
    "request_details": {
      "ip_address": "123.1.1.1",
      "accept_language": "en-US,en;q=0.8,fr;q=0.6",
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/54.0.2840.98 Safari/537.36"
    },
    "amount": "408.99",
    "session_id": "global-3396d505a8df6362",
    "unique_token": "client-side-idempotency-token"
  }
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "errors": {
    "base": [
      {
        "code": "processing_error",
        "message": "Your payment could not be processed at this time, please try again in a few minutes",
        "options": {
          "raw_gateway_error": "Service is unavailable."
        }
      }
    ]
  }
}
GET /admin/checkouts/7yjf4v2we7gamku6a6h7tvm8h3mmvs4x/payments/25428999.json
Retrieve the payment information for an existing payment. Sales channels require special privileges to interact with checkout payments. For more information, see Request Payment Processing.

Retrieve a payment with a succesful transaction

GET /admin/checkouts/#{token}/payments/#{payment_id}.json
View Response
HTTP/1.1 200 OK
Location: https://apple.myshopify.com/admin/checkouts/7yjf4v2we7gamku6a6h7tvm8h3mmvs4x/payments/25428999.json
{
  "payment": {
    "id": 25428999,
    "unique_token": "e01e661f4a99acd9dcdg6f1422d0d6f7",
    "payment_processing_error_message": null,
    "fraudulent": false,
    "transaction": {
      "amount": "430.48",
      "amount_in": null,
      "amount_out": null,
      "amount_rounding": null,
      "authorization": null,
      "created_at": "2018-05-18T18:59:29-04:00",
      "currency": "USD",
      "error_code": null,
      "gateway": "bogus",
      "id": 1072844665,
      "kind": "authorization",
      "message": null,
      "status": "success",
      "test": false,
      "receipt": {}
    },
    "credit_card": null,
    "checkout": {
      "clone_url": "https://checkout.local/690933842/checkouts/7yjf4v2we7gamku6a6h7tvm8h3mmvs4x/clone",
      "completed_at": null,
      "created_at": "2012-10-12T07:05:27-04:00",
      "currency": "USD",
      "customer_id": 207119551,
      "customer_locale": null,
      "device_id": null,
      "discount_code": null,
      "email": "bob.norman@hostmail.com",
      "location_id": null,
      "name": "#446514532",
      "note": "",
      "note_attributes": {
        "custom engraving": "Happy Birthday",
        "colour": "green"
      },
      "order_id": null,
      "order_status_url": null,
      "order": null,
      "payment_due": "430.48",
      "payment_url": "https://app.local/cardserver/sessions",
      "payments": [
        {
          "id": 25428999,
          "unique_token": "e01e661f4a99acd9dcdg6f1422d0d6f7",
          "payment_processing_error_message": null,
          "fraudulent": false,
          "transaction": {
            "amount": "430.48",
            "amount_in": null,
            "amount_out": null,
            "amount_rounding": null,
            "authorization": null,
            "created_at": "2018-05-18T18:59:29-04:00",
            "currency": "USD",
            "error_code": null,
            "gateway": "bogus",
            "id": 1072844665,
            "kind": "authorization",
            "message": null,
            "status": "success",
            "test": false,
            "receipt": {}
          },
          "credit_card": null
        }
      ],
      "phone": null,
      "shopify_payments_account_id": null,
      "privacy_policy_url": null,
      "refund_policy_url": null,
      "requires_shipping": true,
      "reservation_time_left": 0,
      "reservation_time": null,
      "source_identifier": null,
      "source_name": "web",
      "source_url": null,
      "subtotal_price": "398.00",
      "tax_exempt": false,
      "taxes_included": false,
      "terms_of_service_url": null,
      "token": "7yjf4v2we7gamku6a6h7tvm8h3mmvs4x",
      "total_price": "430.48",
      "total_tax": "21.49",
      "total_line_items_price": "398.00",
      "updated_at": "2012-10-12T07:05:27-04:00",
      "user_id": null,
      "web_url": "https://checkout.local/690933842/checkouts/7yjf4v2we7gamku6a6h7tvm8h3mmvs4x",
      "line_items": [
        {
          "id": "904ae1f852b2ba5c",
          "key": "904ae1f852b2ba5c",
          "product_id": 632910392,
          "variant_id": 49148385,
          "sku": "IPOD2008RED",
          "vendor": "Apple",
          "title": "IPod Nano - 8GB",
          "variant_title": "Red",
          "image_url": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1526682736",
          "taxable": true,
          "requires_shipping": true,
          "gift_card": false,
          "price": "199.00",
          "compare_at_price": null,
          "line_price": "199.00",
          "properties": {},
          "quantity": 1,
          "grams": 200,
          "fulfillment_service": "manual",
          "applied_discounts": []
        },
        {
          "id": "0aa2a23be03397ac",
          "key": "0aa2a23be03397ac",
          "product_id": 632910392,
          "variant_id": 808950810,
          "sku": "IPOD2008PINK",
          "vendor": "Apple",
          "title": "IPod Nano - 8GB",
          "variant_title": "Pink",
          "image_url": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano-2.png?v=1526682736",
          "taxable": true,
          "requires_shipping": true,
          "gift_card": false,
          "price": "199.00",
          "compare_at_price": null,
          "line_price": "199.00",
          "properties": {},
          "quantity": 1,
          "grams": 200,
          "fulfillment_service": "manual",
          "applied_discounts": []
        }
      ],
      "gift_cards": [],
      "tax_lines": [
        {
          "price": "21.49",
          "rate": 0.06,
          "title": "State Tax",
          "compare_at": 0.06
        }
      ],
      "tax_manipulations": [],
      "shipping_line": {
        "handle": "shopify-Standard%20Shipping-10.99",
        "price": "10.99",
        "title": "Standard Shipping"
      },
      "shipping_rate": {
        "id": "shopify-Standard%20Shipping-10.99",
        "price": "10.99",
        "title": "Standard Shipping"
      },
      "shipping_address": {
        "id": 550558813,
        "first_name": "Bob",
        "last_name": "Norman",
        "phone": "555-625-1199",
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "province_code": "KY",
        "country": "United States",
        "country_code": "US",
        "zip": "40202"
      },
      "credit_card": {
        "first_name": "Bob",
        "last_name": "Norman",
        "first_digits": "1",
        "last_digits": "1",
        "brand": "bogus",
        "expiry_month": 8,
        "expiry_year": 2042
      },
      "billing_address": {
        "id": 550558813,
        "first_name": "Bob",
        "last_name": "Norman",
        "phone": "555-625-1199",
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "province_code": "KY",
        "country": "United States",
        "country_code": "US",
        "zip": "40202"
      },
      "applied_discount": null
    }
  }
}

Retrieve a payment with a failed transaction

GET /admin/checkouts/#{token}/payments/#{payment_id}.json
View Response
HTTP/1.1 200 OK
Location: https://apple.myshopify.com/admin/checkouts/7yjf4v2we7gamku6a6h7tvm8h3mmvs4x/payments/25428999.json
{
  "payment": {
    "id": 25428999,
    "unique_token": "e01e661f4a99acd9dcdg6f1422d0d6f7",
    "payment_processing_error_message": null,
    "fraudulent": false,
    "transaction": {
      "amount": "430.48",
      "amount_in": null,
      "amount_out": null,
      "amount_rounding": null,
      "authorization": null,
      "created_at": "2018-05-18T18:59:30-04:00",
      "currency": "USD",
      "error_code": null,
      "gateway": "bogus",
      "id": 1072844666,
      "kind": "authorization",
      "message": null,
      "status": "failure",
      "test": false,
      "receipt": {}
    },
    "credit_card": null,
    "checkout": {
      "clone_url": "https://checkout.local/690933842/checkouts/7yjf4v2we7gamku6a6h7tvm8h3mmvs4x/clone",
      "completed_at": null,
      "created_at": "2012-10-12T07:05:27-04:00",
      "currency": "USD",
      "customer_id": 207119551,
      "customer_locale": null,
      "device_id": null,
      "discount_code": null,
      "email": "bob.norman@hostmail.com",
      "location_id": null,
      "name": "#446514532",
      "note": "",
      "note_attributes": {
        "custom engraving": "Happy Birthday",
        "colour": "green"
      },
      "order_id": null,
      "order_status_url": null,
      "order": null,
      "payment_due": "430.48",
      "payment_url": "https://app.local/cardserver/sessions",
      "payments": [
        {
          "id": 25428999,
          "unique_token": "e01e661f4a99acd9dcdg6f1422d0d6f7",
          "payment_processing_error_message": null,
          "fraudulent": false,
          "transaction": {
            "amount": "430.48",
            "amount_in": null,
            "amount_out": null,
            "amount_rounding": null,
            "authorization": null,
            "created_at": "2018-05-18T18:59:30-04:00",
            "currency": "USD",
            "error_code": null,
            "gateway": "bogus",
            "id": 1072844666,
            "kind": "authorization",
            "message": null,
            "status": "failure",
            "test": false,
            "receipt": {}
          },
          "credit_card": null
        }
      ],
      "phone": null,
      "shopify_payments_account_id": null,
      "privacy_policy_url": null,
      "refund_policy_url": null,
      "requires_shipping": true,
      "reservation_time_left": 0,
      "reservation_time": null,
      "source_identifier": null,
      "source_name": "web",
      "source_url": null,
      "subtotal_price": "398.00",
      "tax_exempt": false,
      "taxes_included": false,
      "terms_of_service_url": null,
      "token": "7yjf4v2we7gamku6a6h7tvm8h3mmvs4x",
      "total_price": "430.48",
      "total_tax": "21.49",
      "total_line_items_price": "398.00",
      "updated_at": "2012-10-12T07:05:27-04:00",
      "user_id": null,
      "web_url": "https://checkout.local/690933842/checkouts/7yjf4v2we7gamku6a6h7tvm8h3mmvs4x",
      "line_items": [
        {
          "id": "904ae1f852b2ba5c",
          "key": "904ae1f852b2ba5c",
          "product_id": 632910392,
          "variant_id": 49148385,
          "sku": "IPOD2008RED",
          "vendor": "Apple",
          "title": "IPod Nano - 8GB",
          "variant_title": "Red",
          "image_url": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1526682736",
          "taxable": true,
          "requires_shipping": true,
          "gift_card": false,
          "price": "199.00",
          "compare_at_price": null,
          "line_price": "199.00",
          "properties": {},
          "quantity": 1,
          "grams": 200,
          "fulfillment_service": "manual",
          "applied_discounts": []
        },
        {
          "id": "0aa2a23be03397ac",
          "key": "0aa2a23be03397ac",
          "product_id": 632910392,
          "variant_id": 808950810,
          "sku": "IPOD2008PINK",
          "vendor": "Apple",
          "title": "IPod Nano - 8GB",
          "variant_title": "Pink",
          "image_url": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano-2.png?v=1526682736",
          "taxable": true,
          "requires_shipping": true,
          "gift_card": false,
          "price": "199.00",
          "compare_at_price": null,
          "line_price": "199.00",
          "properties": {},
          "quantity": 1,
          "grams": 200,
          "fulfillment_service": "manual",
          "applied_discounts": []
        }
      ],
      "gift_cards": [],
      "tax_lines": [
        {
          "price": "21.49",
          "rate": 0.06,
          "title": "State Tax",
          "compare_at": 0.06
        }
      ],
      "tax_manipulations": [],
      "shipping_line": {
        "handle": "shopify-Standard%20Shipping-10.99",
        "price": "10.99",
        "title": "Standard Shipping"
      },
      "shipping_rate": {
        "id": "shopify-Standard%20Shipping-10.99",
        "price": "10.99",
        "title": "Standard Shipping"
      },
      "shipping_address": {
        "id": 550558813,
        "first_name": "Bob",
        "last_name": "Norman",
        "phone": "555-625-1199",
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "province_code": "KY",
        "country": "United States",
        "country_code": "US",
        "zip": "40202"
      },
      "credit_card": {
        "first_name": "Bob",
        "last_name": "Norman",
        "first_digits": "1",
        "last_digits": "1",
        "brand": "bogus",
        "expiry_month": 8,
        "expiry_year": 2042
      },
      "billing_address": {
        "id": 550558813,
        "first_name": "Bob",
        "last_name": "Norman",
        "phone": "555-625-1199",
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "province_code": "KY",
        "country": "United States",
        "country_code": "US",
        "zip": "40202"
      },
      "applied_discount": null
    }
  }
}
GET /admin/checkouts/7yjf4v2we7gamku6a6h7tvm8h3mmvs4x/payments/count.json
Count the number of payments attempted on a checkout. Sales channels require special privileges to interact with checkout payments. For more information, see Request Payment Processing.

Retrieve the number of payments on a checkout

GET /admin/checkouts/#{token}/payments/count.json
View Response
HTTP/1.1 200 OK
{
  "count": 1
}
POST https://elb.deposit.shopifycs.com/sessions
Stores a credit card in the card vault. Credit cards cannot be sent to the Checkout API directly. They must be sent to our card vault, which in response will return an ID. This ID can then be used when calling the Checkout API's PATCH #{token}.json endpoint. An ID is valid only for a single call to the endpoint. The card vault has a static URL and is located at https://elb.deposit.shopifycs.com/sessions. It is also provided via the payment_url property. Card vault requests should include the HTTP headers Content-Type: application/json and Accept: application/json.

Create a payment session with the specified billing details and checkout.

POST https://elb.deposit.shopifycs.com/sessions
{
  "credit_card": {
    "number": "1",
    "first_name": "John",
    "last_name": "Smith",
    "month": "5",
    "year": "15",
    "verification_value": "123"
  }
}
View Response
HTTP/1.1 200 OK
{
  "id": "83hru3obno3hu434b3u"
}