Refund Remaining Funds

Returns funds after cancelling escrow.

POST escrow/refund-remaining-funds

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.
signer	string | Address	The address authorized to approve the release of funds.
contractId	string	The unique identifier of the contract.

Example of Request Body:

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

Possible Responses

200 OK

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

500 Server Error

Only Signer

{
  "error": "Only the signer can request a refund"
}

Not Canceled

{
  "error": "The escrow must be cancelled to refund the amounts"
}

Not Found

{
  "error": "Escrow not found"
}

No Balance

{
  "error": "The contract has no balance to repay"
}

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.