Shopping

Submit Order

Submit only an order already approved by the buyer in the confirmation page. Requires the returned token and a stable unique idempotency_key; retry the same key after uncertainty. Never bypass confirmation. OAuth scopes: order:submit. Changes buyer or order state. Requires a JSON object body; use {} for an operation without body fields.

post/orders/submit

Request

  • Base URL: https://vesremont.com/api/v1
  • URL: https://vesremont.com/api/v1/orders/submit
  • Auth: OAuth 2 (authorization code, authorization URL https://vesremont.com/oauth/authorize, token URL https://vesremont.com/oauth/token, scopes: order:submit)

Headers

Idempotency-Keystring required

Unique key for ONE approved submission. Keep this key and the same body for retries after uncertainty; never generate a new key to retry that order. REST sends it as Idempotency-Key.

Keep this key and the exact body for retries. A changed body with the same key conflicts. Never retry an uncertain submission with a new key.

Request body

confirmation_tokenstring required

Token returned by prepare_order for the exact summary the buyer personally approved on the confirmation page. It cannot replace that approval.

Response

Successful operation.

order_idinteger required
submission_status'submitted' required
statusstring required

Actual Bitrix status code; submitted is not store confirmation.

cancelledboolean required
payment_status'paid' | 'partially_paid' | 'unpaid' required
created_atstring date-time nullable required
updated_atstring date-time nullable required
status_historyunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.