Connect a Luma Swift account
Luma Swift is a FedEx shipping service with its own prepaid wallet. Connecting your Luma account lets Orderly show Luma's live FedEx rates in Dispatch Lane, buy labels through Luma, and track the resulting shipments.
Add the account
- In Luma Swift, open Configurations and then API Access.
- Copy your Client Id (a number) and create or copy an API key.
- In Orderly, open Carrier Accounts, choose Luma Swift, and paste both values.
Credentials are checked for shape when you save them and verified against Luma when you press Test. The API key is stored encrypted.
What it supports
- Live FedEx rates. Quotes come from Luma at your account's pricing.
- Labels. Orderly holds the funds for the label first, then buys it through Luma. The label is stored with the shipment.
- Tracking. Luma sends tracking events to Orderly by webhook, and a periodic sweep polls Luma for shipments that did not report.
What it does not support
- Voiding from Orderly. Luma exposes no void or cancel endpoint. Cancel the shipment in Luma's dashboard instead. Orderly returns an error for a void request and changes no balance or status.
Wallet errors
Luma enforces its own prepaid wallet, separate from your Orderly balance. When Luma answers a purchase with a payment-required error (HTTP 402 or 423), its wallet is too low. Top up the wallet in Luma and retry. Orderly releases the hold it placed for the label, so you are not charged twice.
Pointing at a local mock
For local development, set LUMASWIFT_API_BASE_URL in packages/api/.dev.vars
to a Luma-compatible server. The repository ships one:
node scripts/mocks/lumaswift-mock.mjs --port 4320
Then set LUMASWIFT_API_BASE_URL=http://localhost:4320 and use Client Id
1012 with API key luma_mock_key. Set LUMA_MOCK_WALLET_CENTS to simulate a
low wallet, and call POST /__mock/advance/<tracking> with
{"status":"DELIVERED"} to push a signed tracking webhook to registered URLs.