Schemas
ExternalOrderResult
idExternal order id in the Vignette ID system.
reference_idOrder id in the Partner system (sent on creation).
external_order_idPartner order id as stored on the Vignette ID side.
statusOrder status. One of CREATED, COMPLETED, FAILED, REFUNDED, CANCELED.
productdescriptionamountOrder amount in major units of currency.
currencyemailsubaccountpayment_providerProvider that processed the payment. null until the order is paid.
allowed_payment_providerscallback_urlsuccess_urlcancel_urlopen_order_details_by_defaultis_sandboxerror_messagecreated_atpaid_atcompleted_atcanceled_atTimestamp when the order was cancelled via Cancel External Order. null for orders that were never cancelled.
payment_linkURL to show to the customer to complete the payment.
Payment attempts recorded for this order.
ExternalOrdersListObject
errortotalTotal number of orders matching the filter.
limitget-product-schema
errorError can be null, a simple string code, or an object with details.
get-product-status-schema
errorError can be null, a simple string code, or an object with details.
get-user-orders-schema
idcustom_idproductuser_idpurchase_datestart_fromstart_dateend_dateperiodtypecountryvehicle_typeVehicle type of the order, e.g. car, van, moto.
statusWhether the order can be modified right now, and until when. Present only on orders bought with Flexible Service; on non-Flex orders reason_code is no_flex.
A refund tier. The full_refund and partial_refund tiers are mutually exclusive — at most one is eligible at a time; if neither, there is no refund. A pending tier still reports its terms (amount_eur, available_at) so you can show "€X now, or €Y after
A refund tier. The full_refund and partial_refund tiers are mutually exclusive — at most one is eligible at a time; if neither, there is no refund. A pending tier still reports its terms (amount_eur, available_at) so you can show "€X now, or €Y after
Flexible Service configuration recorded on the order. Present only when the order was bought with Flex.
receiptsubaccountResponseValidatePlateObject
Error can be null, a simple string code, or an object with details.
error-401-schema
typetitlestatusdetailinstanceOrderModifyCapability
eligibleCan the order be modified right now?
available_atUnix seconds when the action becomes possible. null means either available now or never — read eligible to tell which.
expires_atUnix seconds of the last instant the action is possible. null when there is no window. Trust this over your own clock arithmetic — it is the authoritative value.
reason_codeThe governing rule, always populated whether eligible or not. E.g. default_flex_window, expanded_flex_window, window_passed, no_flex, already_modified.
OrderRefundCapability
eligibleCan this refund tier be taken right now?
available_atUnix seconds when this tier opens. null means available now or never — read eligible to tell which.
expires_atUnix seconds of the last instant this tier is available. null when there is no window.
amount_eurExact amount that will be credited, in EUR. Render it; never recompute it. null when not applicable.
percentDisplay-only tier label, e.g. 100 or 50. Do not multiply anything by it — use amount_eur. null when not applicable.
reason_codeThe governing rule, always populated. E.g. more_than_6h_before_start, within_6h_of_start, within_1h_of_purchase, full_refund_applies, window_passed, no_flex, already_refunded.
OrderFlex
typeFlex plan on the order.
enabledpriceFlex fee actually charged for this order, in EUR.
original_priceList price of the Flex plan before any discount, in EUR.
is_partner_paidtrue when the partner absorbed the Flex fee instead of charging the customer.
transfer-order-body
target_emailEmail of an existing vignette.id user who will receive the order.
The account is not created automatically - validate the recipient first via GET /public/users/exists.