Drop developers

Errors

Treat validation, authentication, account and payment errors as part of the delivery workflow. Correct the input or account state before retrying.

Common HTTP responses

text

400  Missing Idempotency-Key, missing reference, or invalid request data
401  Missing, expired, or invalid bearer token
403  Merchant app is missing the required scope
404  Order, merchant or webhook does not exist for this account
409  Idempotency-Key was reused with a different request body
422  Field validation failed

Validation response shape

json

{
  "statusCode": 400,
  "message": "Idempotency-Key header is required",
  "error": "Bad Request"
}

Implementation notes

Do not retry a 4xx response unchanged. Resolve the validation, scope, account or billing issue first.
Log request_id, your merchant reference and Drop order ID together for support and reconciliation.