Drop developers

Quickstart

Create an app in the Drop portal, exchange its credentials for a token, get a price quote, then create and track a delivery order.

1. Request a bearer token

bash

curl -X POST https://api.dropsa.co.za/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "drop_app_client_id",
    "client_secret": "drop_app_client_secret"
  }'

2. Use the token to create an order

bash

curl -X POST https://api.dropsa.co.za/v1/orders \
  -H "Authorization: Bearer <access_token>" \
  -H "Idempotency-Key: checkout-ORD-100245" \
  -H "Content-Type: application/json" \
  -d @order.json

Implementation notes

Create the merchant app and set its scopes in the Drop portal before calling the API.
Use a stable Idempotency-Key for every create request so checkout retries do not create duplicate deliveries.
Configure a webhook after testing so your store receives delivery status updates automatically.