confirmEnvelopeDelivery(envelope_id)

Purpose

Marks the successful delivery of a high-value ticket envelope at the Drawn claim center
or another registered endpoint. This concludes the physical custody chain.

---

Endpoint

POST /api/confirm-delivery/{envelope_id}

---

Authorization

• Required Scope: courier.confirm or ops.dispatch
• Token: Bearer Token required

---

Parameters

Name	Type	Required	Description
envelope_id	string	✅	Unique identifier of the delivered envelope

---

Response: Success (200 OK)

{
  "envelope_id": "env-22a94",
  "delivered_at": "2025-06-26T12:00:00Z",
  "delivered_to": "drawn_claim_center",
  "status": "delivered"
}

---

Error States

HTTP Code	Error Key	Description
404	envelope_not_found	Envelope not registered or invalid ID
409	already_delivered	Envelope delivery has already been confirmed

---

Integration Notes

• This is the final required step for high-value play fulfillment.
• Data is logged to the envelope custody ledger.
• If webhook confirmation is configured, it is triggered at this step.
• Courier ID may be inferred from the bearer token or included in the payload (optional).

---

Compliance Notes

• Delivery events are timestamped and immutable.
• This endpoint should be invoked within a geofenced delivery zone (e.g., claim center).
• All delivery confirmations are audit-accessible via admin tools.