Intercity delivery from your own dock, priced before you book.
Orders going to the next city or the next state usually mean a carrier’s hub network or stock split across a 3PL. Faltah OS hands each parcel to a verified courier already driving that route, picked up at your door, with a quote per order, a record of every handover and one wallet for billing.
- Uploaded
- Quoted
- Courier matched
- Picked up
- Delivered
| Order | Total | Status |
|---|---|---|
| SO-10482Dallas → Houston · 12 lb | $35.18 | Quoted |
| SO-10483Dallas → Austin · 6 lb | $32.28 | Quoted |
| SO-10484Austin → San Antonio · 22 lb | $30.97 | Quoted |
| SO-10485Houston → San Antonio · 9 lb | $32.38 | Quoted |
| SO-10486Fort Worth → Houston · 15 lb | $37.54 | Quoted |
Regional orders are expensive to move and hard to prove.
What it usually takes
- Parcels go through sorting hubs, with zone pricing and surcharges that show up on the invoice.
- Faster regional delivery often means renting space and splitting stock in another city.
- When a customer says a parcel never came, the proof is a scan you didn’t see happen.
How Faltah OS handles it
- Each parcel is quoted on distance and weight before you book; the quote is what the wallet is charged, plus any sales tax.
- A verified courier already heading that way collects it from your address. Nothing is stored in between.
- The recipient confirms with a one-time code; each handover is logged with a photo, a time and a place.
From a spreadsheet to a delivered, documented order.
Upload
A CSV or Excel export of 3 to 500 orders, checked row by row in your browser. Start from the Excel template, or send batches through the API.
See costs
Every row is quoted on estimated road miles and weight, and the batch total, platform fee included, shows before anything is booked.
Match and pickup
A verified courier going that way accepts the parcel and collects it at your address, with a photo at pickup.
Track
Status moves from booked to picked up to delivered in the dashboard, and to your systems through webhooks.
Evidence
The recipient’s one-time code, plus a photo, time and place for each handover, kept with the order.
Billing
Each shipment is paid from your prepaid wallet; a monthly statement and invoice itemize every one.
What you see for each order.
Two views from the dashboard, filled with a sample order so the figures are real tariff math, not real customers.
- Booked
- Quote accepted from the batch · $35.18
- Pickup
- Courier at your address · parcel photo · time and place logged
- On the way
- Status updates in the dashboard and by webhook
- Delivered
- Recipient’s one-time code verified · photo · time and place logged
- If disputed
- The record stays with the order to help you respond
- Dallas, TX → Houston, TX · 12 lb
- 239 mi
- Distance fee
- $35.32
- Weight fee
- $1.00
- Volume tier (10% applied)
- −$3.63
- Platform fee
- $2.49
- Charged to wallet
- $35.18
A published rate card, itemized to the cent.
$12 covers the first 10 road miles, then $0.35 a mile, capped on longer routes. The first 10 lb are free, then $0.50 per pound. Add the $2.49 platform fee and any sales tax. Try your own numbers:
- Distance feeRate card $92.50, capped for this distance
- $35.37
- Weight feeFirst 10 lb free, then $0.50 per started lb
- $2.50
- Volume discount10% tier at 300 delivered in 30 days
- −$3.79
- Platform feePer shipment; discounts never apply to it
- $2.49
- Per parcel, before sales tax
- $36.57
At 300 parcels like this a month: $10,971, of which the volume tier saves $1,137. 700 more delivered would reach 15%.
An estimate on the current published tariff. A portal quote is exact for each address and is shown before you book. Sales tax is added where it applies. A discount never lowers the courier’s pay or takes a parcel below $8.00; on low-priced parcels the tier can be smaller than its full percentage.
How you pay, and what applies.
- Prepaid wallet
- Bookings are paid from your wallet balance, so fund it before your first batch. No contract and no monthly volume commitment.
- Online top-ups
- By card or U.S. bank account through Stripe: $25 to $1,000 per top-up, up to $3,000 in 30 days, with no fee to you.
- Larger amounts
- By bank wire or ACH, from $100, credited to the wallet once the transfer arrives.
- Volume discounts
- Applied automatically on distance and weight, by shipments delivered in the last 30 days:50+ → 5%250+ → 10%1,000+ → 15%
- Minimums
- 3 orders per batch. A volume discount never takes a parcel below $8.00 before the platform fee, and the $2.49 platform fee applies to every shipment.
- Parcels and places
- Up to 150 lb a parcel, between addresses in the 48 contiguous states and Washington, D.C. Alaska, Hawaii and the U.S. territories are not served.
- Timing
- A parcel moves when a courier heading that way accepts it. Busy routes between large metros tend to match sooner; quieter routes can take longer. Nothing here is a delivery-time guarantee.
- Account review
- Sign up and explore in sandbox right away. Live shipments open once your business is verified.
Optional: connect your own systems.
You don’t need the API to use Faltah OS; uploads do the same job. If you want it, a sandbox key is self-serve on the portal’s Developer page as soon as you sign up. A live key is issued once your account is verified.
Endpoints, webhooks and a signature example
REST over HTTPS with an API key header and idempotency keys. Batches follow the same 3–500 order rule as uploads.
- POST/api/v1/quotes
- POST/api/v1/shipments
- POST/api/v1/shipments/:id/cancel
- POST/api/v1/shipments/:id/returns
Webhooks are signed with HMAC-SHA256. A failed delivery is retried with backoff, up to 6 attempts in all. Events:
- shipment.created
- shipment.assigned
- shipment.picked_up
- shipment.delivered
- shipment.cancelled
// Verify a Faltah OS webhook (Node)
import crypto from "node:crypto";
// header: x-faltah-signature: t=<unix seconds>,v1=<hex>
export function verify(rawBody, header, secret, maxAgeSec = 300) {
const parts = Object.fromEntries(
String(header ?? "").split(",").map((p) => p.trim().split("=")),
);
const t = Number(parts.t);
if (!Number.isInteger(t) || !/^[0-9a-f]{64}$/i.test(parts.v1 ?? "")) {
return false;
}
// Reject old timestamps so a captured request can't be replayed.
if (Math.abs(Date.now() / 1000 - t) > maxAgeSec) return false;
const expected = crypto
.createHmac("sha256", secret)
.update(`${parts.t}.${rawBody}`)
.digest("hex");
return crypto.timingSafeEqual(
Buffer.from(parts.v1, "hex"), Buffer.from(expected, "hex"));
}Before you sign up.
Can I send a single parcel?
Faltah OS books in batches of 3 to 500 orders. For one-off parcels, use the Faltah app.
Is the calculator price what I pay?
The calculator uses the published tariff and a distance you choose. The portal quotes each address exactly before you book, and that quote, plus any sales tax, is what the wallet is charged.
Who carries the parcels?
Independent couriers who verify their identity with Stripe and pass a driver's license check, and who are already driving the route. A courier is paid only after the delivery is confirmed.
What happens if a customer disputes a delivery?
Each order keeps the recipient's code confirmation and the photos, times and places of each handover. That record helps you respond; the outcome of a dispute is decided by your payment provider or card network.
Do volume discounts reduce the courier's pay?
No. Courier pay is fixed on the undiscounted price; discounts come out of Faltah's share.
Ship your next regional batch from where your stock already is.
Open an account, explore in sandbox, fund your wallet and upload your first batch once your business is verified.
Integrations, high volume or something unusual? Email partners@faltahapp.com.