Fund Escrow

Allows users to deposit funds into an existing escrow contract, securing them until the agreed conditions are met.

POST escrow/fund-escrow

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
engagementId	string	The unique identifier linking this escrow to a specific project or transaction.
contractId	string	The unique identifier of the contract.
signer	string | Address	The address authorized to approve the release of funds.

Example of Request Body:

{
  "engagementId": "test",
  "contractId": "GD2SVFOJ...",
  "signer": "SCMXDC..."
}

Possible Responses

201 Created

{
    "status": "SUCCESS",
    "unsignedTransaction": "AAAAAgAAAABfQAm/gS..."  // XDR Hash Transaction
}

500 Server Error

Only Signer

{
  "error": "Only the signer can fund the escrow"
}

Already Funded

{
  "error": "Escrow already funded"
}

Fully Funded

{
  "error": "This escrow is already fully funded"
}

Insufficient Founds

{
  "error": "The signer does not have sufficient funds"
}

Not Found

{
  "error": "Escrow not found"
}

Not Enough Allowance

{
  "error": "Not enough allowance to fund this escrow"
}

400 Bad Request

{
    "message": "Message",
    "error": "Bad Request",
    "statusCode": 400
}

429 Rate Limit

{
    "statusCode": 429,
    "message": "ThrottlerException: Too Many Requests"
}

What this Endpoint returns?

This endpoint returns the transaction unsigned so that the transaction can be signed by means of a customer wallet.