A child of the Order resource. Contains information about shipping and billing addresses. Use these endpoints to add shipping and billing addresses to an order.
Set Shipping Address
Sets the shipping address on the order.
Each order can have only one shipping address. If you call this endpoint and a shipping address already exists, the existing address is overwritten.
Set Shipping Address calls Validate Address before setting the shipping address.
Note: Checkout admin settings can override schema requirements for
phone_number
andbusiness_name
. Ifphone_number
orbusiness_name
are set torequired
in the Bold Checkout admin, they are alsorequired
in this endpoint.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 The identifier of the shop. Can be retrieved by making a request to the Get Info endpoint. |
public_order_id required | string Example: woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB The public order identifier generated when the order is initialized by making a request to the Initialize Order endpoint. |
Request Body schema: application/json
first_name | string The first name of the addressee. |
last_name | string The last name of the addressee. |
address_line_1 | string The street address. |
address_line_2 | string Any additional street address details (apt #, suite #, etc). |
country required | string The country name. |
city | string The city name. |
province | string The province or state name, if applicable. If |
country_code required | string The country code, in ISO 3166 format. |
province_code | string The province or state code, in ISO 3166 format, if applicable. If |
postal_code | string The postal/zip code. Required for most countries, including the United States, Canada, and Mexico. Validated on format only when provided. |
business_name | string If applicable, the business name. |
phone_number | string The phone number of the addressee. |
Responses
Request samples
- Payload
{- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
Response samples
- 200
- 401
- 422
{- "data": {
- "address": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "application_state": {
- "customer": {
- "platform_id": "50942578465125",
- "public_id": "pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA",
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true,
- "saved_addresses": [
- {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
]
}, - "addresses": {
- "shipping": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "billing": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
}, - "line_items": [
- {
- "product_data": {
- "id": "724bca",
- "product_title": "Oak Cheese Grater",
- "title": "Small",
- "properties": {
- "colour": "red",
- "size": "small"
}, - "description": "A handmade oak cheese grater to elevate your cheese-eating experience.",
- "quantity": 2,
- "price": 2350,
- "total_price": 4700,
- "visible": 1,
- "line_item_key": "ABC123",
- "barcode": "1234ABC",
- "compare_at_price": 4000,
- "weight": 1000,
- "weight_unit": "g",
- "product_id": "oak-cheese-grater",
- "variant_id": "oak-cheese-grater-small",
- "requires_shipping": true,
- "sku": "OAK_GRATER_SM",
- "taxable": true,
- "tags": "Kitchen, Cheese Board, Oak",
- "vendor": "Cheese Boards Unlimited",
- "total_weight": 2000,
- "localized_names": {
- "fr": "Gratteur à fromage en chêne",
- "ge": "Käsereibe aus Eichenholz"
}, - "localized_descriptions": {
- "fr": "Un gratteur à fromage en chêne faite à la main pour rehausser votre expérience de dégustation de fromage",
- "ge": "Eine handgefertigte Käsereibe aus Eichenholz, um Ihr Käseerlebnis zu verbessern"
}, - "localized_variant_names": {
- "fr": "Gratteur à fromage en chêne",
- "ge": "Käsereibe aus Eichenholz"
}
}, - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "fees": [
- {
- "amount": 500,
- "name": "Miscellaneous fee."
}
], - "discounts": [
- {
- "value": 500,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
], - "fulfilled_quantity": 2
}
], - "fees": [
- {
- "id": "123456789",
- "line_text": "Custom Fee — Added by Plugin",
- "fee_type": "fixed",
- "value": 10,
- "source": "PLUGIN",
- "plugin_uuid": "a52589f8-09df-11ed-b30e-f67072e164ee",
- "taxable": true,
- "show_description": true
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}, - {
- "value": 500,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
], - "payments": [
- {
- "gateway_public_id": "i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW",
- "amount": 4700,
- "currency": "CAD",
- "type": "spreedly",
- "display_string": "Credit Card Payment",
- "id": "",
- "token": "7uZAMRAf80KiEwibsrrM5IB41yU",
- "wallet_pay_type": "applepay",
- "retain": false,
- "payment_parameters": {
- "is_giftcard": true,
- "customer_segment_id": "ab4329tn23oe315"
}
}
], - "order_total": 4700,
- "order_meta_data": {
- "cart_parameters": {
- "key": "cp-key1",
- "property1": "A cart param.",
- "property2": "A cart param."
}, - "note_attributes": {
- "key": "na-key1",
- "property1": "A note attribute.",
- "property2": "A note attribute."
}, - "notes": "A special delivery note.",
- "tags": [
- "order-1"
]
}, - "shipping": {
- "selected_shipping": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}, - "available_shipping_lines": [
- {
- "id": "string",
- "line": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}
]
}, - "resumable_link": "example.com/checkout/resume",
- "flow_id": "external-company-one-page-template",
- "currency": {
- "iso_code": "CAD",
- "iso_numeric_code": 124,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "display_currency": {
- "iso_code": "USD",
- "iso_numeric_code": 840,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "display_exchange_rate": 1.357251,
- "created_via": "My_Order_Creating_Plugin",
- "is_processed": false,
- "order_id": 79047599,
- "platform_order_id": "1389wjfalsdf9y4r"
}
}
}
Get Shipping Address
Gets the shipping address on the order.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 The identifier of the shop. Can be retrieved by making a request to the Get Info endpoint. |
public_order_id required | string Example: woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB The public order identifier generated when the order is initialized by making a request to the Initialize Order endpoint. |
Responses
Response samples
- 200
- 401
{- "data": {
- "address": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "application_state": {
- "customer": {
- "platform_id": "50942578465125",
- "public_id": "pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA",
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true,
- "saved_addresses": [
- {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
]
}, - "addresses": {
- "shipping": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "billing": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
}, - "line_items": [
- {
- "product_data": {
- "id": "724bca",
- "product_title": "Oak Cheese Grater",
- "title": "Small",
- "properties": {
- "colour": "red",
- "size": "small"
}, - "description": "A handmade oak cheese grater to elevate your cheese-eating experience.",
- "quantity": 2,
- "price": 2350,
- "total_price": 4700,
- "visible": 1,
- "line_item_key": "ABC123",
- "barcode": "1234ABC",
- "compare_at_price": 4000,
- "weight": 1000,
- "weight_unit": "g",
- "product_id": "oak-cheese-grater",
- "variant_id": "oak-cheese-grater-small",
- "requires_shipping": true,
- "sku": "OAK_GRATER_SM",
- "taxable": true,
- "tags": "Kitchen, Cheese Board, Oak",
- "vendor": "Cheese Boards Unlimited",
- "total_weight": 2000,
- "localized_names": {
- "fr": "Gratteur à fromage en chêne",
- "ge": "Käsereibe aus Eichenholz"
}, - "localized_descriptions": {
- "fr": "Un gratteur à fromage en chêne faite à la main pour rehausser votre expérience de dégustation de fromage",
- "ge": "Eine handgefertigte Käsereibe aus Eichenholz, um Ihr Käseerlebnis zu verbessern"
}, - "localized_variant_names": {
- "fr": "Gratteur à fromage en chêne",
- "ge": "Käsereibe aus Eichenholz"
}
}, - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "fees": [
- {
- "amount": 500,
- "name": "Miscellaneous fee."
}
], - "discounts": [
- {
- "value": 500,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
], - "fulfilled_quantity": 2
}
], - "fees": [
- {
- "id": "123456789",
- "line_text": "Custom Fee — Added by Plugin",
- "fee_type": "fixed",
- "value": 10,
- "source": "PLUGIN",
- "plugin_uuid": "a52589f8-09df-11ed-b30e-f67072e164ee",
- "taxable": true,
- "show_description": true
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}, - {
- "value": 500,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
], - "payments": [
- {
- "gateway_public_id": "i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW",
- "amount": 4700,
- "currency": "CAD",
- "type": "spreedly",
- "display_string": "Credit Card Payment",
- "id": "",
- "token": "7uZAMRAf80KiEwibsrrM5IB41yU",
- "wallet_pay_type": "applepay",
- "retain": false,
- "payment_parameters": {
- "is_giftcard": true,
- "customer_segment_id": "ab4329tn23oe315"
}
}
], - "order_total": 4700,
- "order_meta_data": {
- "cart_parameters": {
- "key": "cp-key1",
- "property1": "A cart param.",
- "property2": "A cart param."
}, - "note_attributes": {
- "key": "na-key1",
- "property1": "A note attribute.",
- "property2": "A note attribute."
}, - "notes": "A special delivery note.",
- "tags": [
- "order-1"
]
}, - "shipping": {
- "selected_shipping": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}, - "available_shipping_lines": [
- {
- "id": "string",
- "line": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}
]
}, - "resumable_link": "example.com/checkout/resume",
- "flow_id": "external-company-one-page-template",
- "currency": {
- "iso_code": "CAD",
- "iso_numeric_code": 124,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "display_currency": {
- "iso_code": "USD",
- "iso_numeric_code": 840,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "display_exchange_rate": 1.357251,
- "created_via": "My_Order_Creating_Plugin",
- "is_processed": false,
- "order_id": 79047599,
- "platform_order_id": "1389wjfalsdf9y4r"
}
}
}
Update Shipping Address
Updates the shipping address on the order.
This endpoint updates all fields of the shipping address. Any value left blank in the request body will be made blank in the updated address. The fields country
, country_code
, province
, and province_code
cannot be left blank.
Note: Checkout admin settings can override schema requirements for
phone_number
andbusiness_name
. Ifphone_number
orbusiness_name
are set torequired
in the Bold Checkout admin, they are alsorequired
in this endpoint.
Note: If taxes were previously calculated, changes to the shipping address may affect those calculations. Taxes are not recalculated automatically, so you must call the Generate Taxes endpoint to recalculate taxes for the order.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 The identifier of the shop. Can be retrieved by making a request to the Get Info endpoint. |
public_order_id required | string Example: woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB The public order identifier generated when the order is initialized by making a request to the Initialize Order endpoint. |
Request Body schema: application/json
first_name | string The first name of the addressee. |
last_name | string The last name of the addressee. |
address_line_1 | string The street address. |
address_line_2 | string Any additional street address details (apt #, suite #, etc). |
country required | string The country name. |
city | string The city name. |
province | string The province or state name, if applicable. If |
country_code required | string The country code, in ISO 3166 format. |
province_code | string The province or state code, in ISO 3166 format, if applicable. If |
postal_code | string The postal/zip code. Required for most countries, including the United States, Canada, and Mexico. Validated on format only when provided. |
business_name | string If applicable, the business name. |
phone_number | string The phone number of the addressee. |
Responses
Request samples
- Payload
{- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
Response samples
- 200
- 401
- 422
{- "data": {
- "address": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "application_state": {
- "customer": {
- "platform_id": "50942578465125",
- "public_id": "pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA",
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true,
- "saved_addresses": [
- {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
]
}, - "addresses": {
- "shipping": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "billing": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
}, - "line_items": [
- {
- "product_data": {
- "id": "724bca",
- "product_title": "Oak Cheese Grater",
- "title": "Small",
- "properties": {
- "colour": "red",
- "size": "small"
}, - "description": "A handmade oak cheese grater to elevate your cheese-eating experience.",
- "quantity": 2,
- "price": 2350,
- "total_price": 4700,
- "visible": 1,
- "line_item_key": "ABC123",
- "barcode": "1234ABC",
- "compare_at_price": 4000,
- "weight": 1000,
- "weight_unit": "g",
- "product_id": "oak-cheese-grater",
- "variant_id": "oak-cheese-grater-small",
- "requires_shipping": true,
- "sku": "OAK_GRATER_SM",
- "taxable": true,
- "tags": "Kitchen, Cheese Board, Oak",
- "vendor": "Cheese Boards Unlimited",
- "total_weight": 2000,
- "localized_names": {
- "fr": "Gratteur à fromage en chêne",
- "ge": "Käsereibe aus Eichenholz"
}, - "localized_descriptions": {
- "fr": "Un gratteur à fromage en chêne faite à la main pour rehausser votre expérience de dégustation de fromage",
- "ge": "Eine handgefertigte Käsereibe aus Eichenholz, um Ihr Käseerlebnis zu verbessern"
}, - "localized_variant_names": {
- "fr": "Gratteur à fromage en chêne",
- "ge": "Käsereibe aus Eichenholz"
}
}, - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "fees": [
- {
- "amount": 500,
- "name": "Miscellaneous fee."
}
], - "discounts": [
- {
- "value": 500,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
], - "fulfilled_quantity": 2
}
], - "fees": [
- {
- "id": "123456789",
- "line_text": "Custom Fee — Added by Plugin",
- "fee_type": "fixed",
- "value": 10,
- "source": "PLUGIN",
- "plugin_uuid": "a52589f8-09df-11ed-b30e-f67072e164ee",
- "taxable": true,
- "show_description": true
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}, - {
- "value": 500,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
], - "payments": [
- {
- "gateway_public_id": "i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW",
- "amount": 4700,
- "currency": "CAD",
- "type": "spreedly",
- "display_string": "Credit Card Payment",
- "id": "",
- "token": "7uZAMRAf80KiEwibsrrM5IB41yU",
- "wallet_pay_type": "applepay",
- "retain": false,
- "payment_parameters": {
- "is_giftcard": true,
- "customer_segment_id": "ab4329tn23oe315"
}
}
], - "order_total": 4700,
- "order_meta_data": {
- "cart_parameters": {
- "key": "cp-key1",
- "property1": "A cart param.",
- "property2": "A cart param."
}, - "note_attributes": {
- "key": "na-key1",
- "property1": "A note attribute.",
- "property2": "A note attribute."
}, - "notes": "A special delivery note.",
- "tags": [
- "order-1"
]
}, - "shipping": {
- "selected_shipping": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}, - "available_shipping_lines": [
- {
- "id": "string",
- "line": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}
]
}, - "resumable_link": "example.com/checkout/resume",
- "flow_id": "external-company-one-page-template",
- "currency": {
- "iso_code": "CAD",
- "iso_numeric_code": 124,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "display_currency": {
- "iso_code": "USD",
- "iso_numeric_code": 840,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "display_exchange_rate": 1.357251,
- "created_via": "My_Order_Creating_Plugin",
- "is_processed": false,
- "order_id": 79047599,
- "platform_order_id": "1389wjfalsdf9y4r"
}
}
}
Delete Shipping Address
Clears the shipping address from the order.
Note: If taxes were previously calculated, changes to the shipping address may affect those calculations. Taxes are not recalculated automatically, so you must call the Generate Taxes endpoint to recalculate taxes for the order.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 The identifier of the shop. Can be retrieved by making a request to the Get Info endpoint. |
public_order_id required | string Example: woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB The public order identifier generated when the order is initialized by making a request to the Initialize Order endpoint. |
Responses
Response samples
- 200
- 401
{- "data": {
- "application_state": {
- "customer": {
- "platform_id": "50942578465125",
- "public_id": "pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA",
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true,
- "saved_addresses": [
- {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
]
}, - "addresses": {
- "shipping": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "billing": [ ]
}, - "line_items": [
- {
- "product_data": {
- "id": "724bca",
- "product_title": "Oak Cheese Grater",
- "title": "Small",
- "properties": {
- "colour": "red",
- "size": "small"
}, - "description": "A handmade oak cheese grater to elevate your cheese-eating experience.",
- "quantity": 2,
- "price": 2350,
- "total_price": 4700,
- "visible": 1,
- "line_item_key": "oak_cheese_grater_2643",
- "barcode": "1234ABC",
- "compare_at_price": 4000,
- "weight": 1000,
- "weight_unit": "g",
- "product_id": "oak-cheese-grater",
- "variant_id": "oak-cheese-grater-small",
- "requires_shipping": true,
- "sku": "OAK_GRATER_SM",
- "taxable": true,
- "tags": "Kitchen, Cheese Board, Oak",
- "vendor": "Cheese Boards Unlimited",
- "total_weight": 2000
}
}, - {
- "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
]
}, - {
- "fees": [
- {
- "amount": 500,
- "name": "Miscellaneous fee."
}
]
}, - {
- "discounts": [
- {
- "value": 0,
- "code": "CHOPCHOP",
- "text": "Cutting board discount",
- "source": "cart"
}
]
}, - {
- "fulfilled_quantity": 2
}
], - "fees": [
- {
- "id": "123456789",
- "line_text": "Custom Fee — Added by Plugin",
- "fee_type": "fixed",
- "value": 10,
- "source": "PLUGIN",
- "plugin_uuid": "a52589f8-09df-11ed-b30e-f67072e164ee",
- "taxable": true,
- "show_description": true
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "code": "CHOPCHOP",
- "text": "Cutting board discount",
- "source": "cart"
}, - {
- "value": 0,
- "code": "FREESHIPPING",
- "text": "FREESHIPPING",
- "source": "coupon"
}
], - "payments": [
- {
- "gateway_public_id": "i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW",
- "amount": 4700,
- "currency": "CAD",
- "type": "spreedly",
- "display_string": "Credit Card Payment",
- "id": "",
- "token": "7uZAMRAf80KiEwibsrrM5IB41yU",
- "retain": false,
- "payment_parameters": [ ]
}
], - "order_total": 4700,
- "order_meta_data": {
- "cart_parameters": {
- "key": "cp-key1,",
- "property1": "A cart param.",
- "property2": "A cart param."
}, - "note_attributes": {
- "key": "na-key1",
- "property1": "A note attribute.",
- "property2": "A note attribute."
}, - "notes": "A special delivery note.",
- "tags": [
- "order-1"
]
}, - "shipping": {
- "selected_shipping": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}, - "available_shipping_lines": [
- {
- "id": "string,",
- "line": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "code": "FREESHIPPING",
- "text": "FREESHIPPING",
- "source": "coupon"
}
]
}, - "resumable_link": "example.com/checkout/resume",
- "flow_id": "external-company-one-page-template",
- "currency": {
- "iso_code": "CAD",
- "iso_numeric_code": 124,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "created_via": "My_Order_Creating_Plugin",
- "is_processed": false,
- "order_id": 79047599,
- "platform_order_id": "1389wjfalsdf9y4r"
}
}
}
Set Billing Address
Sets the billing address on the order.
Each order can have only one billing address. If you call this endpoint and a billing address already exists, the existing address will be overwritten.
Set Billing Address calls Validate Address before setting the billing address.
Note: Checkout admin settings can override schema requirements for
phone_number
andbusiness_name
. Ifphone_number
orbusiness_name
are set torequired
in the Bold Checkout admin, they are alsorequired
in this endpoint.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 The identifier of the shop. Can be retrieved by making a request to the Get Info endpoint. |
public_order_id required | string Example: woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB The public order identifier generated when the order is initialized by making a request to the Initialize Order endpoint. |
Request Body schema: application/json
first_name | string The first name of the addressee. |
last_name | string The last name of the addressee. |
address_line_1 | string The street address. |
address_line_2 | string Any additional street address details (apt #, suite #, etc). |
country required | string The country name. |
city | string The city name. |
province | string The province or state name, if applicable. If |
country_code required | string The country code, in ISO 3166 format. |
province_code | string The province or state code, in ISO 3166 format, if applicable. If |
postal_code | string The postal/zip code. Required for most countries, including the United States, Canada, and Mexico. Validated on format only when provided. |
business_name | string If applicable, the business name. |
phone_number | string The phone number of the addressee. |
Responses
Request samples
- Payload
{- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
Response samples
- 200
- 401
- 422
{- "data": {
- "address": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "application_state": {
- "customer": {
- "platform_id": "50942578465125",
- "public_id": "pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA",
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true,
- "saved_addresses": [
- {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
]
}, - "addresses": {
- "shipping": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "billing": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
}, - "line_items": [
- {
- "product_data": {
- "id": "724bca",
- "product_title": "Oak Cheese Grater",
- "title": "Small",
- "properties": {
- "colour": "red",
- "size": "small"
}, - "description": "A handmade oak cheese grater to elevate your cheese-eating experience.",
- "quantity": 2,
- "price": 2350,
- "total_price": 4700,
- "visible": 1,
- "line_item_key": "ABC123",
- "barcode": "1234ABC",
- "compare_at_price": 4000,
- "weight": 1000,
- "weight_unit": "g",
- "product_id": "oak-cheese-grater",
- "variant_id": "oak-cheese-grater-small",
- "requires_shipping": true,
- "sku": "OAK_GRATER_SM",
- "taxable": true,
- "tags": "Kitchen, Cheese Board, Oak",
- "vendor": "Cheese Boards Unlimited",
- "total_weight": 2000,
- "localized_names": {
- "fr": "Gratteur à fromage en chêne",
- "ge": "Käsereibe aus Eichenholz"
}, - "localized_descriptions": {
- "fr": "Un gratteur à fromage en chêne faite à la main pour rehausser votre expérience de dégustation de fromage",
- "ge": "Eine handgefertigte Käsereibe aus Eichenholz, um Ihr Käseerlebnis zu verbessern"
}, - "localized_variant_names": {
- "fr": "Gratteur à fromage en chêne",
- "ge": "Käsereibe aus Eichenholz"
}
}, - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "fees": [
- {
- "amount": 500,
- "name": "Miscellaneous fee."
}
], - "discounts": [
- {
- "value": 500,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
], - "fulfilled_quantity": 2
}
], - "fees": [
- {
- "id": "123456789",
- "line_text": "Custom Fee — Added by Plugin",
- "fee_type": "fixed",
- "value": 10,
- "source": "PLUGIN",
- "plugin_uuid": "a52589f8-09df-11ed-b30e-f67072e164ee",
- "taxable": true,
- "show_description": true
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}, - {
- "value": 500,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
], - "payments": [
- {
- "gateway_public_id": "i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW",
- "amount": 4700,
- "currency": "CAD",
- "type": "spreedly",
- "display_string": "Credit Card Payment",
- "id": "",
- "token": "7uZAMRAf80KiEwibsrrM5IB41yU",
- "wallet_pay_type": "applepay",
- "retain": false,
- "payment_parameters": {
- "is_giftcard": true,
- "customer_segment_id": "ab4329tn23oe315"
}
}
], - "order_total": 4700,
- "order_meta_data": {
- "cart_parameters": {
- "key": "cp-key1",
- "property1": "A cart param.",
- "property2": "A cart param."
}, - "note_attributes": {
- "key": "na-key1",
- "property1": "A note attribute.",
- "property2": "A note attribute."
}, - "notes": "A special delivery note.",
- "tags": [
- "order-1"
]
}, - "shipping": {
- "selected_shipping": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}, - "available_shipping_lines": [
- {
- "id": "string",
- "line": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}
]
}, - "resumable_link": "example.com/checkout/resume",
- "flow_id": "external-company-one-page-template",
- "currency": {
- "iso_code": "CAD",
- "iso_numeric_code": 124,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "display_currency": {
- "iso_code": "USD",
- "iso_numeric_code": 840,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "display_exchange_rate": 1.357251,
- "created_via": "My_Order_Creating_Plugin",
- "is_processed": false,
- "order_id": 79047599,
- "platform_order_id": "1389wjfalsdf9y4r"
}
}
}
Get Billing Address
Get the billing address on the order.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 The identifier of the shop. Can be retrieved by making a request to the Get Info endpoint. |
public_order_id required | string Example: woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB The public order identifier generated when the order is initialized by making a request to the Initialize Order endpoint. |
Responses
Response samples
- 200
- 401
{- "data": {
- "address": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "application_state": {
- "customer": {
- "platform_id": "50942578465125",
- "public_id": "pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA",
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true,
- "saved_addresses": [
- {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
]
}, - "addresses": {
- "shipping": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "billing": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
}, - "line_items": [
- {
- "product_data": {
- "id": "724bca",
- "product_title": "Oak Cheese Grater",
- "title": "Small",
- "properties": {
- "colour": "red",
- "size": "small"
}, - "description": "A handmade oak cheese grater to elevate your cheese-eating experience.",
- "quantity": 2,
- "price": 2350,
- "total_price": 4700,
- "visible": 1,
- "line_item_key": "ABC123",
- "barcode": "1234ABC",
- "compare_at_price": 4000,
- "weight": 1000,
- "weight_unit": "g",
- "product_id": "oak-cheese-grater",
- "variant_id": "oak-cheese-grater-small",
- "requires_shipping": true,
- "sku": "OAK_GRATER_SM",
- "taxable": true,
- "tags": "Kitchen, Cheese Board, Oak",
- "vendor": "Cheese Boards Unlimited",
- "total_weight": 2000,
- "localized_names": {
- "fr": "Gratteur à fromage en chêne",
- "ge": "Käsereibe aus Eichenholz"
}, - "localized_descriptions": {
- "fr": "Un gratteur à fromage en chêne faite à la main pour rehausser votre expérience de dégustation de fromage",
- "ge": "Eine handgefertigte Käsereibe aus Eichenholz, um Ihr Käseerlebnis zu verbessern"
}, - "localized_variant_names": {
- "fr": "Gratteur à fromage en chêne",
- "ge": "Käsereibe aus Eichenholz"
}
}, - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "fees": [
- {
- "amount": 500,
- "name": "Miscellaneous fee."
}
], - "discounts": [
- {
- "value": 500,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
], - "fulfilled_quantity": 2
}
], - "fees": [
- {
- "id": "123456789",
- "line_text": "Custom Fee — Added by Plugin",
- "fee_type": "fixed",
- "value": 10,
- "source": "PLUGIN",
- "plugin_uuid": "a52589f8-09df-11ed-b30e-f67072e164ee",
- "taxable": true,
- "show_description": true
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}, - {
- "value": 500,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
], - "payments": [
- {
- "gateway_public_id": "i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW",
- "amount": 4700,
- "currency": "CAD",
- "type": "spreedly",
- "display_string": "Credit Card Payment",
- "id": "",
- "token": "7uZAMRAf80KiEwibsrrM5IB41yU",
- "wallet_pay_type": "applepay",
- "retain": false,
- "payment_parameters": {
- "is_giftcard": true,
- "customer_segment_id": "ab4329tn23oe315"
}
}
], - "order_total": 4700,
- "order_meta_data": {
- "cart_parameters": {
- "key": "cp-key1",
- "property1": "A cart param.",
- "property2": "A cart param."
}, - "note_attributes": {
- "key": "na-key1",
- "property1": "A note attribute.",
- "property2": "A note attribute."
}, - "notes": "A special delivery note.",
- "tags": [
- "order-1"
]
}, - "shipping": {
- "selected_shipping": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}, - "available_shipping_lines": [
- {
- "id": "string",
- "line": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}
]
}, - "resumable_link": "example.com/checkout/resume",
- "flow_id": "external-company-one-page-template",
- "currency": {
- "iso_code": "CAD",
- "iso_numeric_code": 124,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "display_currency": {
- "iso_code": "USD",
- "iso_numeric_code": 840,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "display_exchange_rate": 1.357251,
- "created_via": "My_Order_Creating_Plugin",
- "is_processed": false,
- "order_id": 79047599,
- "platform_order_id": "1389wjfalsdf9y4r"
}
}
}
Update Billing Address
Updates the billing address on the order.
This endpoint updates all fields of the billing address associated with the order, and any value left blank in this request body will be made blank in the updated address. The fields country
, country_code
, province
, and province_code
cannot be left blank.
Note: Checkout admin settings can override schema requirements for
phone_number
andbusiness_name
. Ifphone_number
orbusiness_name
are set torequired
in the Bold Checkout admin, they are alsorequired
in this endpoint.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 The identifier of the shop. Can be retrieved by making a request to the Get Info endpoint. |
public_order_id required | string Example: woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB The public order identifier generated when the order is initialized by making a request to the Initialize Order endpoint. |
Request Body schema: application/json
first_name | string The first name of the addressee. |
last_name | string The last name of the addressee. |
address_line_1 | string The street address. |
address_line_2 | string Any additional street address details (apt #, suite #, etc). |
country required | string The country name. |
city | string The city name. |
province | string The province or state name, if applicable. If |
country_code required | string The country code, in ISO 3166 format. |
province_code | string The province or state code, in ISO 3166 format, if applicable. If |
postal_code | string The postal/zip code. Required for most countries, including the United States, Canada, and Mexico. Validated on format only when provided. |
business_name | string If applicable, the business name. |
phone_number | string The phone number of the addressee. |
Responses
Request samples
- Payload
{- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
Response samples
- 200
- 401
- 422
{- "data": {
- "address": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "application_state": {
- "customer": {
- "platform_id": "50942578465125",
- "public_id": "pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA",
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true,
- "saved_addresses": [
- {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
]
}, - "addresses": {
- "shipping": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "billing": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
}, - "line_items": [
- {
- "product_data": {
- "id": "724bca",
- "product_title": "Oak Cheese Grater",
- "title": "Small",
- "properties": {
- "colour": "red",
- "size": "small"
}, - "description": "A handmade oak cheese grater to elevate your cheese-eating experience.",
- "quantity": 2,
- "price": 2350,
- "total_price": 4700,
- "visible": 1,
- "line_item_key": "ABC123",
- "barcode": "1234ABC",
- "compare_at_price": 4000,
- "weight": 1000,
- "weight_unit": "g",
- "product_id": "oak-cheese-grater",
- "variant_id": "oak-cheese-grater-small",
- "requires_shipping": true,
- "sku": "OAK_GRATER_SM",
- "taxable": true,
- "tags": "Kitchen, Cheese Board, Oak",
- "vendor": "Cheese Boards Unlimited",
- "total_weight": 2000,
- "localized_names": {
- "fr": "Gratteur à fromage en chêne",
- "ge": "Käsereibe aus Eichenholz"
}, - "localized_descriptions": {
- "fr": "Un gratteur à fromage en chêne faite à la main pour rehausser votre expérience de dégustation de fromage",
- "ge": "Eine handgefertigte Käsereibe aus Eichenholz, um Ihr Käseerlebnis zu verbessern"
}, - "localized_variant_names": {
- "fr": "Gratteur à fromage en chêne",
- "ge": "Käsereibe aus Eichenholz"
}
}, - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "fees": [
- {
- "amount": 500,
- "name": "Miscellaneous fee."
}
], - "discounts": [
- {
- "value": 500,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
], - "fulfilled_quantity": 2
}
], - "fees": [
- {
- "id": "123456789",
- "line_text": "Custom Fee — Added by Plugin",
- "fee_type": "fixed",
- "value": 10,
- "source": "PLUGIN",
- "plugin_uuid": "a52589f8-09df-11ed-b30e-f67072e164ee",
- "taxable": true,
- "show_description": true
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}, - {
- "value": 500,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
], - "payments": [
- {
- "gateway_public_id": "i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW",
- "amount": 4700,
- "currency": "CAD",
- "type": "spreedly",
- "display_string": "Credit Card Payment",
- "id": "",
- "token": "7uZAMRAf80KiEwibsrrM5IB41yU",
- "wallet_pay_type": "applepay",
- "retain": false,
- "payment_parameters": {
- "is_giftcard": true,
- "customer_segment_id": "ab4329tn23oe315"
}
}
], - "order_total": 4700,
- "order_meta_data": {
- "cart_parameters": {
- "key": "cp-key1",
- "property1": "A cart param.",
- "property2": "A cart param."
}, - "note_attributes": {
- "key": "na-key1",
- "property1": "A note attribute.",
- "property2": "A note attribute."
}, - "notes": "A special delivery note.",
- "tags": [
- "order-1"
]
}, - "shipping": {
- "selected_shipping": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}, - "available_shipping_lines": [
- {
- "id": "string",
- "line": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}
]
}, - "resumable_link": "example.com/checkout/resume",
- "flow_id": "external-company-one-page-template",
- "currency": {
- "iso_code": "CAD",
- "iso_numeric_code": 124,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "display_currency": {
- "iso_code": "USD",
- "iso_numeric_code": 840,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "display_exchange_rate": 1.357251,
- "created_via": "My_Order_Creating_Plugin",
- "is_processed": false,
- "order_id": 79047599,
- "platform_order_id": "1389wjfalsdf9y4r"
}
}
}
Delete Billing Address
Clears the billing address from the order.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 The identifier of the shop. Can be retrieved by making a request to the Get Info endpoint. |
public_order_id required | string Example: woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB The public order identifier generated when the order is initialized by making a request to the Initialize Order endpoint. |
Responses
Response samples
- 200
- 401
{- "data": {
- "application_state": {
- "customer": {
- "platform_id": "50942578465125",
- "public_id": "pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA",
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true,
- "saved_addresses": [
- {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
]
}, - "addresses": {
- "shipping": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "billing": [ ]
}, - "line_items": [
- {
- "product_data": {
- "id": "724bca",
- "product_title": "Oak Cheese Grater",
- "title": "Small",
- "properties": {
- "colour": "red",
- "size": "small"
}, - "description": "A handmade oak cheese grater to elevate your cheese-eating experience.",
- "quantity": 2,
- "price": 2350,
- "total_price": 4700,
- "visible": 1,
- "line_item_key": "oak_cheese_grater_2643",
- "barcode": "1234ABC",
- "compare_at_price": 4000,
- "weight": 1000,
- "weight_unit": "g",
- "product_id": "oak-cheese-grater",
- "variant_id": "oak-cheese-grater-small",
- "requires_shipping": true,
- "sku": "OAK_GRATER_SM",
- "taxable": true,
- "tags": "Kitchen, Cheese Board, Oak",
- "vendor": "Cheese Boards Unlimited",
- "total_weight": 2000
}
}, - {
- "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
]
}, - {
- "fees": [
- {
- "amount": 500,
- "name": "Miscellaneous fee."
}
]
}, - {
- "discounts": [
- {
- "value": 0,
- "code": "CHOPCHOP",
- "text": "Cutting board discount",
- "source": "cart"
}
]
}, - {
- "fulfilled_quantity": 2
}
], - "fees": [
- {
- "id": "123456789",
- "line_text": "Custom Fee — Added by Plugin",
- "fee_type": "fixed",
- "value": 10,
- "source": "PLUGIN",
- "plugin_uuid": "a52589f8-09df-11ed-b30e-f67072e164ee",
- "taxable": true,
- "show_description": true
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "code": "CHOPCHOP",
- "text": "Cutting board discount",
- "source": "cart"
}, - {
- "value": 0,
- "code": "FREESHIPPING",
- "text": "FREESHIPPING",
- "source": "coupon"
}
], - "payments": [
- {
- "gateway_public_id": "i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW",
- "amount": 4700,
- "currency": "CAD",
- "type": "spreedly",
- "display_string": "Credit Card Payment",
- "id": "",
- "token": "7uZAMRAf80KiEwibsrrM5IB41yU",
- "retain": false,
- "payment_parameters": [ ]
}
], - "order_total": 4700,
- "order_meta_data": {
- "cart_parameters": {
- "key": "cp-key1,",
- "property1": "A cart param.",
- "property2": "A cart param."
}, - "note_attributes": {
- "key": "na-key1",
- "property1": "A note attribute.",
- "property2": "A note attribute."
}, - "notes": "A special delivery note.",
- "tags": [
- "order-1"
]
}, - "shipping": {
- "selected_shipping": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}, - "available_shipping_lines": [
- {
- "id": "string,",
- "line": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "code": "FREESHIPPING",
- "text": "FREESHIPPING",
- "source": "coupon"
}
]
}, - "resumable_link": "example.com/checkout/resume",
- "flow_id": "external-company-one-page-template",
- "currency": {
- "iso_code": "CAD",
- "iso_numeric_code": 124,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "created_via": "My_Order_Creating_Plugin",
- "is_processed": false,
- "order_id": 79047599,
- "platform_order_id": "1389wjfalsdf9y4r"
}
}
}
Validate Address
Validates if the given postal code matches up with postal codes from Canada, US, Ireland, Great Britain, France or Singapore. This endpoint also validates the state/province provided, if required by country. Countries that require a state/province in their address are listed in the Country and Province/State Requirements reference.
Calls to the Set Shipping Address, Set Billing Address, Update Shipping Address, or Update Billing Address endpoints apply the same validations applied by this endpoint.
Calling this endpoint does not change the application state or apply the address. While not required, it can be helpful to call this endpoint before setting or updating an address on an order, especially if you want to implement custom error handling in more complicated address scenarios.
Note: Checkout admin settings can override schema requirements for
phone_number
andbusiness_name
. Ifphone_number
orbusiness_name
are set torequired
in the Bold Checkout admin, they are alsorequired
in this endpoint.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 The identifier of the shop. Can be retrieved by making a request to the Get Info endpoint. |
public_order_id required | string Example: woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB The public order identifier generated when the order is initialized by making a request to the Initialize Order endpoint. |
Request Body schema: application/json
first_name | string The first name of the addressee. |
last_name | string The last name of the addressee. |
address_line_1 | string The street address. |
address_line_2 | string Any additional street address details (apt #, suite #, etc). |
country required | string The country name. |
city | string The city name. |
province | string The province or state name, if applicable. If |
country_code required | string The country code, in ISO 3166 format. |
province_code | string The province or state code, in ISO 3166 format, if applicable. If |
postal_code | string The postal/zip code. Required for most countries, including the United States, Canada, and Mexico. Validated on format only when provided. |
business_name | string If applicable, the business name. |
phone_number | string The phone number of the addressee. |
Responses
Request samples
- Payload
{- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
Response samples
- 200
- 401
- 422
{- "data": [ ]
}
Batch Process
Processes a series of API calls in a single request. Sub-requests are evaluated serially. If one of the sub-requests returns an error, processing halts and any requests after the failed request are not processed.
Not all endpoints support batch processing. For a full list of supported endpoints and additional information, refer to Submit a Batch Processing Request.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 The identifier of the shop. Can be retrieved by making a request to the Get Info endpoint. |
public_order_id required | string Example: woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB The public order identifier generated when the order is initialized by making a request to the Initialize Order endpoint. |
Request Body schema: application/json
Array of objects (Sub-Request) | |||||||
Array
|
Responses
Request samples
- Payload
{- "sub_requests": [
- {
- "method": "GET",
- "endpoint": "/validate_email_address",
}, - {
- "method": "POST",
- "endpoint": "/customer/guest",
- "payload": {
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true
}
}
]
}
Response samples
- 200
- 422
{- "application_state": {
- "customer": {
- "platform_id": "",
- "public_id": "pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA",
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true,
- "saved_addresses": [ ]
}, - "addresses": {
- "shipping": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "billing": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
}, - "line_items": [
- {
- "product_data": {
- "id": "724bca",
- "product_title": "Oak Cheese Grater",
- "title": "Small",
- "properties": {
- "colour": "red",
- "size": "small"
}, - "description": "A handmade oak cheese grater to elevate your cheese-eating experience.",
- "quantity": 2,
- "price": 2350,
- "total_price": 4700,
- "visible": 1,
- "line_item_key": "oak_cheese_grater_2643",
- "barcode": "1234ABC",
- "compare_at_price": 4000,
- "weight": 1000,
- "weight_unit": "g",
- "product_id": "oak-cheese-grater",
- "variant_id": "oak-cheese-grater-small",
- "requires_shipping": true,
- "sku": "OAK_GRATER_SM",
- "taxable": true,
- "tags": "Kitchen, Cheese Board, Oak",
- "vendor": "Cheese Boards Unlimited",
- "total_weight": 2000
}
}, - {
- "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
]
}, - {
- "fees": [
- {
- "amount": 500,
- "name": "Miscellaneous fee."
}
]
}, - {
- "discounts": [
- {
- "value": 0,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
]
}, - {
- "fulfilled_quantity": 2
}
], - "fees": [
- {
- "id": "123456789",
- "line_text": "Custom Fee — Added by Plugin",
- "fee_type": "fixed",
- "value": 10,
- "source": "PLUGIN",
- "plugin_uuid": "a52589f8-09df-11ed-b30e-f67072e164ee",
- "taxable": true,
- "show_description": true
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}, - {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}
], - "payments": [
- {
- "gateway_public_id": "i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW",
- "amount": 4700,
- "currency": "CAD",
- "type": "spreedly",
- "display_string": "Credit Card Payment",
- "id": "",
- "token": "7uZAMRAf80KiEwibsrrM5IB41yU",
- "retain": false,
- "payment_parameters": [ ]
}
], - "order_total": 4700,
- "order_meta_data": {
- "cart_parameters": {
- "key": "cp-key1,",
- "property1": "A cart param.",
- "property2": "A cart param."
}, - "note_attributes": {
- "key": "na-key1",
- "property1": "A note attribute.",
- "property2": "A note attribute."
}, - "notes": "A special delivery note.",
- "tags": [
- "order-1"
]
}, - "shipping": {
- "selected_shipping": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}, - "available_shipping_lines": [
- {
- "id": "string,",
- "line": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}
]
}, - "resumable_link": "example.com/checkout/resume",
- "flow_id": "external-company-one-page-template",
- "currency": {
- "iso_code": "CAD",
- "iso_numeric_code": 124,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "created_via": "My_Order_Creating_Plugin",
- "is_processed": false,
- "order_id": 79047599,
- "platform_order_id": "1389wjfalsdf9y4r"
}, - "data": [
- {
- "data": [ ],
- "status_code": "200,",
- "method": "GET",
- "endpoint": "/validate_email_address"
}, - {
- "data": {
- "customer": {
- "platform_id": "",
- "public_id": "pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA",
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true,
- "saved_addresses": [ ]
}
}, - "status_code": 200,
- "method": "POST",
- "endpoint": "/customer/guest"
}
]
}
A child of the Order resource. Contains information about guest customers on your store, including name and email. Use these endpoints to add or remove a guest customer to an order.
Create Guest Customer
Creates a new guest customer and associates it with the order.
You cannot create a new guest customer when there is already one on the order.
To add a new guest customer to an order or add an authenticated customer, you must first delete the existing customer using the Delete Customer endpoint.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 The identifier of the shop. Can be retrieved by making a request to the Get Info endpoint. |
public_order_id required | string Example: woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB The public order identifier generated when the order is initialized by making a request to the Initialize Order endpoint. |
Request Body schema: application/json
first_name required | string The customer's first name. |
last_name required | string The customer's last name. |
email_address required | string The customer's email address. |
accepts_marketing | boolean Default: false If the customer would like to receive any sort of marketing emails. Defaults to |
Responses
Request samples
- Payload
{- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": false
}
Response samples
- 200
- 401
- 422
{- "data": {
- "customer": {
- "platform_id": "",
- "public_id": "pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA",
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true,
- "saved_addresses": [ ]
}, - "application_state": {
- "customer": {
- "platform_id": "",
- "public_id": "pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA",
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true,
- "saved_addresses": [ ]
}, - "addresses": {
- "shipping": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "billing": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
}, - "line_items": [
- {
- "product_data": {
- "id": "724bca",
- "product_title": "Oak Cheese Grater",
- "title": "Small",
- "properties": {
- "colour": "red",
- "size": "small"
}, - "description": "A handmade oak cheese grater to elevate your cheese-eating experience.",
- "quantity": 2,
- "price": 2350,
- "total_price": 4700,
- "visible": 1,
- "line_item_key": "oak_cheese_grater_2643",
- "barcode": "1234ABC",
- "compare_at_price": 4000,
- "weight": 1000,
- "weight_unit": "g",
- "product_id": "oak-cheese-grater",
- "variant_id": "oak-cheese-grater-small",
- "requires_shipping": true,
- "sku": "OAK_GRATER_SM",
- "taxable": true,
- "tags": "Kitchen, Cheese Board, Oak",
- "vendor": "Cheese Boards Unlimited",
- "total_weight": 2000
}
}, - {
- "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
]
}, - {
- "fees": [
- {
- "amount": 500,
- "name": "Miscellaneous fee."
}
]
}, - {
- "discounts": [
- {
- "value": 0,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
]
}, - {
- "fulfilled_quantity": 2
}
], - "fees": [
- {
- "id": "123456789",
- "line_text": "Custom Fee — Added by Plugin",
- "fee_type": "fixed",
- "value": 10,
- "source": "PLUGIN",
- "plugin_uuid": "a52589f8-09df-11ed-b30e-f67072e164ee",
- "taxable": true,
- "show_description": true
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}, - {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}
], - "payments": [
- {
- "gateway_public_id": "i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW",
- "amount": 4700,
- "currency": "CAD",
- "type": "spreedly",
- "display_string": "Credit Card Payment",
- "id": "",
- "token": "7uZAMRAf80KiEwibsrrM5IB41yU",
- "retain": false,
- "payment_parameters": [ ]
}
], - "order_total": 4700,
- "order_meta_data": {
- "cart_parameters": {
- "key": "cp-key1,",
- "property1": "A cart param.",
- "property2": "A cart param."
}, - "note_attributes": {
- "key": "na-key1",
- "property1": "A note attribute.",
- "property2": "A note attribute."
}, - "notes": "A special delivery note.",
- "tags": [
- "order-1"
]
}, - "shipping": {
- "selected_shipping": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}, - "available_shipping_lines": [
- {
- "id": "string,",
- "line": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}
]
}, - "resumable_link": "example.com/checkout/resume",
- "flow_id": "external-company-one-page-template",
- "currency": {
- "iso_code": "CAD",
- "iso_numeric_code": 124,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "created_via": "My_Order_Creating_Plugin",
- "is_processed": false,
- "order_id": 79047599,
- "platform_order_id": "1389wjfalsdf9y4r"
}
}
}
Update Guest Customer Deprecated
Note: This endpoint is deprecated. Instead, use the Update Customer endpoint to make edits to the customer on the order.
Updates the guest customer on the order.
Cannot update customer data that was provided from the Initialize Order endpoint.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 The identifier of the shop. Can be retrieved by making a request to the Get Info endpoint. |
public_order_id required | string Example: woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB The public order identifier generated when the order is initialized by making a request to the Initialize Order endpoint. |
Request Body schema: application/json
first_name required | string The customer's first name. |
last_name required | string The customer's last name. |
email_address required | string The customer's email address. |
accepts_marketing | boolean Default: false If the customer would like to receive any sort of marketing emails. Defaults to |
Responses
Request samples
- Payload
{- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": false
}
Response samples
- 200
- 401
- 422
{- "data": {
- "customer": {
- "platform_id": "",
- "public_id": "pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA",
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true,
- "saved_addresses": [ ]
}, - "application_state": {
- "customer": {
- "platform_id": "",
- "public_id": "pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA",
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true,
- "saved_addresses": [ ]
}, - "addresses": {
- "shipping": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "billing": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
}, - "line_items": [
- {
- "product_data": {
- "id": "724bca",
- "product_title": "Oak Cheese Grater",
- "title": "Small",
- "properties": {
- "colour": "red",
- "size": "small"
}, - "description": "A handmade oak cheese grater to elevate your cheese-eating experience.",
- "quantity": 2,
- "price": 2350,
- "total_price": 4700,
- "visible": 1,
- "line_item_key": "oak_cheese_grater_2643",
- "barcode": "1234ABC",
- "compare_at_price": 4000,
- "weight": 1000,
- "weight_unit": "g",
- "product_id": "oak-cheese-grater",
- "variant_id": "oak-cheese-grater-small",
- "requires_shipping": true,
- "sku": "OAK_GRATER_SM",
- "taxable": true,
- "tags": "Kitchen, Cheese Board, Oak",
- "vendor": "Cheese Boards Unlimited",
- "total_weight": 2000
}
}, - {
- "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
]
}, - {
- "fees": [
- {
- "amount": 500,
- "name": "Miscellaneous fee."
}
]
}, - {
- "discounts": [
- {
- "value": 0,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
]
}, - {
- "fulfilled_quantity": 2
}
], - "fees": [
- {
- "id": "123456789",
- "line_text": "Custom Fee — Added by Plugin",
- "fee_type": "fixed",
- "value": 10,
- "source": "PLUGIN",
- "plugin_uuid": "a52589f8-09df-11ed-b30e-f67072e164ee",
- "taxable": true,
- "show_description": true
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}, - {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}
], - "payments": [
- {
- "gateway_public_id": "i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW",
- "amount": 4700,
- "currency": "CAD",
- "type": "spreedly",
- "display_string": "Credit Card Payment",
- "id": "",
- "token": "7uZAMRAf80KiEwibsrrM5IB41yU",
- "retain": false,
- "payment_parameters": [ ]
}
], - "order_total": 4700,
- "order_meta_data": {
- "cart_parameters": {
- "key": "cp-key1,",
- "property1": "A cart param.",
- "property2": "A cart param."
}, - "note_attributes": {
- "key": "na-key1",
- "property1": "A note attribute.",
- "property2": "A note attribute."
}, - "notes": "A special delivery note.",
- "tags": [
- "order-1"
]
}, - "shipping": {
- "selected_shipping": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}, - "available_shipping_lines": [
- {
- "id": "string,",
- "line": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}
]
}, - "resumable_link": "example.com/checkout/resume",
- "flow_id": "external-company-one-page-template",
- "currency": {
- "iso_code": "CAD",
- "iso_numeric_code": 124,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "created_via": "My_Order_Creating_Plugin",
- "is_processed": false,
- "order_id": 79047599,
- "platform_order_id": "1389wjfalsdf9y4r"
}
}
}
Update Customer
Updates the customer on the order.
This endpoint does not update the platform_id
, public_id
, or saved_addresses
fields.
You can add customers to the order via the Initialize Order, the Create Authenticated Customer and the Create Guest Customer endpoints.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 The identifier of the shop. Can be retrieved by making a request to the Get Info endpoint. |
public_order_id required | string Example: woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB The public order identifier generated when the order is initialized by making a request to the Initialize Order endpoint. |
Request Body schema: application/json
first_name required | string The customer's first name. |
last_name required | string The customer's last name. |
email_address required | string The customer's email address. |
accepts_marketing | boolean Default: false If the customer would like to receive any sort of marketing emails. Defaults to |
Responses
Request samples
- Payload
{- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": false
}
Response samples
- 200
- 401
- 422
{- "data": {
- "customer": {
- "platform_id": "",
- "public_id": "pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA",
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true,
- "saved_addresses": [ ]
}, - "application_state": {
- "customer": {
- "platform_id": "",
- "public_id": "pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA",
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true,
- "saved_addresses": [ ]
}, - "addresses": {
- "shipping": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "billing": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
}, - "line_items": [
- {
- "product_data": {
- "id": "724bca",
- "product_title": "Oak Cheese Grater",
- "title": "Small",
- "properties": {
- "colour": "red",
- "size": "small"
}, - "description": "A handmade oak cheese grater to elevate your cheese-eating experience.",
- "quantity": 2,
- "price": 2350,
- "total_price": 4700,
- "visible": 1,
- "line_item_key": "oak_cheese_grater_2643",
- "barcode": "1234ABC",
- "compare_at_price": 4000,
- "weight": 1000,
- "weight_unit": "g",
- "product_id": "oak-cheese-grater",
- "variant_id": "oak-cheese-grater-small",
- "requires_shipping": true,
- "sku": "OAK_GRATER_SM",
- "taxable": true,
- "tags": "Kitchen, Cheese Board, Oak",
- "vendor": "Cheese Boards Unlimited",
- "total_weight": 2000
}
}, - {
- "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
]
}, - {
- "fees": [
- {
- "amount": 500,
- "name": "Miscellaneous fee."
}
]
}, - {
- "discounts": [
- {
- "value": 0,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
]
}, - {
- "fulfilled_quantity": 2
}
], - "fees": [
- {
- "id": "123456789",
- "line_text": "Custom Fee — Added by Plugin",
- "fee_type": "fixed",
- "value": 10,
- "source": "PLUGIN",
- "plugin_uuid": "a52589f8-09df-11ed-b30e-f67072e164ee",
- "taxable": true,
- "show_description": true
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}, - {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}
], - "payments": [
- {
- "gateway_public_id": "i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW",
- "amount": 4700,
- "currency": "CAD",
- "type": "spreedly",
- "display_string": "Credit Card Payment",
- "id": "",
- "token": "7uZAMRAf80KiEwibsrrM5IB41yU",
- "retain": false,
- "payment_parameters": [ ]
}
], - "order_total": 4700,
- "order_meta_data": {
- "cart_parameters": {
- "key": "cp-key1,",
- "property1": "A cart param.",
- "property2": "A cart param."
}, - "note_attributes": {
- "key": "na-key1",
- "property1": "A note attribute.",
- "property2": "A note attribute."
}, - "notes": "A special delivery note.",
- "tags": [
- "order-1"
]
}, - "shipping": {
- "selected_shipping": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}, - "available_shipping_lines": [
- {
- "id": "string,",
- "line": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}
]
}, - "resumable_link": "example.com/checkout/resume",
- "flow_id": "external-company-one-page-template",
- "currency": {
- "iso_code": "CAD",
- "iso_numeric_code": 124,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "created_via": "My_Order_Creating_Plugin",
- "is_processed": false,
- "order_id": 79047599,
- "platform_order_id": "1389wjfalsdf9y4r"
}
}
}
Get Customer
Retrieves information about the customer on the order.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 The identifier of the shop. Can be retrieved by making a request to the Get Info endpoint. |
public_order_id required | string Example: woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB The public order identifier generated when the order is initialized by making a request to the Initialize Order endpoint. |
Responses
Response samples
- 200
- 401
{- "data": {
- "customer": {
- "platform_id": "50942578465125",
- "public_id": "pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA",
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true,
- "saved_addresses": [
- {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
]
}, - "application_state": {
- "customer": {
- "platform_id": "50942578465125",
- "public_id": "pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA",
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true,
- "saved_addresses": [
- {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
]
}, - "addresses": {
- "shipping": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "billing": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
}, - "line_items": [
- {
- "product_data": {
- "id": "724bca",
- "product_title": "Oak Cheese Grater",
- "title": "Small",
- "properties": {
- "colour": "red",
- "size": "small"
}, - "description": "A handmade oak cheese grater to elevate your cheese-eating experience.",
- "quantity": 2,
- "price": 2350,
- "total_price": 4700,
- "visible": 1,
- "line_item_key": "ABC123",
- "barcode": "1234ABC",
- "compare_at_price": 4000,
- "weight": 1000,
- "weight_unit": "g",
- "product_id": "oak-cheese-grater",
- "variant_id": "oak-cheese-grater-small",
- "requires_shipping": true,
- "sku": "OAK_GRATER_SM",
- "taxable": true,
- "tags": "Kitchen, Cheese Board, Oak",
- "vendor": "Cheese Boards Unlimited",
- "total_weight": 2000,
- "localized_names": {
- "fr": "Gratteur à fromage en chêne",
- "ge": "Käsereibe aus Eichenholz"
}, - "localized_descriptions": {
- "fr": "Un gratteur à fromage en chêne faite à la main pour rehausser votre expérience de dégustation de fromage",
- "ge": "Eine handgefertigte Käsereibe aus Eichenholz, um Ihr Käseerlebnis zu verbessern"
}, - "localized_variant_names": {
- "fr": "Gratteur à fromage en chêne",
- "ge": "Käsereibe aus Eichenholz"
}
}, - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "fees": [
- {
- "amount": 500,
- "name": "Miscellaneous fee."
}
], - "discounts": [
- {
- "value": 500,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
], - "fulfilled_quantity": 2
}
], - "fees": [
- {
- "id": "123456789",
- "line_text": "Custom Fee — Added by Plugin",
- "fee_type": "fixed",
- "value": 10,
- "source": "PLUGIN",
- "plugin_uuid": "a52589f8-09df-11ed-b30e-f67072e164ee",
- "taxable": true,
- "show_description": true
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}, - {
- "value": 500,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
], - "payments": [
- {
- "gateway_public_id": "i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW",
- "amount": 4700,
- "currency": "CAD",
- "type": "spreedly",
- "display_string": "Credit Card Payment",
- "id": "",
- "token": "7uZAMRAf80KiEwibsrrM5IB41yU",
- "wallet_pay_type": "applepay",
- "retain": false,
- "payment_parameters": {
- "is_giftcard": true,
- "customer_segment_id": "ab4329tn23oe315"
}
}
], - "order_total": 4700,
- "order_meta_data": {
- "cart_parameters": {
- "key": "cp-key1",
- "property1": "A cart param.",
- "property2": "A cart param."
}, - "note_attributes": {
- "key": "na-key1",
- "property1": "A note attribute.",
- "property2": "A note attribute."
}, - "notes": "A special delivery note.",
- "tags": [
- "order-1"
]
}, - "shipping": {
- "selected_shipping": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}, - "available_shipping_lines": [
- {
- "id": "string",
- "line": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}
]
}, - "resumable_link": "example.com/checkout/resume",
- "flow_id": "external-company-one-page-template",
- "currency": {
- "iso_code": "CAD",
- "iso_numeric_code": 124,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "display_currency": {
- "iso_code": "USD",
- "iso_numeric_code": 840,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "display_exchange_rate": 1.357251,
- "created_via": "My_Order_Creating_Plugin",
- "is_processed": false,
- "order_id": 79047599,
- "platform_order_id": "1389wjfalsdf9y4r"
}
}
}
Delete Customer
Deletes the customer from the order.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 The identifier of the shop. Can be retrieved by making a request to the Get Info endpoint. |
public_order_id required | string Example: woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB The public order identifier generated when the order is initialized by making a request to the Initialize Order endpoint. |
Responses
Response samples
- 200
- 401
{- "data": {
- "application_state": {
- "customer": [ ],
- "addresses": {
- "shipping": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "billing": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
}, - "line_items": [
- {
- "product_data": {
- "id": "724bca",
- "product_title": "Oak Cheese Grater",
- "title": "Small",
- "properties": {
- "colour": "red",
- "size": "small"
}, - "description": "A handmade oak cheese grater to elevate your cheese-eating experience.",
- "quantity": 2,
- "price": 2350,
- "total_price": 4700,
- "visible": 1,
- "line_item_key": "oak_cheese_grater_2643",
- "barcode": "1234ABC",
- "compare_at_price": 4000,
- "weight": 1000,
- "weight_unit": "g",
- "product_id": "oak-cheese-grater",
- "variant_id": "oak-cheese-grater-small",
- "requires_shipping": true,
- "sku": "OAK_GRATER_SM",
- "taxable": true,
- "tags": "Kitchen, Cheese Board, Oak",
- "vendor": "Cheese Boards Unlimited",
- "total_weight": 2000
}
}, - {
- "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
]
}, - {
- "fees": [
- {
- "amount": 500,
- "name": "Miscellaneous fee."
}
]
}, - {
- "discounts": [
- {
- "value": 0,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}, - {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}
]
}, - {
- "fulfilled_quantity": 2
}
], - "fees": [
- {
- "id": "123456789",
- "line_text": "Custom Fee — Added by Plugin",
- "fee_type": "fixed",
- "value": 10,
- "source": "PLUGIN",
- "plugin_uuid": "a52589f8-09df-11ed-b30e-f67072e164ee",
- "taxable": true,
- "show_description": true
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "code": "FREESHIPPING",
- "text": "FREESHIPPING",
- "value": 500,
- "source": "coupon"
}
], - "payments": [
- {
- "gateway_public_id": "i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW",
- "amount": 4700,
- "currency": "CAD",
- "type": "spreedly",
- "display_string": "Credit Card Payment",
- "id": "",
- "token": "7uZAMRAf80KiEwibsrrM5IB41yU",
- "retain": false,
- "payment_parameters": [ ]
}
], - "order_total": 4700,
- "order_meta_data": {
- "cart_parameters": {
- "key": "cp-key1,",
- "property1": "A cart param.",
- "property2": "A cart param."
}, - "note_attributes": {
- "key": "na-key1",
- "property1": "A note attribute.",
- "property2": "A note attribute."
}, - "notes": "A special delivery note.",
- "tags": [
- "order-1"
]
}, - "shipping": {
- "selected_shipping": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}, - "available_shipping_lines": [
- {
- "id": "string,",
- "line": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 500,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}
]
}, - "resumable_link": "example.com/checkout/resume",
- "flow_id": "external-company-one-page-template",
- "currency": {
- "iso_code": "CAD",
- "iso_numeric_code": 124,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "created_via": "My_Order_Creating_Plugin",
- "is_processed": false,
- "order_id": 79047599,
- "platform_order_id": "1389wjfalsdf9y4r"
}
}
}
Validate Email Address
Validates the email address and performs an MX check to make sure the domain can accept email.
Note that this endpoint does not validate that the the email address exists on the domain.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 The identifier of the shop. Can be retrieved by making a request to the Get Info endpoint. |
public_order_id required | string Example: woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB The public order identifier generated when the order is initialized by making a request to the Initialize Order endpoint. |
query Parameters
email_address required |
Responses
Response samples
- 200
- 401
- 422
{- "data": [ ]
}
Contains information about discount codes that have been applied to an order. Use these endpoints to manipulate discount codes on an order.
Add Discount Code
Applies a discount code to the current order.
This endpoint applies an order-level discount code with a source
of coupon
. Each order may have only one coupon
discount. If you attempt to add more than one, this endpoint returns an error, and the second discount code is not added.
To add a discount code at the line item level, refer to the discount_line_items plugin action.
Note: This endpoint does not create a new discount code. New discount codes can be created in the Bold Checkout admin.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 The identifier of the shop. Can be retrieved by making a request to the Get Info endpoint. |
public_order_id required | string Example: woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB The public order identifier generated when the order is initialized by making a request to the Initialize Order endpoint. |
Request Body schema: application/json
code required | string The discount code. |
Responses
Request samples
- Payload
{- "code": "FREESHIPPING"
}
Response samples
- 200
- 401
- 422
{- "data": {
- "discount": {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}, - "application_state": {
- "customer": {
- "platform_id": "50942578465125",
- "public_id": "pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA",
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true,
- "saved_addresses": [
- {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
]
}, - "addresses": {
- "shipping": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "billing": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
}, - "line_items": [
- {
- "product_data": {
- "id": "724bca",
- "product_title": "Oak Cheese Grater",
- "title": "Small",
- "properties": {
- "colour": "red",
- "size": "small"
}, - "description": "A handmade oak cheese grater to elevate your cheese-eating experience.",
- "quantity": 2,
- "price": 2350,
- "total_price": 4700,
- "visible": 1,
- "line_item_key": "ABC123",
- "barcode": "1234ABC",
- "compare_at_price": 4000,
- "weight": 1000,
- "weight_unit": "g",
- "product_id": "oak-cheese-grater",
- "variant_id": "oak-cheese-grater-small",
- "requires_shipping": true,
- "sku": "OAK_GRATER_SM",
- "taxable": true,
- "tags": "Kitchen, Cheese Board, Oak",
- "vendor": "Cheese Boards Unlimited",
- "total_weight": 2000,
- "localized_names": {
- "fr": "Gratteur à fromage en chêne",
- "ge": "Käsereibe aus Eichenholz"
}, - "localized_descriptions": {
- "fr": "Un gratteur à fromage en chêne faite à la main pour rehausser votre expérience de dégustation de fromage",
- "ge": "Eine handgefertigte Käsereibe aus Eichenholz, um Ihr Käseerlebnis zu verbessern"
}, - "localized_variant_names": {
- "fr": "Gratteur à fromage en chêne",
- "ge": "Käsereibe aus Eichenholz"
}
}, - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "fees": [
- {
- "amount": 500,
- "name": "Miscellaneous fee."
}
], - "discounts": [
- {
- "value": 500,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
], - "fulfilled_quantity": 2
}
], - "fees": [
- {
- "id": "123456789",
- "line_text": "Custom Fee — Added by Plugin",
- "fee_type": "fixed",
- "value": 10,
- "source": "PLUGIN",
- "plugin_uuid": "a52589f8-09df-11ed-b30e-f67072e164ee",
- "taxable": true,
- "show_description": true
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}, - {
- "value": 500,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
], - "payments": [
- {
- "gateway_public_id": "i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW",
- "amount": 4700,
- "currency": "CAD",
- "type": "spreedly",
- "display_string": "Credit Card Payment",
- "id": "",
- "token": "7uZAMRAf80KiEwibsrrM5IB41yU",
- "wallet_pay_type": "applepay",
- "retain": false,
- "payment_parameters": {
- "is_giftcard": true,
- "customer_segment_id": "ab4329tn23oe315"
}
}
], - "order_total": 4700,
- "order_meta_data": {
- "cart_parameters": {
- "key": "cp-key1",
- "property1": "A cart param.",
- "property2": "A cart param."
}, - "note_attributes": {
- "key": "na-key1",
- "property1": "A note attribute.",
- "property2": "A note attribute."
}, - "notes": "A special delivery note.",
- "tags": [
- "order-1"
]
}, - "shipping": {
- "selected_shipping": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}, - "available_shipping_lines": [
- {
- "id": "string",
- "line": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}
]
}, - "resumable_link": "example.com/checkout/resume",
- "flow_id": "external-company-one-page-template",
- "currency": {
- "iso_code": "CAD",
- "iso_numeric_code": 124,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "display_currency": {
- "iso_code": "USD",
- "iso_numeric_code": 840,
- "symbol": "$",
- "format": "${{amount}}",
- "has_decimal": true,
- "show_iso_code": true
}, - "display_exchange_rate": 1.357251,
- "created_via": "My_Order_Creating_Plugin",
- "is_processed": false,
- "order_id": 79047599,
- "platform_order_id": "1389wjfalsdf9y4r"
}
}
}
List Discount Codes
Retrieves all discount codes applied to the order, shipping, or individual line items, if applicable. If the order is not discounted, the endpoint returns an empty discounts
array.
Authorizations:
path Parameters
shop_identifier required | string Example: zp3oafdor9 The identifier of the shop. Can be retrieved by making a request to the Get Info endpoint. |
public_order_id required | string Example: woiph4vhqss9jjr50lR5am7IWurQ8FdbmtdOj4aaFIOfFiFGcvhY6x1t6eT0GoB The public order identifier generated when the order is initialized by making a request to the Initialize Order endpoint. |
Responses
Response samples
- 200
- 401
{- "data": {
- "discounts": [
- {
- "value": 0,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}, - {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}
], - "application_state": {
- "customer": {
- "platform_id": "",
- "public_id": "pjpTyGh8KzNQ225wPqxgy7LwNuC887h6ecGyp3omwT4XW8SszjVSdHzWHN4NBwqhA",
- "first_name": "John",
- "last_name": "Doe",
- "accepts_marketing": true,
- "saved_addresses": [ ]
}, - "addresses": {
- "shipping": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}, - "billing": {
- "id": "123",
- "first_name": "John",
- "last_name": "Doe",
- "address_line_1": "50 Fultz Blvd",
- "address_line_2": "Suite 200",
- "country": "Canada",
- "city": "Winnipeg",
- "province": "Manitoba",
- "country_code": "CA",
- "province_code": "MB",
- "postal_code": "R3Y0L6",
- "business_name": "Acme Inc.",
- "phone_number": "8005550101"
}
}, - "line_items": [
- {
- "product_data": {
- "id": "724bca",
- "product_title": "Oak Cheese Grater",
- "title": "Small",
- "properties": {
- "colour": "red",
- "size": "small"
}, - "description": "A handmade oak cheese grater to elevate your cheese-eating experience.",
- "quantity": 2,
- "price": 2350,
- "total_price": 4700,
- "visible": 1,
- "line_item_key": "oak_cheese_grater_2643",
- "barcode": "1234ABC",
- "compare_at_price": 4000,
- "weight": 1000,
- "weight_unit": "g",
- "product_id": "oak-cheese-grater",
- "variant_id": "oak-cheese-grater-small",
- "requires_shipping": true,
- "sku": "OAK_GRATER_SM",
- "taxable": true,
- "tags": "Kitchen, Cheese Board, Oak",
- "vendor": "Cheese Boards Unlimited",
- "total_weight": 2000
}
}, - {
- "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
]
}, - {
- "fees": [
- {
- "amount": 500,
- "name": "Miscellaneous fee."
}
]
}, - {
- "discounts": [
- {
- "value": 0,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}
]
}, - {
- "fulfilled_quantity": 2
}
], - "fees": [
- {
- "id": "123456789",
- "line_text": "Custom Fee — Added by Plugin",
- "fee_type": "fixed",
- "value": 10,
- "source": "PLUGIN",
- "plugin_uuid": "a52589f8-09df-11ed-b30e-f67072e164ee",
- "taxable": true,
- "show_description": true
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,
- "text": "Cutting board discount",
- "code": "CHOPCHOP",
- "source": "cart"
}, - {
- "value": 0,
- "text": "FREESHIPPING",
- "code": "FREESHIPPING",
- "source": "coupon"
}
], - "payments": [
- {
- "gateway_public_id": "i7z2xT0sKrDvhGWzex5SLjf5e6ndlQfrRL4AROkfhf3vNBkVT38JKBy5PSjB63qW",
- "amount": 4700,
- "currency": "CAD",
- "type": "spreedly",
- "display_string": "Credit Card Payment",
- "id": "",
- "token": "7uZAMRAf80KiEwibsrrM5IB41yU",
- "retain": false,
- "payment_parameters": [ ]
}
], - "order_total": 4700,
- "order_meta_data": {
- "cart_parameters": {
- "key": "cp-key1,",
- "property1": "A cart param.",
- "property2": "A cart param."
}, - "note_attributes": {
- "key": "na-key1",
- "property1": "A note attribute.",
- "property2": "A note attribute."
}, - "notes": "A special delivery note.",
- "tags": [
- "order-1"
]
}, - "shipping": {
- "selected_shipping": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}, - "available_shipping_lines": [
- {
- "id": "string,",
- "line": {
- "id": "0",
- "description": "Custom weight-based rate: tier 2",
- "amount": 450,
- "code": "EXPID"
}
}
], - "taxes": [
- {
- "value": 1000,
- "name": "GST",
- "is_included": true
}
], - "discounts": [
- {
- "value": 0,