Every Seller API key carries a list of scopes. Each operation accepts a key that holds any
one of the scopes listed for it; the first one listed is the preferred scope, the one to put
on a new key. This page is the single answer to "which scope do I need": the two tables at the end
are generated from the API reference (x-avrix-scopes on each operation), and a gate keeps the API
reference equal to what the API accepts.
Authoritative sellable list: GET /allocations (sellable: true) — not /products or /catalog/snapshot alone.
Choosing scopes for a new key#
Request the preferred scope for each job your service does, and nothing else: least privilege per key.
| Job | Preferred scope |
|---|---|
| Read the catalog, prices, availability and allocations | seller:products:read |
| Read orders and key pull history | seller:orders:read |
| Place, hold, reserve, commit, cancel and recover orders; pull keys | seller:orders:write (includes order reads and preview) |
| Price a cart without placing it | seller:orders:preview |
| Reveal keys for a ready preorder or backorder | seller:orders:fulfill |
| Revoke or regenerate a keyless fulfilment | seller:orders:manage |
| Ask a vendor for more stock; change an allocation's top-up settings | seller:allocations:write |
| Report refunds and chargebacks, return keys, freeze keys in a dispute | seller:refunds:write |
| Read refund and chargeback status | seller:refunds:read |
| Read finance: balances, sales, invoices, statements, the settlement feed | seller:finance:read |
| Export keys as a ZIP file | seller:keys:export |
| Manage API keys over the API | seller:keys:write |
| Register and manage webhook endpoints | seller:webhooks:write (read-only: seller:webhooks:read) |
| Read promotions; accept, decline or answer them | seller:promotions:read, seller:promotions:respond |
| Change your selling footprint and order presets; answer a vendor's access proposal | seller:account:manage |
GET /whoami, GET /access/proposals, GET /sandbox/certification, POST /geo/attest, GET /me/footprint and GET /me/integration-presets need no specific scope: any key that holds at least one Seller API scope can call them.
Legacy scope names#
Two scope names from the first version of the API are still accepted wherever they were, and will stay accepted. They are deprecated in this documentation: do not put them on a new key, and move to the preferred names when you next issue a key. Nothing is refused because a key holds them, and no date has been set to stop accepting them.
| Legacy scope | Where it is still accepted | Use instead |
|---|---|---|
seller:keys:pull | Ordering and key pulls; order reads; refund and dispute writes and refund reads; allocation writes | seller:orders:write for orders, seller:orders:read for order reads, seller:refunds:write / seller:refunds:read for refunds, seller:allocations:write for allocation writes |
seller:products:read on order reads and the settlement feed | GET /orders, GET /orders/{orderId}, GET /transactions, GET /activity | seller:orders:read for orders, seller:finance:read for GET /activity |
seller:orders:write grants everything seller:keys:pull grants, so a key can swap one for the
other without losing an operation. seller:keys:export is the exception: neither name grants a key
export, which needs its own scope.
When a key lacks a scope#
A request whose key holds none of the operation's scopes is refused with 403. Nothing was changed.
- On contract date
2026-12-01and later (pinned withX-Avrix-Api-Version, ornext), the code isINSUFFICIENT_SCOPE.details.requiredScopeslists every scope the operation accepts, preferred first (the same list as in the tables below), anddetails.missingScopenames the preferred one.details.scopeModeisanyOf, oranyfor the operations that accept any Seller API scope. - On earlier contract dates and for requests that do not pin one, the code is
FORBIDDENwithdetails.missingScopeanddetails.requiredScopesas they have always been reported. Where an operation has since started accepting more scopes, that older list can be shorter than the tables below.
A key with no scopes at all also gets details.reason: "scopes_required"; there is no implicit
default. Scopes cannot be added to an existing key: issue a new key with the scope, move your
service to it, then revoke the old one.
Console base scopes#
Keys created in Settings → Integrations → API Keys pre-select exactly these base scopes (from BASE_SELLER_API_KEY_SCOPES):
| Scope | Default |
|---|---|
seller:products:read | On |
seller:orders:preview | On |
seller:keys:pull | On |
seller:keys:write | On |
seller:refunds:read | On |
seller:refunds:write | On |
seller:promotions:read | On |
seller:promotions:respond | On |
seller:webhooks:read | On |
seller:webhooks:write | On |
The base set still pre-selects the legacy seller:keys:pull. It grants the same operations as
seller:orders:write: deselect it and select seller:orders:write (and seller:orders:read or
seller:allocations:write where you need them) to use the preferred names.
The scope picker offers every scope in the tables below, including the preferred names
(seller:orders:read, seller:orders:write, seller:allocations:write) and the opt-in scopes that
are never pre-selected: seller:finance:read, seller:orders:fulfill, seller:orders:manage,
seller:keys:export and seller:account:manage. Deselect anything your service does not need.
seller:account:manage and seller:keys:export are the scopes a legacy key does not receive. Keys issued before scoping existed were backfilled with everything available at the time; that reasoning does not extend to a surface added afterwards: one changes the footprint your sales are settled against, the other hands out a file of plaintext keys. Issue a key with the scope explicitly if you need it.
What each scope grants#
Generated from the API reference. "Preferred scope for" lists the operations where the scope is listed first; "Also accepted on" lists the operations that accept it as one of several.
| Scope | Preferred scope for | Also accepted on |
|---|---|---|
seller:account:manage | POST /access/proposals/{id}/accept, POST /access/proposals/{id}/decline, PUT /me/footprint, PUT /me/integration-presets, DELETE /me/integration-presets | none |
seller:allocations:write | PATCH /allocations/{id}, POST /allocations/requests, POST /allocations/requests/{id}/cancel | none |
seller:finance:read | GET /activity, GET /finance/summary, GET /finance/api-sales, GET /finance/invoices, GET /finance/statements, GET /finance/ledger, GET /finance/api-sales/{transactionId}, GET /finance/invoices/{invoiceId}/reconciliation, GET /finance/invoices/{invoiceId}, GET /finance/invoices/{invoiceId}/document, GET /finance/payments, GET /finance/reports, GET /finance/reports/{reportId}, GET /finance/reports/{reportId}/lines | GET /refunds, GET /disputes, GET /disputes/{freezeId}, GET /refunds/{refundId}, POST /refunds/preview, GET /returns, GET /returns/{returnRequestId} |
seller:keys:export | POST /keys/export | none |
seller:keys:pull | none | PATCH /allocations/{id}, POST /allocations/requests, POST /allocations/requests/{id}/cancel, GET /transactions, POST /keys/pull, GET /keys/pulls, POST /keys/return, GET /refunds, POST /refunds, GET /orders, POST /orders, POST /orders/reserve, POST /orders/commit, POST /orders/reservations/{reservationId}/commit, POST /orders/preview, POST /orders/hold, DELETE /orders/hold, GET /orders/hold/{holdId}, DELETE /orders/hold/{holdId}, POST /disputes/freeze, POST /disputes/{freezeId}/release, GET /disputes, GET /disputes/{freezeId}, POST /orders/recover-keys, POST /orders/cancel, POST /orders/bulk, GET /orders/{orderId}, POST /orders/{orderId}/extend, POST /orders/reservations/{reservationId}/extend, GET /refunds/{refundId}, POST /refunds/preview, POST /chargebacks/resolve, GET /returns, POST /returns, GET /returns/{returnRequestId}, POST /returns/{returnRequestId}/reply, POST /returns/{returnRequestId}/cancel, POST /returns/{returnRequestId}/evidence, POST /orders/{orderId}/keys/{keyId}/replace, POST /orders/{orderId}/fulfill |
seller:keys:read | GET /keys, GET /api-keys | none |
seller:keys:write | POST /keys, POST /api-keys, DELETE /keys/{id}, DELETE /api-keys/{id}, PATCH /keys/{id}/allowed-ips, PATCH /api-keys/{id}/allowed-ips, POST /keys/{id}/rotate, POST /api-keys/{id}/rotate | GET /keys, GET /api-keys |
seller:orders:fulfill | POST /orders/{orderId}/fulfill | none |
seller:orders:manage | POST /orders/fulfillments/{fulfillmentId}/revoke, POST /orders/fulfillments/{fulfillmentId}/regenerate | none |
seller:orders:preview | POST /orders/preview | none |
seller:orders:read | GET /transactions, GET /keys/pulls, GET /orders, GET /orders/hold/{holdId}, GET /orders/{orderId} | none |
seller:orders:write | POST /keys/pull, POST /orders, POST /orders/reserve, POST /orders/commit, POST /orders/reservations/{reservationId}/commit, POST /orders/hold, DELETE /orders/hold, DELETE /orders/hold/{holdId}, POST /orders/recover-keys, POST /orders/cancel, POST /orders/bulk, POST /orders/{orderId}/extend, POST /orders/reservations/{reservationId}/extend, POST /orders/{orderId}/keys/{keyId}/replace | PATCH /allocations/{id}, POST /allocations/requests, POST /allocations/requests/{id}/cancel, GET /transactions, GET /keys/pulls, POST /keys/return, GET /refunds, POST /refunds, GET /orders, POST /orders/preview, GET /orders/hold/{holdId}, POST /disputes/freeze, POST /disputes/{freezeId}/release, GET /disputes, GET /disputes/{freezeId}, GET /orders/{orderId}, GET /refunds/{refundId}, POST /refunds/preview, POST /chargebacks/resolve, GET /returns, POST /returns, GET /returns/{returnRequestId}, POST /returns/{returnRequestId}/reply, POST /returns/{returnRequestId}/cancel, POST /returns/{returnRequestId}/evidence, POST /orders/{orderId}/fulfill |
seller:products:read | GET /products, GET /products/lookup, GET /products/{productId}, GET /products/{productId}/pricing, GET /catalog/checksum, GET /catalog/changes, GET /catalog/snapshot, GET /partners, GET /partners/{connectionId}/offers, GET /partners/{connectionId}/agreements, GET /allocations, GET /allocations/{id}, GET /allocations/{id}/replenishments, GET /allocations/requests, GET /allocations/requests/{id}, GET /availability, GET /usage, GET /requests/{requestId}, GET /availability/changes, GET /availability/{skuCode}, GET /regions, GET /regions/{code}, GET /products/{productId}/media/download, GET /platforms, GET /integration/status, POST /catalog/exports, GET /catalog/exports/{exportId} | GET /transactions, GET /keys/pulls, GET /orders, GET /orders/hold/{holdId}, GET /orders/{orderId}, GET /activity |
seller:promotions:read | GET /promotions/summary, GET /promotions/shares, GET /promotions/shares/{shareId}, GET /promotions/deals, GET /promotions/deals/{responseId}, GET /promotions/shares/{shareId}/discounts, GET /promotions/calendar | none |
seller:promotions:respond | POST /promotions/shares/{shareId}/accept, POST /promotions/shares/{shareId}/decline, POST /promotions/deals/{responseId}/respond | none |
seller:refunds:read | GET /refunds, GET /disputes, GET /disputes/{freezeId}, GET /refunds/{refundId}, POST /refunds/preview, GET /returns, GET /returns/{returnRequestId} | none |
seller:refunds:write | POST /keys/return, POST /refunds, POST /disputes/freeze, POST /disputes/{freezeId}/release, POST /chargebacks/resolve, POST /returns, POST /returns/{returnRequestId}/reply, POST /returns/{returnRequestId}/cancel, POST /returns/{returnRequestId}/evidence | GET /refunds, GET /disputes, GET /disputes/{freezeId}, GET /refunds/{refundId}, POST /refunds/preview, GET /returns, GET /returns/{returnRequestId} |
seller:webhooks:read | GET /webhooks/event-types, GET /webhooks, GET /webhooks/{id}, GET /webhooks/{id}/deliveries/{deliveryId}, GET /webhooks/{id}/deliveries, GET /events | none |
seller:webhooks:write | POST /webhooks, PATCH /webhooks/{id}, DELETE /webhooks/{id}, POST /webhooks/{id}/test, POST /webhooks/{id}/enable, POST /webhooks/{id}/disable, POST /webhooks/{id}/deliveries/{deliveryId}/retry, POST /webhooks/{id}/deliveries/replay | none |
| (any seller scope) | GET /access/proposals, POST /geo/attest, GET /geo/attest/{attestId}, GET /whoami, GET /me/footprint, GET /me/integration-presets, GET /sandbox/certification, POST /sandbox/reset, POST /sandbox/allocations/requests/{requestId}/resolve, POST /sandbox/allocations/{allocationId}/stock-events, POST /sandbox/promotions/deals/{responseId}/window | |
| (no key) | GET /whoami-ip, GET /health, GET /geo/attest/{attestId}/pixel, POST /geo/attest/{attestId}/complete, POST /api/seller/oauth/token, GET /webhooks/egress-ips |
Scopes per operation#
Generated from the API reference. A key that holds any one of the listed scopes is accepted; the preferred scope is in bold. "Any seller scope" means a key holding at least one Seller API scope; "No key" means the operation reads no key.
| Group | Operation | Accepted scopes (any one; preferred in bold) |
|---|---|---|
| Allocations | GET /allocations | seller:products:read |
| Allocations | GET /allocations/{id} | seller:products:read |
| Allocations | PATCH /allocations/{id} | seller:allocations:write, seller:orders:write, seller:keys:pull |
| Allocations | GET /allocations/{id}/replenishments | seller:products:read |
| Allocations | GET /allocations/requests | seller:products:read |
| Allocations | POST /allocations/requests | seller:allocations:write, seller:orders:write, seller:keys:pull |
| Allocations | GET /allocations/requests/{id} | seller:products:read |
| Allocations | POST /allocations/requests/{id}/cancel | seller:allocations:write, seller:orders:write, seller:keys:pull |
| Allocations | GET /availability | seller:products:read |
| Allocations | GET /availability/changes | seller:products:read |
| Allocations | GET /availability/{skuCode} | seller:products:read |
| Catalog | GET /products | seller:products:read |
| Catalog | GET /products/lookup | seller:products:read |
| Catalog | GET /products/{productId} | seller:products:read |
| Catalog | GET /products/{productId}/pricing | seller:products:read |
| Catalog | GET /catalog/checksum | seller:products:read |
| Catalog | GET /catalog/changes | seller:products:read |
| Catalog | GET /catalog/snapshot | seller:products:read |
| Catalog | GET /partners/{connectionId}/agreements | seller:products:read |
| Catalog | GET /products/{productId}/media/download | seller:products:read |
| Catalog | POST /catalog/exports | seller:products:read |
| Catalog | GET /catalog/exports/{exportId} | seller:products:read |
| Finance | GET /finance/summary | seller:finance:read |
| Finance | GET /finance/api-sales | seller:finance:read |
| Finance | GET /finance/invoices | seller:finance:read |
| Finance | GET /finance/statements | seller:finance:read |
| Finance | GET /finance/ledger | seller:finance:read |
| Finance | GET /finance/api-sales/{transactionId} | seller:finance:read |
| Finance | GET /finance/invoices/{invoiceId}/reconciliation | seller:finance:read |
| Finance | GET /finance/invoices/{invoiceId} | seller:finance:read |
| Finance | GET /finance/invoices/{invoiceId}/document | seller:finance:read |
| Finance | GET /finance/payments | seller:finance:read |
| Finance | GET /finance/reports | seller:finance:read |
| Finance | GET /finance/reports/{reportId} | seller:finance:read |
| Finance | GET /finance/reports/{reportId}/lines | seller:finance:read |
| Keys | POST /keys/export | seller:keys:export |
| Keys | POST /keys/pull | seller:orders:write, seller:keys:pull |
| Keys | GET /keys/pulls | seller:orders:read, seller:orders:write, seller:products:read, seller:keys:pull |
| Orders | GET /transactions | seller:orders:read, seller:orders:write, seller:products:read, seller:keys:pull |
| Orders | GET /orders | seller:orders:read, seller:orders:write, seller:products:read, seller:keys:pull |
| Orders | POST /orders | seller:orders:write, seller:keys:pull |
| Orders | POST /orders/reserve | seller:orders:write, seller:keys:pull |
| Orders | POST /orders/commit | seller:orders:write, seller:keys:pull |
| Orders | POST /orders/reservations/{reservationId}/commit | seller:orders:write, seller:keys:pull |
| Orders | POST /orders/preview | seller:orders:preview, seller:orders:write, seller:keys:pull |
| Orders | POST /orders/hold | seller:orders:write, seller:keys:pull |
| Orders | DELETE /orders/hold | seller:orders:write, seller:keys:pull |
| Orders | GET /orders/hold/{holdId} | seller:orders:read, seller:orders:write, seller:products:read, seller:keys:pull |
| Orders | DELETE /orders/hold/{holdId} | seller:orders:write, seller:keys:pull |
| Orders | POST /orders/recover-keys | seller:orders:write, seller:keys:pull |
| Orders | POST /orders/cancel | seller:orders:write, seller:keys:pull |
| Orders | POST /orders/bulk | seller:orders:write, seller:keys:pull |
| Orders | GET /orders/{orderId} | seller:orders:read, seller:orders:write, seller:products:read, seller:keys:pull |
| Orders | POST /orders/{orderId}/extend | seller:orders:write, seller:keys:pull |
| Orders | POST /orders/reservations/{reservationId}/extend | seller:orders:write, seller:keys:pull |
| Orders | POST /orders/fulfillments/{fulfillmentId}/revoke | seller:orders:manage |
| Orders | POST /orders/fulfillments/{fulfillmentId}/regenerate | seller:orders:manage |
| Orders | POST /orders/{orderId}/keys/{keyId}/replace | seller:orders:write, seller:keys:pull |
| Orders | POST /orders/{orderId}/fulfill | seller:orders:fulfill, seller:orders:write, seller:keys:pull |
| Partners | GET /partners | seller:products:read |
| Partners | GET /partners/{connectionId}/offers | seller:products:read |
| Partners | GET /access/proposals | Any seller scope |
| Partners | POST /access/proposals/{id}/accept | seller:account:manage |
| Partners | POST /access/proposals/{id}/decline | seller:account:manage |
| Promotions | GET /promotions/summary | seller:promotions:read |
| Promotions | GET /promotions/shares | seller:promotions:read |
| Promotions | GET /promotions/shares/{shareId} | seller:promotions:read |
| Promotions | POST /promotions/shares/{shareId}/accept | seller:promotions:respond |
| Promotions | POST /promotions/shares/{shareId}/decline | seller:promotions:respond |
| Promotions | GET /promotions/deals | seller:promotions:read |
| Promotions | GET /promotions/deals/{responseId} | seller:promotions:read |
| Promotions | POST /promotions/deals/{responseId}/respond | seller:promotions:respond |
| Promotions | GET /promotions/shares/{shareId}/discounts | seller:promotions:read |
| Promotions | GET /promotions/calendar | seller:promotions:read |
| Reference data | GET /regions | seller:products:read |
| Reference data | GET /regions/{code} | seller:products:read |
| Reference data | GET /platforms | seller:products:read |
| Refunds | POST /keys/return | seller:refunds:write, seller:orders:write, seller:keys:pull |
| Refunds | GET /refunds | seller:refunds:read, seller:refunds:write, seller:finance:read, seller:orders:write, seller:keys:pull |
| Refunds | POST /refunds | seller:refunds:write, seller:orders:write, seller:keys:pull |
| Refunds | POST /disputes/freeze | seller:refunds:write, seller:orders:write, seller:keys:pull |
| Refunds | POST /disputes/{freezeId}/release | seller:refunds:write, seller:orders:write, seller:keys:pull |
| Refunds | GET /disputes | seller:refunds:read, seller:refunds:write, seller:finance:read, seller:orders:write, seller:keys:pull |
| Refunds | GET /disputes/{freezeId} | seller:refunds:read, seller:refunds:write, seller:finance:read, seller:orders:write, seller:keys:pull |
| Refunds | GET /refunds/{refundId} | seller:refunds:read, seller:refunds:write, seller:finance:read, seller:orders:write, seller:keys:pull |
| Refunds | POST /refunds/preview | seller:refunds:read, seller:refunds:write, seller:finance:read, seller:orders:write, seller:keys:pull |
| Refunds | POST /chargebacks/resolve | seller:refunds:write, seller:orders:write, seller:keys:pull |
| Refunds | GET /returns | seller:refunds:read, seller:refunds:write, seller:finance:read, seller:orders:write, seller:keys:pull |
| Refunds | POST /returns | seller:refunds:write, seller:orders:write, seller:keys:pull |
| Refunds | GET /returns/{returnRequestId} | seller:refunds:read, seller:refunds:write, seller:finance:read, seller:orders:write, seller:keys:pull |
| Refunds | POST /returns/{returnRequestId}/reply | seller:refunds:write, seller:orders:write, seller:keys:pull |
| Refunds | POST /returns/{returnRequestId}/cancel | seller:refunds:write, seller:orders:write, seller:keys:pull |
| Refunds | POST /returns/{returnRequestId}/evidence | seller:refunds:write, seller:orders:write, seller:keys:pull |
| Sandbox | GET /sandbox/certification | Any seller scope |
| Sandbox | POST /sandbox/reset | Any seller scope |
| Sandbox | POST /sandbox/allocations/requests/{requestId}/resolve | Any seller scope |
| Sandbox | POST /sandbox/allocations/{allocationId}/stock-events | Any seller scope |
| Sandbox | POST /sandbox/promotions/deals/{responseId}/window | Any seller scope |
| Seller auth | GET /keys | seller:keys:read, seller:keys:write |
| Seller auth | POST /keys | seller:keys:write |
| Seller auth | GET /api-keys | seller:keys:read, seller:keys:write |
| Seller auth | POST /api-keys | seller:keys:write |
| Seller auth | DELETE /keys/{id} | seller:keys:write |
| Seller auth | DELETE /api-keys/{id} | seller:keys:write |
| Seller auth | PATCH /keys/{id}/allowed-ips | seller:keys:write |
| Seller auth | PATCH /api-keys/{id}/allowed-ips | seller:keys:write |
| Seller auth | POST /keys/{id}/rotate | seller:keys:write |
| Seller auth | POST /api-keys/{id}/rotate | seller:keys:write |
| Seller auth | POST /api/seller/oauth/token | No key |
| Seller meta | GET /whoami-ip | No key |
| Seller meta | GET /health | No key |
| Seller meta | GET /usage | seller:products:read |
| Seller meta | GET /requests/{requestId} | seller:products:read |
| Seller meta | POST /geo/attest | Any seller scope |
| Seller meta | GET /geo/attest/{attestId} | Any seller scope |
| Seller meta | GET /geo/attest/{attestId}/pixel | No key |
| Seller meta | POST /geo/attest/{attestId}/complete | No key |
| Seller meta | GET /whoami | Any seller scope |
| Seller meta | GET /activity | seller:finance:read, seller:products:read |
| Seller meta | GET /integration/status | seller:products:read |
| Seller meta | GET /me/footprint | Any seller scope |
| Seller meta | PUT /me/footprint | seller:account:manage |
| Seller meta | GET /me/integration-presets | Any seller scope |
| Seller meta | PUT /me/integration-presets | seller:account:manage |
| Seller meta | DELETE /me/integration-presets | seller:account:manage |
| Webhooks | GET /webhooks/event-types | seller:webhooks:read |
| Webhooks | GET /webhooks | seller:webhooks:read |
| Webhooks | POST /webhooks | seller:webhooks:write |
| Webhooks | GET /webhooks/{id} | seller:webhooks:read |
| Webhooks | PATCH /webhooks/{id} | seller:webhooks:write |
| Webhooks | DELETE /webhooks/{id} | seller:webhooks:write |
| Webhooks | POST /webhooks/{id}/test | seller:webhooks:write |
| Webhooks | POST /webhooks/{id}/enable | seller:webhooks:write |
| Webhooks | POST /webhooks/{id}/disable | seller:webhooks:write |
| Webhooks | GET /webhooks/{id}/deliveries/{deliveryId} | seller:webhooks:read |
| Webhooks | POST /webhooks/{id}/deliveries/{deliveryId}/retry | seller:webhooks:write |
| Webhooks | POST /webhooks/{id}/deliveries/replay | seller:webhooks:write |
| Webhooks | GET /webhooks/{id}/deliveries | seller:webhooks:read |
| Webhooks | GET /events | seller:webhooks:read |
| Webhooks | GET /webhooks/egress-ips | No key |
GET /health reads a key when one is sent but does not require it. POST /geo/attest/{attestId}/complete
and GET /geo/attest/{attestId}/pixel are called from the buyer's checkout page and secured by the
attestation id. POST /api/seller/oauth/token takes the key's client credentials instead of a
Bearer key. GET /sandbox/certification also needs a sandbox key (a production key answers
422 SANDBOX_KEY_REQUIRED).
Every production key needs an IP allowlist or a
trusted workload binding. A production key with neither is refused with
403 ALLOWLIST_REQUIRED while whoami.capabilities.requireProductionAllowlistEnabled
is true. Once you configure entries, requests from other addresses are
rejected with 403 IP_NOT_ALLOWED.
Finance base path: Canonical /api/seller/v1/finance/.... Same host and Authorization: Bearer as the rest of the Seller API. Unversioned /api/seller/finance/... redirects to /v1/.
Key lifecycle (expiry, create-then-retire vs in-place rotate, ~60s revocation): Authentication.
See also Integration recipes and Sandbox for 403 triage.
Related#
- Quickstart — create a key with the right scopes before your first order
- Authentication — credentials, expiry, rotation
- IP allowlist — egress IP restrictions per key, and when an empty list is refused
- Integration recipes — scopes and call order per flow
- Error playbook —
INSUFFICIENT_SCOPEandFORBIDDEN(missing scope),IP_NOT_ALLOWED, and recovery actions