MATJRAH DEVELOPERS + APPS CENTER

Publish your
Shipping App on Matjrah.

Shipping always starts with a Shipping App. Publish a public app for many merchants or send a private app invitation to one store, then operate AWBs, labels, tracking, cancellation and returns through that installed app.

Start in the Developers Center Meet the Partnerships team

Integration support: dev@matjrah.com · ERP integration guide · API reference

THE MATJRAH PLATFORM

One shipping connection across the merchant journey.

Matjrah turns shipping into an installable merchant product—not a loose API credential. The Developers Center is where the carrier creates and certifies its Shipping App; the Apps Center is where merchants discover it or accept its private invitation.

Every merchant approves the app independently. Tokens, shipment records and Webhook deliveries remain isolated by installation and can be revoked without sharing the merchant’s master credentials.

3,500+merchant stores use Matjrah

2 app modelsPublic Shipping App or private invite-only Shipping App

Per-store installsIndependent scopes, token and shipment ownership

Forward + returnOne shipment contract supports both directions

Courier network Shipping aggregator 3PL provider Last-mile fleet

These are supported partner models, not claims of a ready-made integration with a particular carrier.

SANDBOX CHECKPOINT

One signed shipment event, accepted durably.

Self-service Sandbox proves installation, HMAC verification and delivery of shipment.creating. AWB attachment, tracking, cancellation and tenant isolation must be certified on a provisioned active test store. Understand the environments ↗

CHOOSE THE OPERATING MODEL

One Shipping App, shaped for your operation.

Courier, aggregator, 3PL or private fleet: each provider creates a Shipping App with the services and operating model its merchants need.

01 / COURIER

Publish one branded service

Declare your service, default coverage, delivery period and pricing, then let merchants install it from the Shipping catalog.

Public app path →

02 / AGGREGATOR OR 3PL

Offer several carrier services

Declare multiple carrier codes in one manifest while keeping every AWB, label and tracking update tied to the selected service.

Manifest workflow →

03 / PRIVATE FLEET

Operate shipping for one merchant

Create an invite-only Shipping App for a merchant-owned carrier account or fleet. It remains an app with installation, scopes and certification; it is simply hidden from the public catalog.

Private app path →

THE COMPLETE PRODUCT — NOT ONLY AN ENDPOINT

From carrier setup to merchant-ready shipping app

The Developers Center handles Shipping App creation, service manifest, Sandbox and certification. Apps Center handles discovery or invitation. Only after merchant installation does the app receive shipment work and return operational results.

01RegisterCreate the partner account for your integration team.
02Create the appChoose Shipping and public or private visibility.
03Declare servicesAdd carrier codes, coverage, rates, periods and COD support.
04Prove deliveryVerify and deduplicate the signed Sandbox event.
05Certify the cycleAttach AWB, push tracking and test cancellation.
06Publish or inviteInstall independently for every merchant.

CHOOSE YOUR APP MODEL

Public for reach. Private for one merchant.

These are the only shipping entry paths. Both create an installed Shipping App with its own per-store token. There is no standalone dashboard API/Webhook path for shipping.

PUBLIC SHIPPING APPFor many merchants

Publish in the Shipping catalog

Best for couriers, aggregators and 3PL providers with a reusable product and support process.

Listed under Shipping after approval
One manifest can declare one or several services
Every merchant installs and receives an independent token
Merchants can adjust their local rates after installation

Create a public shipping app ↗

PRIVATE SHIPPING APPFor one store

Send an invite-only Shipping App

Best for a merchant-specific carrier account, custom fleet or implementation project that should not be discoverable.

Never listed in the public catalog
Invitation is bound to the exact store domain
Merchant reviews and approves the connection
Disconnecting revokes the installation token

Create a private shipping app ↗

THE SHIPMENT RUNTIME

Receive the job, return the shipping truth.

API and Webhooks are the runtime of an approved, installed Shipping App—not a separate integration path. Verify the exact raw Webhook body, persist request_id and shipment_id, and use only that installation's token.

01 / MANIFEST

Services and defaults

Declare carrier codes, countries, zones, default cost, delivery period and capabilities such as COD.

02 / WEBHOOK

`shipment.creating`

Receive order, recipient, items, weight, COD amount and direction: forward | return in the signed event.

03 / AWB + LABEL

`PUT /v1/shipments/{id}`

Attach the AWB, tracking number, stable tracking link and optional label URL to the exact shipment.

04 / LIFECYCLE

Track or cancel

Push picked-up, in-transit, out-for-delivery, delivered, returned or failed states; cancel with the dedicated endpoint.

Open the Shipping API reference ↗Bearer ait_… · 120 requests/minute/installation

WHAT TO CERTIFY

The complete operational cycle

A logo and a successful sample Webhook are not enough. Review covers the real installed-store lifecycle and failure behavior.

Forward shipmentsReturn shipmentsAWB and label deliveryStable tracking linksCOD amount handlingZones and default ratesCancellation and retry safetyTenant-isolated credentials

REVIEW READINESS

A Shipping App merchants can operate

Certification starts with shipment ownership and failure recovery, not listing copy.

Signature verificationVerify HMAC against the exact raw body before parsing.
Durable deduplicationDo not create a second carrier shipment for a repeated request_id or shipment_id.
Tenant isolationNever mix install tokens, shipment queues, labels or logs across stores.
Complete callbacksReturn AWB and label, then push tracking, cancellation and terminal states.
Actionable monitoringCorrelate errors to the installation and shipment without exposing secrets or recipient data.

CREATE YOUR SHIPPING APP

Package your shipping service for Matjrah merchants.

Start by creating a Shipping App in the Developers Center. If you represent a courier, aggregator, 3PL provider or private fleet and need technical or commercial alignment, schedule a conversation. For app integration support, email dev@matjrah.com.

Create your shipping app Schedule a 30-minute call