v14

latestOpenAPI 3.1.02026-08-03122113375.9 KB
basket

Create checkout session

Creates a checkout session and returns the URL the client should redirect the user to.

Use this as the final "continue to payment" step from basket/checkout pages.

What this endpoint checks before creating a session:

  • listing availability and purchasability
  • seller authorization constraints
  • basket consistency at checkout time

Response behavior:

  • On success: returns a checkout URL.
  • On failure: returns listing-level validation errors for unavailable/invalid items.

Heads up:

  • Requires authentication.
post/basket/{id}/checkout

Path parameters

idstring required

The ID of the basket to retrieve

The ID of the basket to retrieve

Request body

successUrlstring uri required

The URL to redirect to after a successful payment. A ?purchase= query parameter will be appended to this URL containing the ID of the resulting purchase.

Response

The response containing the checkout URL

urlstring uri required

The URL to redirect the user to for checkout