Distribute Escrow Earnings

You release the escrow funds to the service provider through the approver.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Open API

post

Body

contractIdstringRequired

ID (address) that identifies the escrow contract

Example: CAZ6UQX7...

releaseSignerstringRequired

Address of the user in charge of releasing the escrow funds to the service provider

Example: GREL...XYZ

Responses

201

This endpoint returns an unsigned transaction in XDR format. This XDR is then used to sign the transaction using the “/helper/send-transaction” endpoint.

400

Bad request

401

Unauthorized access

429

Too Many Requests

500

Possible errors:

• { status: "FAILED", message: "The escrow balance must be equal to the amount of earnings defined for the escrow" }
• { status: "FAILED", message: "Escrow has been opened for dispute resolution" }
• { status: "FAILED", message: "The escrow must be completed to distribute earnings" }
• { status: "FAILED", message: "Escrow initialized without milestone" }
• { status: "FAILED", message: "Only the release signer can claim escrow earnings" }
• { status: "FAILED", message: "Escrow not found" }
• { status: "500", message: "An unexpected error occurred" }

post

HTTPcURLJavaScriptPython

POST /escrow/distribute-escrow-earnings HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 69

{
  "contractId": "CAZ6UQX7...",
  "releaseSigner": "GAPPROVER1234567890..."
}

No content

What this Endpoint returns?

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

Use Example:

import axios from "axios";

const http = axios.create({
  baseURL: "https://dev.api.trustlesswork.com",
  timeout: 10000,
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer your_api_key`,
  },
});

export const useExample = async () => {
    // Get the signer address
    const { address } = await kit.getAddress();

    const response = await http.post(
      "/escrow/distribute-escrow-earnings",
      {
        // body requested for the endpoint
      },
    ); 
    
    // Get the unsigned transaction hash
    const { unsignedTransaction } = response.data;

    // Sign the transaction by wallet
    const { signedTxXdr } = await signTransaction(unsignedTransaction, {
      address,
      networkPassphrase: WalletNetwork.TESTNET,
    });

    // Send the transaction to Stellar Network
    const tx = await http.post("/helper/send-transaction", {
      signedXdr: signedTxXdr,
    });

    const { data } = tx;

    return data;
}