Skip to main content
PATCH
cURL
Slash Payment Processing is in beta and not enabled for all accounts. Contact support@joinslash.com to get access.
Update an open checkout session before the buyer starts paying. The session keeps its id and hosted url, so a buyer who already has the checkout open picks up the new amount in place. Send only the fields you want to change. At least one field is required.
Only open sessions can be updated. Updating a complete or expired session is rejected, and a session whose payment is already in flight returns 409 — at that point the buyer is mid-payment and the amount must not move under them.

Authorizations

X-API-Key
string
header
required

API key authentication for public API requests.

Keys come in two flavors:

  • Legal-entity-scoped keys are pinned to a single legal entity. Minted via the dashboard under a specific entity; every request acts on that entity.
  • User-scoped keys are pinned to a user and span every legal entity that user has access to. Every request made with a user-scoped key (except GET /legal-entity, which lists the legal entities the user can access) must include an x-legal-entity header naming the legal entity the request is operating on. Requests without the header are rejected with 400. The authenticated user must have an active permission role on the supplied legal entity, otherwise the request is rejected with 403.

Path Parameters

checkoutSessionId
string
required

Body

application/json
amount
integer

Payment amount in cents. Must be strictly positive.

Required range: x >= 1
expiresAt
string<date-time>

ISO-8601 timestamp after which the session can no longer be paid. Must be at least 30 minutes and at most 7 days in the future.

Response

OK

checkoutSession
CheckoutSession · object
required

A checkout session represents a single hosted payment attempt. Embed the session's url in your page (via the Slash checkout SDK or an iframe) to collect a card payment.