Welcome to our new Vignette ID Developer Portal documentation!
Partner API (v1.0)

ExternalOrderResult

id
​string

External order id in the Vignette ID system.

reference_id
​string

Order id in the Partner system (sent on creation).

external_order_id
​string | null

Partner order id as stored on the Vignette ID side.

status
​string · enum

Order status. One of CREATED, COMPLETED, FAILED, REFUNDED, CANCELED.

Enum values:
CREATED
COMPLETED
FAILED
REFUNDED
CANCELED
product
​string
description
​string | null
amount
​number

Order amount in major units of currency.

currency
​string
email
​string · email
subaccount
​string | null
payment_provider
​string | null

Provider that processed the payment. null until the order is paid.

allowed_payment_providers
​string[]
callback_url
​string | null · uri
success_url
​string | null · uri
cancel_url
​string | null · uri
open_order_details_by_default
​boolean
is_sandbox
​boolean
error_message
​string | null
created_at
​string · date-time
paid_at
​string | null · date-time
completed_at
​string | null · date-time
canceled_at
​string | null · date-time

Timestamp when the order was cancelled via Cancel External Order. null for orders that were never cancelled.

payment_link
​string · uri

URL to show to the customer to complete the payment.

​object[]

Payment attempts recorded for this order.

ExternalOrderObject

error
​object | null
​ExternalOrderResult

ExternalOrdersListObject

error
​object | null
​object
total
​integer

Total number of orders matching the filter.

limit
​integer
​ExternalOrderResult[]

get-product-schema

error
​object | string | null

Error can be null, a simple string code, or an object with details.

​object

get-product-status-schema

error
​object | string | null

Error can be null, a simple string code, or an object with details.

​object[]

get-all-user-schema

id
​string
email
​string
created_date
​number

get-user-orders-schema

id
​string
custom_id
​string
product
​string
user_id
​string
​object[]
purchase_date
​integer
start_from
​integer
start_date
​integer
end_date
​integer
period
​string
type
​string
country
​string
vehicle_type
​string

Vehicle type of the order, e.g. car, van, moto.

status
​string
​OrderModifyCapability

Whether 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.

​OrderRefundCapability

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 ".

​OrderRefundCapability

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 ".

​OrderFlex

Flexible Service configuration recorded on the order. Present only when the order was bought with Flex.

receipt
​string · uri
subaccount
​string

OrderResult

id
​string
custom_id
​string
currency
​string
profit
​number

ResponseOrderObject

​

Error can be null, a simple string code, or an object with details.

​object

ResponseValidatePlateObject

​

Error can be null, a simple string code, or an object with details.

​object

OrderObject

​

Error can be null, a simple string code, or an object with details.

​object

AllOrdersObject

id
​string
email
​string
created_date
​number

success-cancel-order-schema

error
​object | string | null
​object

error-400-schema

​object

error-401-schema

type
​string
title
​string
status
​integer
detail
​string
instance
​string
​object

error-429-schema

​object

error-500-schema

​object
​object

user-exists-schema

error
​object | string | null
​object

success-transfer-order-schema

error
​object | string | null
​object

OrderModifyCapability

Whether the order can be modified right now, and until when. Present only on orders bought with [Flexible Service](/wiki/flexible-service); on non-Flex orders `reason_code` is `no_flex`.
eligible
​boolean

Can the order be modified right now?

available_at
​integer | null

Unix seconds when the action becomes possible. null means either available now or never — read eligible to tell which.

expires_at
​integer | null

Unix 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_code
​string

The governing rule, always populated whether eligible or not. E.g. default_flex_window, expanded_flex_window, window_passed, no_flex, already_modified.

OrderRefundCapability

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 <date>".
eligible
​boolean

Can this refund tier be taken right now?

available_at
​integer | null

Unix seconds when this tier opens. null means available now or never — read eligible to tell which.

expires_at
​integer | null

Unix seconds of the last instant this tier is available. null when there is no window.

amount_eur
​number | null

Exact amount that will be credited, in EUR. Render it; never recompute it. null when not applicable.

percent
​integer | null

Display-only tier label, e.g. 100 or 50. Do not multiply anything by it — use amount_eur. null when not applicable.

reason_code
​string

The 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

Flexible Service configuration recorded on the order. Present only when the order was bought with Flex.
type
​string · enum

Flex plan on the order.

Enum values:
default
expanded
enabled
​boolean
price
​number

Flex fee actually charged for this order, in EUR.

original_price
​number

List price of the Flex plan before any discount, in EUR.

is_partner_paid
​boolean

true when the partner absorbed the Flex fee instead of charging the customer.

error-404-schema

​object

error-409-schema

​object

transfer-order-body

Transfer an order (vignette) to a different customer's account. The target email must belong to an existing vignette.id user - check it first with the /public/users/exists endpoint.
target_email
​string · email · required

Email 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.