Resolve Dispute
Resolves escrow disputes by distributing funds to the approver and service provider as determined by the dispute resolver.
Headers
Name
Value
Content-Type
application/json
Authorization
Bearer <token>
Open API
post
Body
contractIdstringRequiredExample:
ID (address) that identifies the escrow contract
CAZ6UQX7...
disputeResolverstringRequiredExample:
Address of the user defined to resolve disputes in an escrow
GDISPUTE...XYZ
approverFundsnumberRequiredExample:
Amount to transfer to the approver for dispute resolution
300
receiverFundsnumberRequiredExample:
Amount to transfer to the receiver for dispute resolution
700
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.
application/json
400
Bad request
401
Unauthorized access
429
Too Many Requests
500
Possible errors:
- Only the dispute resolver can execute this function
- Escrow not in dispute
- Insufficient approver funds for commissions
- Insufficient Service Provider funds for commissions
- An unexpected error occurred
application/json
post
POST /escrow/single-release/resolve-dispute HTTP/1.1
Host:
Content-Type: application/json
Accept: */*
Content-Length: 109
{
"contractId": "CAZ6UQX7...",
"disputeResolver": "GAPPROVER1234567890...",
"approverFunds": 20,
"receiverFunds": 30
}
{
"status": "SUCCESS",
"unsignedTransaction": "AAAAAgAAAAAtWsgedQ...."
}
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/single-release/resolve-dispute",
{
// 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;
}
Last updated
Was this helpful?