Update Escrow

curl -X PUT https://dhmad.tn/api/v1/escrows/507f1f77bcf86cd799439011 \
  -H "Authorization: Bearer sk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Updated Web Development Service",
    "amount": 1500.00,
    "description": "Full-stack website with admin panel",
    "feeBearer": "buyer"
  }'

const response = await fetch('https://dhmad.tn/api/v1/escrows/507f1f77bcf86cd799439011', {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer sk_live_your_api_key_here',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    title: 'Updated Web Development Service',
    amount: 1500.00,
    description: 'Full-stack website with admin panel',
    feeBearer: 'buyer'
  })
});

const data = await response.json();

{
  "message": "Escrow updated successfully",
  "escrow": {
    "id": "507f1f77bcf86cd799439011",
    "title": "Updated Web Development Service",
    "amount": 1500.00,
    "escrowFee": 75.00,
    "feeBearer": "buyer",
    "buyerFundingTnd": 1575.00,
    "status": "pending",
    "description": "Full-stack website with admin panel",
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T11:30:00Z"
  }
}

Update a pending escrow transaction. Only escrows in pending status can be updated. You can modify the title, amount, description, feeBearer, and other pending fields. At least one field must be provided in the request body. The escrow fee is recalculated automatically when the amount is updated. Changing feeBearer, amount, or currency clears existing contract signatures.

curl -X PUT https://dhmad.tn/api/v1/escrows/507f1f77bcf86cd799439011 \
  -H "Authorization: Bearer sk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Updated Web Development Service",
    "amount": 1500.00,
    "description": "Full-stack website with admin panel",
    "feeBearer": "buyer"
  }'

const response = await fetch('https://dhmad.tn/api/v1/escrows/507f1f77bcf86cd799439011', {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer sk_live_your_api_key_here',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    title: 'Updated Web Development Service',
    amount: 1500.00,
    description: 'Full-stack website with admin panel',
    feeBearer: 'buyer'
  })
});

const data = await response.json();

{
  "message": "Escrow updated successfully",
  "escrow": {
    "id": "507f1f77bcf86cd799439011",
    "title": "Updated Web Development Service",
    "amount": 1500.00,
    "escrowFee": 75.00,
    "feeBearer": "buyer",
    "buyerFundingTnd": 1575.00,
    "status": "pending",
    "description": "Full-stack website with admin panel",
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T11:30:00Z"
  }
}

Path Parameters

string

required

Escrow ID

Request Body

All fields are optional, but at least one must be provided.

string

Updated title for the escrow

number

Updated transaction amount in TND (must be greater than 0). Escrow fee is recalculated automatically.

string

Updated description (max 2000 characters)

string

Who pays platform + developer fees: "seller" or "buyer". Changing this (or amount/currency) clears existing contract signatures. Not allowed for instant escrows after creation.

number

Legacy optional delivery estimate (must be at least 1 if provided). Not used by platform enforcement; omit for new integrations.

Response Fields

Error Responses

400 Bad Request

Escrow Not Pending

{
  "error": "Bad Request",
  "message": "Can only update escrows in pending status"
}

No Valid Fields

{
  "error": "Bad Request",
  "message": "No valid fields to update"
}

401 Unauthorized

{
  "error": "Unauthorized"
}

403 Forbidden

{
  "error": "Forbidden",
  "message": "Developer account must be associated with a user account. Please associate your account in the developer dashboard."
}

404 Not Found

{
  "error": "Escrow not found"
}

Only escrows in pending status can be updated. Once the buyer has paid, the escrow moves to paid status and can no longer be updated via this endpoint.

Get Started

API Reference

Guides

Developer Portal

Path Parameters

Request Body

Response Fields

Error Responses

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

​Path Parameters

​Request Body

​Response Fields

​Error Responses

​400 Bad Request

​401 Unauthorized

​403 Forbidden

​404 Not Found

Path Parameters

Request Body

Response Fields

Error Responses

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found