Tillwire Read the guide
API reference

Store. 5 operations.

5 of them work. Each needs a bearer token with its scope. All operations.

Operations

GET/api/v1/store/backup-statusstore.backup-statusstore.read

Errors: 401, 403, 405, 422, 429

curl -X GET -H "Authorization: Bearer $TOKEN" https://yourshop.example/api/v1/store/backup-status

POST/api/v1/store/settingsstore.save-settingsstore.write

Parameters

Idempotency-KeyheaderstringSee common parameters

Errors: 401, 403, 405, 409, 413, 422, 429

curl -X POST -H "Authorization: Bearer $TOKEN" https://yourshop.example/api/v1/store/settings

GET/api/v1/store/settingsstore.settingsstore.read

Errors: 401, 403, 405, 422, 429

curl -X GET -H "Authorization: Bearer $TOKEN" https://yourshop.example/api/v1/store/settings

Schemas 23

BackupStatus

BackupStatus is the store's backup as engine health measures it: the Litestream replica of the database and the documents copied to the backup bucket, each with a state word. From contract version 6.

documentsrequiredDocumentsStatus
listed_atrequiredstring (date-time)
replicarequiredReplicaStatus
CancelReason

CancelReason is a reason a cancel is picked from: the text the buyer is shown, and, for one of the engine's five, its code; "" for a reason the owner wrote.

codestring
textrequiredstring
DispatchSettings

DispatchSettings are when the store sends an order out: its lead time in dispatch days, from 0 to 30; the weekdays it dispatches on, at least one, each of mon, tue, wed, thu, fri, sat and sun, which an answer gives Monday first; and the time of day, HH:MM in the store's zone, from which an order counts from the next day, "" for none.

cutoffrequiredstring
daysrequiredarray of string
lead_daysrequiredinteger
DocumentsStatus

DocumentsStatus is the documents copied to the backup bucket. Pending is how many are recorded in no replica, of any age, and OldestSeconds the age of the oldest, 0 for none; the state is behind once one has waited longer than GraceSeconds.

grace_secondsrequiredinteger
namerequiredstring
oldest_secondsrequiredinteger
pendingrequiredinteger
staterequiredstring
Money

Money is an amount: in minor units of its ISO 4217 currency, and as the store displays it.

currencyrequiredstring
displayrequiredstring
minorrequiredinteger
PostalAddress

PostalAddress is an address in its fields, as the store's details take and give it. From contract version 6.

cityrequiredstring
countryrequiredstring
country_namestring
line1requiredstring
line2requiredstring
postal_coderequiredstring
provincerequiredstring
suburbrequiredstring
textstring
ReplicaStatus

ReplicaStatus is the database's replica. Name is the location as store.yaml writes it, no key. Heartbeat is the newest heartbeat engine health wrote, null before the first; LagSeconds is how long it has gone uncopied, 0 while the replica holds it, over LimitSeconds (health. replica_lag_max_seconds) the state is behind. SnapshotAt is the newest snapshot's time and RestorableFrom the oldest one's, how far back a restore reaches; each null when the replica lists no snapshot, which means not known, not none.

heartbeatrequiredstring (date-time)
lag_secondsrequiredinteger
limit_secondsrequiredinteger
namerequiredstring
restorable_fromrequiredstring (date-time)
snapshot_atrequiredstring (date-time)
staterequiredstring
StoreAddressLookup

StoreAddressLookup is the address lookup the checkout offers as the buyer types the street: whether it is on, its provider, the provider's calls a day at most, and one client's share of them, a percentage. The key is no setting: it stays a secret declared in store.yaml and set in the environment, which /admin and the API never take; KeyPlaced says whether it is there, never the key or its name. A save sends StoreAddressLookupRequest. From version 6.

client_sharerequiredinteger
daily_limitrequiredinteger
enabledrequiredboolean
key_placedrequiredboolean
limit_hitrequiredboolean
providerrequiredstring
used_todayrequiredinteger
StoreAddressLookupRequest

StoreAddressLookupRequest are the address lookup's settings a save sends, each kept as saved when left out: Enabled, DailyLimit or ClientShare null or absent, and a Provider of "". A number given is checked against StoreAddressLookup's bounds, 0 too: 0 is refused, never read as "keep" (L1, Verification's walk). From version 6.

client_shareinteger
daily_limitinteger
enabledboolean
providerstring
StoreBank

StoreBank are the store's bank details: the account an EFT term is paid into, public on the store's documents. The holder, bank, account number, branch code and account type are given together or not at all. AccountNumber is 5 to 16 digits and BranchCode 4 to 8, spaces and hyphens taken out when saved; AccountType is current, savings, transmission or other; SWIFT, optional, is 8 or 11 letters and digits; ReferenceRule is what the payer writes as the payment reference, order_number (the default) or document_number; Notes are at most 3 lines of at most 100 characters. Additive.

account_holderrequiredstring
account_numberrequiredstring
account_typerequiredstring
bank_namerequiredstring
branch_coderequiredstring
notesrequiredarray of string
reference_rulestring
swiftstring
StoreCashOnDelivery

StoreCashOnDelivery are the cash on delivery settings of the store: the most an order may total and be offered the method (a zero amount is no limit), the days a cash on delivery order may wait before it is on the attention list (1 to 90, default 14), and when the tax invoice of such an order is made: collected, with the cash (the default), or dispatched. The method is on or off as a payment gateway is. A save sends StoreCashOnDeliveryRequest. From version 6. The fee of the method (additive): a fixed amount, a percent of the order's total before the fee in basis points, the most the whole fee may be (a zero amount is none of each), the tax class of the fee line ("" follows the shipping line's) and whether an order's refund keeps the fee.

fee_caprequiredMoney
fee_fixedrequiredMoney
fee_percentrequiredinteger
fee_tax_classrequiredstring
hold_daysrequiredinteger
invoice_atrequiredstring
keep_fee_on_refundrequiredboolean
max_orderrequiredMoney
StoreCashOnDeliveryRequest

StoreCashOnDeliveryRequest are the cash on delivery settings a save sends, each kept as saved when left out. MaxOrder is the most an order may total and be offered cash on delivery, written as a price with two decimals such as 500.00; 0.00 is no limit. HoldDays is 1 to 90. InvoiceAt is collected or dispatched. From version 6. The fee (additive): FeeFixed and FeeCap are prices with two decimals, FeePercent is basis points of the order's total before the fee (0 to 10 000), all 0 for none; FeeTaxClass names the tax class of the fee line, "" for the shipping line's; KeepFeeOnRefund keeps the fee when the order is refunded. Each is kept as saved when left out (null), and one given is checked, 0 too.

fee_capstring
fee_fixedstring
fee_percentinteger
fee_tax_classstring
hold_daysinteger
invoice_atstring
keep_fee_on_refundboolean
max_orderstring
StoreCollectionPlace

StoreCollectionPlace is one of the store's own places where a buyer collects the order: its key, its name, its address, its opening hours in the store's own words ("" for none) and what collecting costs, as the store writes a price, such as 0.00 for free.

addressrequiredPostalAddress
hoursrequiredstring
keyrequiredstring
namerequiredstring
pricerequiredstring
StoreEFT

StoreEFT are the days of the checkout's bank transfer: RemindAfterDays, the payment reminder's day after the order waits, 0 for none; CancelAfterDays, the system's cancel of an order still unpaid, 0 for the store's general rule.

cancel_after_daysrequiredinteger
remind_after_daysrequiredinteger
StoreEFTRequest

StoreEFTRequest are the EFT days a save sends: a field left out keeps the store's.

cancel_after_daysinteger
remind_after_daysinteger
StoreEnquiries

StoreEnquiries are the store's enquiry settings (ASI-6.5), from store.yaml, read only in this version.

copy_customerrequiredboolean
mailrequiredboolean
mail_torequiredstring
StoreManualOrders

StoreManualOrders are the payment terms and the settings of the orders the owner enters and the quotes they come from. Terms are 1 to 20 (none given: the one pay_now term, "now"); CreditCheck is warn (an order over a customer's credit limit is accepted with a warning) or refuse, warn by default; QuoteValidDays is 1 to 365, 14 by default; QuoteReserve is none (the default) or until_valid; QuoteWarnDays is 0 to 60, 3 by default, the days before a quote ends that the owner is warned; QuoteRemindDays is 0 to 60, the days after a quote is sent that its client is reminded, 0 for never; QuoteFooter is the text at the foot of a quote. Additive.

credit_checkrequiredstring
quote_footerrequiredstring
quote_remind_daysrequiredinteger
quote_reserverequiredstring
quote_valid_daysrequiredinteger
quote_warn_daysrequiredinteger
termsrequiredarray of StorePaymentTerm
StorePaymentTerm

StorePaymentTerm is one of the store's payment terms: an id (lower-case letters, digits, - and _), the label the client sees, and a Kind: pay_now (the client pays by the order's link; PayWindowDays is how many days it waits, 7 by default), eft (the client pays by bank transfer against a pro forma invoice; EFTHoldDays is how many days it waits before the attention list, 14 by default) or account (the client is invoiced and pays DueDays after the invoice, 0 on receipt; InvoiceAt is accepted or dispatched, the default). The parts of another kind are refused. Additive.

due_daysinteger
eft_hold_daysinteger
idrequiredstring
invoice_atstring
kindrequiredstring
labelrequiredstring
pay_window_daysinteger
StorePolicies

StorePolicies are the URLs of the store's policies, each an http or https address, "" for none.

adrrequiredstring
privacyrequiredstring
returnsrequiredstring
securityrequiredstring
termsrequiredstring
StoreSettings

StoreSettings are the store's details as they rule: saved, or store.yaml's as the first save copies them, with the revision a save must send; the store's logo; and, read only, what stays store.yaml's. From contract version 6.

addressrequiredPostalAddress
address_lookuprequiredStoreAddressLookup
bankrequiredStoreBank
base_urlrequiredstring
cancel_reasonsrequiredarray of CancelReason
cancel_reasons_defaultrequiredboolean
cash_on_deliveryrequiredStoreCashOnDelivery
collectionrequiredarray of StoreCollectionPlace
currencyrequiredstring
dispatchrequiredDispatchSettings
eftrequiredStoreEFT
emailrequiredstring
enquiriesrequiredStoreEnquiries
languagerequiredstring
logorequiredstring
mail_test_addressesrequiredarray of string
manual_ordersrequiredStoreManualOrders
namerequiredstring
next_dispatchrequiredstring
phonerequiredstring
policiesrequiredStorePolicies
requiredrequiredarray of string
revisionrequiredinteger
savedrequiredboolean
saved_atrequiredstring (date-time)
saved_byrequiredstring
supplierrequiredStoreSupplier
timezonerequiredstring
vatrequiredStoreVAT
StoreSettingsRequest

StoreSettingsRequest is the store's details whole, which replace the details at Revision: a detail left out is "" or none, never kept. From contract version 6.

addressrequiredPostalAddress
address_lookuprequiredStoreAddressLookupRequest
bankrequiredStoreBank
cancel_reasonsrequiredarray of CancelReason
cash_on_deliveryrequiredStoreCashOnDeliveryRequest
collectionrequiredarray of StoreCollectionPlace
dispatchrequiredDispatchSettings
eftrequiredStoreEFTRequest
emailrequiredstring
mail_test_addressesrequiredarray of string
manual_ordersrequiredStoreManualOrders
namerequiredstring
phonerequiredstring
policiesrequiredStorePolicies
revisionrequiredinteger
supplierrequiredStoreSupplier
vatrequiredStoreVAT
StoreSupplier

StoreSupplier is who sells: its legal name, status, registration number and office bearers, its physical address, which every tax invoice carries, and where it accepts legal service of documents.

legal_addressrequiredPostalAddress
legal_namerequiredstring
legal_statusrequiredstring
officersrequiredarray of string
registration_numberrequiredstring
service_addressrequiredPostalAddress
StoreVAT

StoreVAT is the store's VAT registration: whether it is registered, its rate in basis points (1500 is 15 %), its VAT number, "" for a store not registered, and its VAT period in months, 0 for the default, 2.

numberrequiredstring
period_monthsrequiredinteger
raterequiredinteger
registeredrequiredboolean

Made from engine/internal/openapi/openapi.json at commit 6c4cbd921. The contract-only operations come from the engine’s stub file, engine/internal/ops.