Bosta Bridge

Tracking #

Order

Customer

Bosta state

Shopify event

COD

Settlement

Updated

Tracking #

Order

Customer

COD

Fees

State

Delivered

Settlement

Payout ref

Recent payouts recorded

Date

Ref

Shipments

Amount

Note

Time

Level

Source

Tracking #

Message

All endpoints are under /api and need header X-Api-Key: <BRIDGE_API_KEY>. Full spec: openapi.yaml · Guide: docs/API.md

Try it

Connections

Values saved here are stored in the bridge database and override .env. Secrets are masked; leave a masked field untouched to keep it. Save first, then use the Test buttons (they test the saved values).

Bosta API key Dashboard → Settings → API Integration → Read/Write key Business ID for the "unpaid COD" figure (GET /businesses/{id}/transactions) Webhook header name the "Authorization Key" name you set in Bosta's webhook setup Webhook secret the Authorization Key value; requests without it are rejected Base URL Dashboard login email optional · only for the "unpaid COD" figure; Bosta's wallet endpoint rejects API keys. Use a Bosta user without 2FA. Dashboard login password

Webhook URL to register in Bosta:

Shopify Store domain Admin API access token custom app · scopes read_orders, write_fulfillments, write_merchant_managed_fulfillment_orders API version Orders webhook secret only if you point Shopify orders/create at /webhooks/shopify/orders Email customer when the fulfillment is created

Bridge Auto-sync every (minutes) imports new Bosta deliveries and polls every open shipment, then updates Shopify; 0 = off Auto-import window (days) how far back the auto-sync looks for new Bosta deliveries Dry run (fake Bosta/Shopify responses)