eBay Order API — Guest_checkout_session
eBay Order API — Guest_checkout_session. 7 operations. Lead operation: Guest_checkout_session. Self-contained Naftiko capability covering one Ebay business surface.
What You Can Do
MCP Tools
span-class-tablenote-b-note-b-order-api
Note: The Order API (v2) currently only supports the guest payment/checkout flow. If you need to support member payment/checkout flow, use the v1_beta version
span-class-tablenote-b-note-b-order-api-2
Note: The Order API (v2) currently only supports the guest payment/checkout flow. If you need to support member payment/checkout flow, use the v1_beta version
span-class-tablenote-b-note-b-order-api-3
Note: The Order API (v2) currently only supports the guest payment/checkout flow. If you need to support member payment/checkout flow, use the v1_beta version
span-class-tablenote-b-note-b-order-api-4
Note: The Order API (v2) currently only supports the guest payment/checkout flow. If you need to support member payment/checkout flow, use the v1_beta version
span-class-tablenote-b-note-b-order-api-5
Note: The Order API (v2) currently only supports the guest payment/checkout flow. If you need to support member payment/checkout flow, use the v1_beta version
span-class-tablenote-b-note-b-order-api-6
Note: The Order API (v2) currently only supports the guest payment/checkout flow. If you need to support member payment/checkout flow, use the v1_beta version
span-class-tablenote-b-note-b-order-api-7
Note: The Order API (v2) currently only supports the guest payment/checkout flow. If you need to support member payment/checkout flow, use the v1_beta version
Capability Spec
naftiko: 1.0.0-alpha2
info:
label: eBay Order API — Guest_checkout_session
description: 'eBay Order API — Guest_checkout_session. 7 operations. Lead operation: Guest_checkout_session. Self-contained
Naftiko capability covering one Ebay business surface.'
tags:
- Ebay
- Guest_checkout_session
created: '2026-05-19'
modified: '2026-05-19'
binds:
- namespace: env
keys:
EBAY_API_KEY: EBAY_API_KEY
capability:
consumes:
- type: http
namespace: order-guest-checkout-session
baseUri: https://apix.ebay.com{basePath}
description: eBay Order API — Guest_checkout_session business capability. Self-contained, no shared references.
resources:
- name: guest_checkout_session-initiate
path: /guest_checkout_session/initiate
operations:
- name: initiateguestcheckoutsession
method: POST
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: X-EBAY-C-ENDUSERCTX
in: header
type: string
description: This header is used to specify the <b>deviceId</b> for the device/user attempting to make the call.<br><br>It
contains an alphanumeric string that allows a paym
- name: X-EBAY-C-MARKETPLACE-ID
in: header
type: string
description: This header identifies the eBay marketplace where the order will occur.<br><br>See <a href="/api-docs/static/rest-request-components.html#marketpl
" target="_bl
required: true
- name: Content-Type
in: header
type: string
description: 'This header indicates the format of the request body provided by the client. Its value should be set
to <b>application/json</b>. <br><br> For more information, '
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: guest_checkout_session-checkoutSessionId
path: /guest_checkout_session/{checkoutSessionId}
operations:
- name: getguestcheckoutsession
method: GET
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: checkoutSessionId
in: path
type: string
description: This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace.<br><br>This
value is returned by the <a href="/api-do
required: true
- name: X-EBAY-C-MARKETPLACE-ID
in: header
type: string
description: This header identifies the eBay marketplace where the order will occur. <br><br><span class="tablenote"><b>Note:</b> For
this method, this value must match the
required: true
- name: X-EBAY-C-ENDUSERCTX
in: header
type: string
description: This header is used to specify the <b>deviceId</b> for the device/user attempting to make the call.<br><br>It
contains an alphanumeric string that allows a paym
- name: guest_checkout_session-checkoutSessionId-apply_coupon
path: /guest_checkout_session/{checkoutSessionId}/apply_coupon
operations:
- name: applyguestcoupon
method: POST
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: checkoutSessionId
in: path
type: string
description: This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace.<br><br>This
value is returned by the <a href="/api-do
required: true
- name: X-EBAY-C-MARKETPLACE-ID
in: header
type: string
description: This header identifies the eBay marketplace where the order will occur. <br><br><span class="tablenote"><b>Note:</b> For
this method, this value must match the
required: true
- name: Content-Type
in: header
type: string
description: 'This header indicates the format of the request body provided by the client. Its value should be set
to <b>application/json</b>. <br><br> For more information, '
required: true
- name: X-EBAY-C-ENDUSERCTX
in: header
type: string
description: This header is used to specify the <b>deviceId</b> for the device/user attempting to make the call.<br><br>It
contains an alphanumeric string that allows a paym
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: guest_checkout_session-checkoutSessionId-remove_coupon
path: /guest_checkout_session/{checkoutSessionId}/remove_coupon
operations:
- name: removeguestcoupon
method: POST
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: checkoutSessionId
in: path
type: string
description: This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace.<br><br>This
value is returned by the <a href="/api-do
required: true
- name: X-EBAY-C-MARKETPLACE-ID
in: header
type: string
description: This header identifies the eBay marketplace where the order will occur. <br><br><span class="tablenote"><b>Note:</b> For
this method, this value must match the
required: true
- name: Content-Type
in: header
type: string
description: 'This header indicates the format of the request body provided by the client. Its value should be set
to <b>application/json</b>. <br><br> For more information, '
required: true
- name: X-EBAY-C-ENDUSERCTX
in: header
type: string
description: This header is used to specify the <b>deviceId</b> for the device/user attempting to make the call.<br><br>It
contains an alphanumeric string that allows a paym
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: guest_checkout_session-checkoutSessionId-update_quantity
path: /guest_checkout_session/{checkoutSessionId}/update_quantity
operations:
- name: updateguestquantity
method: POST
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: checkoutSessionId
in: path
type: string
description: This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace.<br><br>This
value is returned by the <a href="/api-do
required: true
- name: X-EBAY-C-MARKETPLACE-ID
in: header
type: string
description: This header identifies the eBay marketplace where the order will occur. <br><br><span class="tablenote"><b>Note:</b> For
this method, this value must match the
required: true
- name: Content-Type
in: header
type: string
description: 'This header indicates the format of the request body provided by the client. Its value should be set
to <b>application/json</b>. <br><br> For more information, '
required: true
- name: X-EBAY-C-ENDUSERCTX
in: header
type: string
description: This header is used to specify the <b>deviceId</b> for the device/user attempting to make the call.<br><br>It
contains an alphanumeric string that allows a paym
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: guest_checkout_session-checkoutSessionId-update_shipping_address
path: /guest_checkout_session/{checkoutSessionId}/update_shipping_address
operations:
- name: updateguestshippingaddress
method: POST
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: checkoutSessionId
in: path
type: string
description: This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace.<br><br>This
value is returned by the <a href="/api-do
required: true
- name: X-EBAY-C-MARKETPLACE-ID
in: header
type: string
description: This header identifies the eBay marketplace where the order will occur. <br><br><span class="tablenote"><b>Note:</b> For
this method, this value must match the
required: true
- name: Content-Type
in: header
type: string
description: 'This header indicates the format of the request body provided by the client. Its value should be set
to <b>application/json</b>. <br><br> For more information, '
required: true
- name: X-EBAY-C-ENDUSERCTX
in: header
type: string
description: This header is used to specify the <b>deviceId</b> for the device/user attempting to make the call.<br><br>It
contains an alphanumeric string that allows a paym
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: guest_checkout_session-checkoutSessionId-update_shipping_option
path: /guest_checkout_session/{checkoutSessionId}/update_shipping_option
operations:
- name: updateguestshippingoption
method: POST
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: checkoutSessionId
in: path
type: string
description: This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace.<br><br>This
value is returned by the <a href="/api-do
required: true
- name: X-EBAY-C-MARKETPLACE-ID
in: header
type: string
description: This header identifies the eBay marketplace where the order will occur. <br><br><span class="tablenote"><b>Note:</b> For
this method, this value must match the
required: true
- name: Content-Type
in: header
type: string
description: 'This header indicates the format of the request body provided by the client. Its value should be set
to <b>application/json</b>. <br><br> For more information, '
required: true
- name: X-EBAY-C-ENDUSERCTX
in: header
type: string
description: This header is used to specify the <b>deviceId</b> for the device/user attempting to make the call.<br><br>It
contains an alphanumeric string that allows a paym
- name: body
in: body
type: object
description: Request body (JSON).
required: false
authentication:
type: bearer
token: '{{env.EBAY_API_KEY}}'
exposes:
- type: rest
namespace: order-guest-checkout-session-rest
port: 8080
description: REST adapter for eBay Order API — Guest_checkout_session. One Spectral-compliant resource per consumed operation,
prefixed with /v1.
resources:
- path: /v1/guest-checkout-session/initiate
name: guest-checkout-session-initiate
description: REST surface for guest_checkout_session-initiate.
operations:
- method: POST
name: initiateguestcheckoutsession
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
call: order-guest-checkout-session.initiateguestcheckoutsession
with:
X-EBAY-C-ENDUSERCTX: rest.X-EBAY-C-ENDUSERCTX
X-EBAY-C-MARKETPLACE-ID: rest.X-EBAY-C-MARKETPLACE-ID
Content-Type: rest.Content-Type
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/guest-checkout-session/{checkoutsessionid}
name: guest-checkout-session-checkoutsessionid
description: REST surface for guest_checkout_session-checkoutSessionId.
operations:
- method: GET
name: getguestcheckoutsession
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
call: order-guest-checkout-session.getguestcheckoutsession
with:
checkoutSessionId: rest.checkoutSessionId
X-EBAY-C-MARKETPLACE-ID: rest.X-EBAY-C-MARKETPLACE-ID
X-EBAY-C-ENDUSERCTX: rest.X-EBAY-C-ENDUSERCTX
outputParameters:
- type: object
mapping: $.
- path: /v1/guest-checkout-session/{checkoutsessionid}/apply-coupon
name: guest-checkout-session-checkoutsessionid-apply-coupon
description: REST surface for guest_checkout_session-checkoutSessionId-apply_coupon.
operations:
- method: POST
name: applyguestcoupon
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
call: order-guest-checkout-session.applyguestcoupon
with:
checkoutSessionId: rest.checkoutSessionId
X-EBAY-C-MARKETPLACE-ID: rest.X-EBAY-C-MARKETPLACE-ID
Content-Type: rest.Content-Type
X-EBAY-C-ENDUSERCTX: rest.X-EBAY-C-ENDUSERCTX
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/guest-checkout-session/{checkoutsessionid}/remove-coupon
name: guest-checkout-session-checkoutsessionid-remove-coupon
description: REST surface for guest_checkout_session-checkoutSessionId-remove_coupon.
operations:
- method: POST
name: removeguestcoupon
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
call: order-guest-checkout-session.removeguestcoupon
with:
checkoutSessionId: rest.checkoutSessionId
X-EBAY-C-MARKETPLACE-ID: rest.X-EBAY-C-MARKETPLACE-ID
Content-Type: rest.Content-Type
X-EBAY-C-ENDUSERCTX: rest.X-EBAY-C-ENDUSERCTX
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/guest-checkout-session/{checkoutsessionid}/update-quantity
name: guest-checkout-session-checkoutsessionid-update-quantity
description: REST surface for guest_checkout_session-checkoutSessionId-update_quantity.
operations:
- method: POST
name: updateguestquantity
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
call: order-guest-checkout-session.updateguestquantity
with:
checkoutSessionId: rest.checkoutSessionId
X-EBAY-C-MARKETPLACE-ID: rest.X-EBAY-C-MARKETPLACE-ID
Content-Type: rest.Content-Type
X-EBAY-C-ENDUSERCTX: rest.X-EBAY-C-ENDUSERCTX
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/guest-checkout-session/{checkoutsessionid}/update-shipping-address
name: guest-checkout-session-checkoutsessionid-update-shipping-address
description: REST surface for guest_checkout_session-checkoutSessionId-update_shipping_address.
operations:
- method: POST
name: updateguestshippingaddress
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
call: order-guest-checkout-session.updateguestshippingaddress
with:
checkoutSessionId: rest.checkoutSessionId
X-EBAY-C-MARKETPLACE-ID: rest.X-EBAY-C-MARKETPLACE-ID
Content-Type: rest.Content-Type
X-EBAY-C-ENDUSERCTX: rest.X-EBAY-C-ENDUSERCTX
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/guest-checkout-session/{checkoutsessionid}/update-shipping-option
name: guest-checkout-session-checkoutsessionid-update-shipping-option
description: REST surface for guest_checkout_session-checkoutSessionId-update_shipping_option.
operations:
- method: POST
name: updateguestshippingoption
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
call: order-guest-checkout-session.updateguestshippingoption
with:
checkoutSessionId: rest.checkoutSessionId
X-EBAY-C-MARKETPLACE-ID: rest.X-EBAY-C-MARKETPLACE-ID
Content-Type: rest.Content-Type
X-EBAY-C-ENDUSERCTX: rest.X-EBAY-C-ENDUSERCTX
body: rest.body
outputParameters:
- type: object
mapping: $.
- type: mcp
namespace: order-guest-checkout-session-mcp
port: 9090
transport: http
description: MCP adapter for eBay Order API — Guest_checkout_session. One tool per consumed operation, routed inline through
this capability's consumes block.
tools:
- name: span-class-tablenote-b-note-b-order-api
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
hints:
readOnly: false
destructive: false
idempotent: false
call: order-guest-checkout-session.initiateguestcheckoutsession
with:
X-EBAY-C-ENDUSERCTX: tools.X-EBAY-C-ENDUSERCTX
X-EBAY-C-MARKETPLACE-ID: tools.X-EBAY-C-MARKETPLACE-ID
Content-Type: tools.Content-Type
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: span-class-tablenote-b-note-b-order-api-2
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
hints:
readOnly: true
destructive: false
idempotent: true
call: order-guest-checkout-session.getguestcheckoutsession
with:
checkoutSessionId: tools.checkoutSessionId
X-EBAY-C-MARKETPLACE-ID: tools.X-EBAY-C-MARKETPLACE-ID
X-EBAY-C-ENDUSERCTX: tools.X-EBAY-C-ENDUSERCTX
outputParameters:
- type: object
mapping: $.
- name: span-class-tablenote-b-note-b-order-api-3
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
hints:
readOnly: false
destructive: false
idempotent: false
call: order-guest-checkout-session.applyguestcoupon
with:
checkoutSessionId: tools.checkoutSessionId
X-EBAY-C-MARKETPLACE-ID: tools.X-EBAY-C-MARKETPLACE-ID
Content-Type: tools.Content-Type
X-EBAY-C-ENDUSERCTX: tools.X-EBAY-C-ENDUSERCTX
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: span-class-tablenote-b-note-b-order-api-4
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
hints:
readOnly: false
destructive: false
idempotent: false
call: order-guest-checkout-session.removeguestcoupon
with:
checkoutSessionId: tools.checkoutSessionId
X-EBAY-C-MARKETPLACE-ID: tools.X-EBAY-C-MARKETPLACE-ID
Content-Type: tools.Content-Type
X-EBAY-C-ENDUSERCTX: tools.X-EBAY-C-ENDUSERCTX
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: span-class-tablenote-b-note-b-order-api-5
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
hints:
readOnly: false
destructive: false
idempotent: false
call: order-guest-checkout-session.updateguestquantity
with:
checkoutSessionId: tools.checkoutSessionId
X-EBAY-C-MARKETPLACE-ID: tools.X-EBAY-C-MARKETPLACE-ID
Content-Type: tools.Content-Type
X-EBAY-C-ENDUSERCTX: tools.X-EBAY-C-ENDUSERCTX
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: span-class-tablenote-b-note-b-order-api-6
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
hints:
readOnly: false
destructive: false
idempotent: false
call: order-guest-checkout-session.updateguestshippingaddress
with:
checkoutSessionId: tools.checkoutSessionId
X-EBAY-C-MARKETPLACE-ID: tools.X-EBAY-C-MARKETPLACE-ID
Content-Type: tools.Content-Type
X-EBAY-C-ENDUSERCTX: tools.X-EBAY-C-ENDUSERCTX
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: span-class-tablenote-b-note-b-order-api-7
description: <span class="tablenote"><b>Note:</b> The Order API (v2) currently only supports the guest payment/checkout
flow. If you need to support member payment/checkout flow, use the <a href="/api-docs/buy/order_v1/resources/methods">v1_beta
version
hints:
readOnly: false
destructive: false
idempotent: false
call: order-guest-checkout-session.updateguestshippingoption
with:
checkoutSessionId: tools.checkoutSessionId
X-EBAY-C-MARKETPLACE-ID: tools.X-EBAY-C-MARKETPLACE-ID
Content-Type: tools.Content-Type
X-EBAY-C-ENDUSERCTX: tools.X-EBAY-C-ENDUSERCTX
body: tools.body
outputParameters:
- type: object
mapping: $.