Orders

GET

orders

{order_reference_id}

orders

curl --request GET \
  --url https://sandbox.gateway.sezzle.com/v1/orders/{order_reference_id} \
  --header 'Authorization: <api-key>'

{
  "created_at": "2025-06-19T19:34:57.000Z",
  "captured_at": "2025-06-19T19:35:33.000Z",
  "capture_expiration": "2025-06-26T19:35:15.000Z",
  "description": "Order #1800",
  "amount_in_cents": 12999,
  "usd_amount_in_cents": 12999,
  "customer_amount_in_cents": 12999,
  "currency_code": "USD",
  "customer_currency_code": "USD",
  "reference_id": "ord_12345",
  "shipping_address": {
    "name": "John Doe",
    "street": "123 West Lake street",
    "street2": "104",
    "city": "Minneapolis",
    "state": "MN",
    "postal_code": "55408",
    "country_code": "US"
  },
  "billing_address": {
    "name": "John Doe",
    "street": "123 West Lake street",
    "street2": "104",
    "city": "Minneapolis",
    "state": "MN",
    "postal_code": "55408",
    "country_code": "US"
  },
  "customer": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "[email protected]",
    "phone": "8885401867"
  },
  "refunds": [
    {
      "amount": {
        "amount_in_cents": 500,
        "currency": "USD"
      },
      "refund_id": "7b33e7b6-f112-4844-a3c5-91688a6c00b7",
      "refund_reason": "Item returned by user",
      "is_full_refund": false,
      "order_reference_id": "ord_12345",
      "created_at": "2025-06-19T19:41:09Z"
    }
  ],
  "metadata": {
    "location_id": 123,
    "store_manager": "Jane Doe",
    "store_name": "Downtown Minneapolis"
  },
  "items": [
    {
      "name": "widget",
      "sku": "sku123456",
      "quantity": 1,
      "price": {
        "amount_in_cents": 1000,
        "currency": "USD"
      }
    }
  ],
  "sezzle_order_id": "d1a6c-soq9b-j96fj-14700",
  "checkout_expiration": "2025-06-19T20:04:57.000Z",
  "checkout_status": "completed"
}

You are viewing Version 1 of the Sezzle API. Check out the current version!

Authorizations

Authorization

string

header

required

The authentication token generated from providing API Keys to Sezzle Gateway

Path Parameters

order_reference_id

string

required

The Order Reference ID to update

Query Parameters

include-shipping-info

boolean

If your checkout post data required us to collect shipping information from the customer, then you can request that information alongside the order details.

Response

Successful Operation

created_at

string<date-time>

The date the session was created in ISO 8601 date/time format

captured_at

string<date-time>

The date the order was captured in ISO 8601 date/time format

capture_expiration

string<date-time>

The date until which the merchant can capture the order amount. ISO 8601 date/time format

description

string

Your description for this order

amount_in_cents

number

The total order amount in cents in original merchant currency

usd_amount_in_cents

number

The total order amount in cents converted to USD

customer_amount_in_cents

number

The total order amount in cents converted to customer currency

currency_code

string

The original merchant 3 character currency code as defined by ISO 4217

customer_currency_code

string

The customer's 3 character currency code as defined by ISO 4217

reference_id

string

The checkout or cart ID from the merchant, currently used for tracking only (must contain only alphanumeric characters, dashes (-), and underscores (_))

shipping_address

object

The customer's shipping address

Hide child attributes

shipping_address.name

string | null

The name on the address

shipping_address.street

string

The street and number of the address

shipping_address.street2

string | null

The apt or unit

shipping_address.city

string

The city

shipping_address.state

string

The 2 character state code

shipping_address.postal_code

string

The postal delivery code

shipping_address.country_code

string

The 2 character country code

shipping_address.phone_number

string | null

The phone number at the delivery location

billing_address

object

The customer's billing address

Hide child attributes

billing_address.name

string | null

The name on the address

billing_address.street

string

The street and number of the address

billing_address.street2

string | null

The apt or unit

billing_address.city

string

The city

billing_address.state

string

The 2 character state code

billing_address.postal_code

string

The postal delivery code

billing_address.country_code

string

The 2 character country code

billing_address.phone_number

string | null

The phone number at the delivery location

customer

object

The customer's basic contact information

Hide child attributes

customer.first_name

string

The customer's first name

customer.last_name

string

The customer's last name

customer.email

string

The customer's email address

customer.phone

string

The customer's phone number

refunds

object[]

Refunded funds event detail

Hide child attributes

refunds.amount

object

The amount in cents for the transaction

Hide child attributes

refunds.amount.amount_in_cents

integer

required

The amount in cents

refunds.amount.currency

string

required

The 3 character currency code as defined by ISO 4217

refunds.created_at

string<date-time>

The UTC time and date when the refund was issued

refunds.is_full_refund

boolean

Whether the transaction is the full amount of the order

refunds.order_reference_id

string

The checkout or cart ID from the merchant, currently used for tracking only (must contain only alphanumeric characters, dashes (-), and underscores (_))

refunds.refund_id

string

UUID for the Refund. Must be unique to a Merchant

refunds.refund_reason

string

A reason for the refund

metadata

object

Object for any custom data you want to submit with the checkout. You are not limited to the key-value pairs shown in the example, and you may use any key-value pairs you like

Hide child attributes

metadata.any

string

Custom metadata field

items

object[]

The items being purchased

Hide child attributes

items.name

string

The name of the item

items.sku

string

The sku identifier

items.quantity

integer

The quantity purchased

items.price

object

The price of the product before tax and discounts

Hide child attributes

items.price.amount_in_cents

integer

required

The amount in cents

items.price.currency

string

required

The 3 character currency code as defined by ISO 4217

items.category_path

string

The category path where the product is located. Example: Camping Gear & Supplies > Tents & Shelters.

checkout_expiration

string<date-time>

The date until which the shopper can access the checkout_url generated in Create Session request to complete the order. ISO 8601 date/time format

Complete a Checkout

⌘I

orders

curl --request GET \
  --url https://sandbox.gateway.sezzle.com/v1/orders/{order_reference_id} \
  --header 'Authorization: <api-key>'

{
  "created_at": "2025-06-19T19:34:57.000Z",
  "captured_at": "2025-06-19T19:35:33.000Z",
  "capture_expiration": "2025-06-26T19:35:15.000Z",
  "description": "Order #1800",
  "amount_in_cents": 12999,
  "usd_amount_in_cents": 12999,
  "customer_amount_in_cents": 12999,
  "currency_code": "USD",
  "customer_currency_code": "USD",
  "reference_id": "ord_12345",
  "shipping_address": {
    "name": "John Doe",
    "street": "123 West Lake street",
    "street2": "104",
    "city": "Minneapolis",
    "state": "MN",
    "postal_code": "55408",
    "country_code": "US"
  },
  "billing_address": {
    "name": "John Doe",
    "street": "123 West Lake street",
    "street2": "104",
    "city": "Minneapolis",
    "state": "MN",
    "postal_code": "55408",
    "country_code": "US"
  },
  "customer": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "[email protected]",
    "phone": "8885401867"
  },
  "refunds": [
    {
      "amount": {
        "amount_in_cents": 500,
        "currency": "USD"
      },
      "refund_id": "7b33e7b6-f112-4844-a3c5-91688a6c00b7",
      "refund_reason": "Item returned by user",
      "is_full_refund": false,
      "order_reference_id": "ord_12345",
      "created_at": "2025-06-19T19:41:09Z"
    }
  ],
  "metadata": {
    "location_id": 123,
    "store_manager": "Jane Doe",
    "store_name": "Downtown Minneapolis"
  },
  "items": [
    {
      "name": "widget",
      "sku": "sku123456",
      "quantity": 1,
      "price": {
        "amount_in_cents": 1000,
        "currency": "USD"
      }
    }
  ],
  "sezzle_order_id": "d1a6c-soq9b-j96fj-14700",
  "checkout_expiration": "2025-06-19T20:04:57.000Z",
  "checkout_status": "completed"
}

API Reference

Tokenization

v1 (deprecated)

Authorizations

Path Parameters

Query Parameters

Response