Submit Checkout
/checkout_instances/{id}/submitAuthorization
bearerAuth In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/checkout_instances/string/submit" \ -H "Content-Type: application/json" \ -d '{ "steps": [ { "step_key": "3bbcd332-c5a4-47ab-9f48-175e4a2a16bc" } ], "buyer": { "email": "user@example.com" }, "consents": { "terms": true, "privacy": true }, "charge_terms": true }'{ "data": { "id": "string", "status": "open", "pending": true, "warnings": [ { "step_key": "3bbcd332-c5a4-47ab-9f48-175e4a2a16bc", "bundle_product": "59b32e26-60dc-43bb-a3b2-7dea0a0932c1", "component_product": "693207fd-733d-4931-b8bd-084286f74193", "message": "string" } ], "preparation_error": "payment_setup_failed", "client_secret": "string", "stripe_account": "string" }, "request_id": "266ea41d-adf5-480b-af50-15b940c2b846"}Start a card update for one subscription (customer billing session) POST
Customer sessions with the update_payment_method flow only. Creates a processor card-entry Session for this subscription; nothing is charged. A 409 setup_attempt_superseded means a newer attempt exists; its details name the newest attempt and whether this sheet made it.
Switch a live subscription product POST
Replaces the selected product line and its components. Quantities carry unless specified. Requires a merchant person or key. Unsupported subscription notice shapes return 422 notice_unsupported_shape before processor preview. Changes to switch inputs during preview are revalidated under the subscription lock. Proration defaults to bill_now. With downgrade_timing=renewal, cheaper same-interval changes and longer-to-shorter interval changes take effect at the end of the paid period. Fixed-day cross-interval switches are deferred to HERM-60 PR 4.