Drop Docs

Idempotency

All create requests should be retried safely. Send an Idempotency-Key header so Drop can deduplicate repeated create attempts without creating duplicate orders.

Same key + same body

Returns the same result instead of creating a duplicate order.

Same key + different body

Returns an error because the key has already been used for another payload.

No Idempotency-Key

Rejected for create-order requests on the public merchant API.

Recommended header

text

Idempotency-Key: 3af4c2b7-website-checkout-100245

Retry pattern

bash

curl -X POST https://api.dropsa.co.za/v1/orders \
  -H "Authorization: Bearer <access_token>" \
  -H "Idempotency-Key: 3af4c2b7-website-checkout-100245" \
  -H "Content-Type: application/json" \
  -d '{ ...same request body... }'