Deliver Escrow

• Escrow moves to delivered.
• completionDeadline is set from the frozen window. Classic path: completionDeadlineDays (default 7, range 3–14). Delivery confirmation: deliveredAt + buyerReviewDeadlineHours (exact hours). The buyer must release funds, reject delivery, or open a dispute before that deadline. Silence auto-completes the escrow and releases funds.
• Quick Escrow with Proof blocks deliver and early release from paid until purchase proof is accepted (409 PROOF_NOT_ACCEPTED).
• Progressive-release escrows cannot be delivered (409 PROGRESSIVE_DELIVER_NOT_ALLOWED).
• A charge id returns 409 CHARGE_NOT_AN_ESCROW. Charges complete on payment and have no deliver step.

curl -X POST https://dhmad.tn/api/v1/escrows/507f1f77bcf86cd799439011/deliver \
  -H "Authorization: Bearer sk_live_your_api_key_here" \
  -H "Content-Type: application/json"

const response = await fetch('https://dhmad.tn/api/v1/escrows/507f1f77bcf86cd799439011/deliver', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_live_your_api_key_here',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();

{
  "message": "Escrow marked as delivered",
  "escrow": {
    "id": "507f1f77bcf86cd799439011",
    "title": "Web Development Service",
    "amount": 1000.00,
    "status": "delivered",
    "deliveredAt": "2024-01-20T14:00:00Z",
    "completionDeadlineDays": 10,
    "completionDeadline": "2024-01-30T14:00:00Z",
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-20T14:00:00Z"
  }
}

​

Path Parameters

​

Response Fields

​

Error Responses

​

400 Bad Request

{
  "error": "Bad Request",
  "message": "Escrow must be in paid status before delivery"
}

​

401 Unauthorized

{
  "error": "Unauthorized"
}

​

403 Forbidden

{
  "error": "Forbidden",
  "message": "Only the seller can mark an escrow as delivered"
}

​

404 Not Found

{
  "error": "Escrow not found"
}

​

409 Conflict