Confirm and return from a successful checkout
GET/checkouts/:checkout_id/return
Provider-neutral browser return bridge used as the provider success URL. Access is authorized by a short-lived signed token scoped to this Checkout. The service waits for a bounded period for the authoritative provider webhook projection. A subscription Checkout is confirmed only after it is completed and has a local Subscription result; a one-time Checkout is confirmed when completed. The browser is then redirected to the allowlisted application return URL with billing_checkout_id and billing_checkout_result. The result is success when the local result is readable, or processing when projection has not converged within the bounded wait. This endpoint never projects provider state itself.
Request
Responses
- 302
- 403
- 404
- 429
Redirect to the allowlisted application return URL
Response Headers
Forbidden (realm/account mismatch, billing account not derived from your session/principal, or insufficient role)
Not Found
Rate limited
Response Headers
Seconds to wait before retry.