Deliver Escrow

• Standard mode: Escrow moves to delivered. The buyer can then complete to release funds (or they may have already released from paid).
• Quick mode: Same as standard — escrow moves to delivered and the buyer can complete from paid or delivered. Quick Escrow with Proof blocks early release from paid until purchase proof is accepted.
• Instant mode: Calling deliver auto-completes the escrow and releases funds to you immediately. The escrow moves directly from paid to completed; there is no buyer confirmation step. The response message will indicate that the escrow was delivered and completed (instant mode).

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",
    "completionDeadline": "2024-01-27T14:00:00Z",
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-20T14:00:00Z"
  }
}

{
  "message": "Escrow delivered and completed (instant mode). Funds released.",
  "escrow": { "id": "...", "status": "completed", "deliveredAt": "...", "completedAt": "...", ... }
}

​

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"
}