latestOpenAPI 3.1.02026-08-141866831.1 MB

77e4ef94fcc3

orders

public

Finalize Order

Finalize a draft order and synchronously attempt an off-session charge.

On success, the order transitions to paid and benefit grants fire before the response returns. On failure (decline, missing payment method, SCA challenge), the order stays in draft and a 4xx error is returned.

The request fails with 412 if the order is not in draft status.

Scopes: orders:write

post/v1/orders/{id}/finalize

Path parameters

idstring uuid4 required

The order ID.

Request body

payment_method_idstring uuid4 nullable

ID of the payment method to charge. Must belong to the order's customer. Falls back to the customer's default payment method when unset.

Response

Successful Response

Order required— unresolved $ref