Developers

Build on Pixa

A partner gateway for e-commerce and shipping companies: create shipments, track them, and receive delivery events in real time via webhooks.

Create a shipment

Bearer authentication with a partner key; all requests are JSON over HTTPS.

Independent scoped keys per partner
A sandbox before production
Signed webhook events for verification
Fair, published rate limits

curl -X POST https://portal.pixa-sa.com/api/partner/v1/shipments \
  -H "Authorization: Bearer $PIXA_PARTNER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reference": "SO-10425",
    "recipient": { "name": "...", "phone": "+9665xxxxxxxx" },
    "address": { "city": "Riyadh", "district": "Alnarjis" },
    "cod": { "amount": 145.00, "currency": "SAR" }
  }'

Webhook events

shipment.createdshipment.assignedshipment.out_for_deliveryshipment.deliveredshipment.failedcod.settled

Full OpenAPI docs publish when self-serve keys open. For sandbox keys today, contact us via the contact page. Request sandbox keys