task_delivery_invalid: The delivery claim is not usable

The delivery claim does not have the exact dynamo-task-delivery-v1 shape, names another task, or claims more units than the milestone is quoted at. Nothing is recorded.

A streamed meter (/payee/v1/tasks/:id/units) answers the same code when its requestRef starts with task-, or when its requestRef was already metered at another number of units. Nothing is metered. A requestRef that is not 1 to 96 printable characters, or units that are not a positive decimal digit string, answer 400 invalid_request first.

What to do

On the wire

HTTP 409, error type state_error.

With Dynamo-Error-Detail: 1 (1.8.0 task routes):

{
  "error": "state",
  "reason": "task_delivery_invalid",
  "detail": "…",
  "errorDetail": {
    "type": "state_error",
    "code": "task_delivery_invalid",
    "message": "…",
    "param": "task",
    "doc_url": "…/errors/task_delivery_invalid.md",
    "fix": "the delivery is malformed (dynamo-task-delivery-v1: taskId, milestoneId, units up to the milestone's quote, a 32-byte SHA-256 deliverable, issuedAt)"
  }
}

See the Task Allowance and all error codes.