Drop developers

Idempotency

Every create-order call needs a stable Idempotency-Key. This lets your checkout retry safely after a timeout without creating a second delivery.

Required create-order header

http

POST /v1/orders HTTP/1.1
Authorization: Bearer <access_token>
Idempotency-Key: checkout-ORD-100245
Content-Type: application/json

Retry pattern

text

Same key + same request body      returns the original create result
Same key + different request body  returns 409 Conflict
No Idempotency-Key                 returns 400 Bad Request

Implementation notes

Generate one key per business action, for example per checkout or POS receipt.
Persist the key and the returned Drop order ID in your system.
Never reuse a key for a different customer, address or package payload.