Skip to main content

contracts_accept_cancel

Accepts a pending cancellation request for an escrow contract, closing it and returning the payment and both pledges to their owners.

This call is made by side B (normally the seller), the party that received the cancellation request. It adds side B's signature to the cancellation template prepared by side A and broadcasts it, moving the contract to state 6 (contract released cancelled). The contract must be in state 5 (cancel proposal sent), otherwise the call fails; the request must also still be within its cancel_expiration_time.

Request​

{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "contracts_accept_cancel",
  "params": {
    "contract_id": "b6f2c3d18e47a05b9c2d4e6f81a30b57cd94e2f16a8b0c37d5e19f4a2b6c08d3"
  }
}

Request parameters​

  • contract_id - string; hex-encoded identifier of the contract whose cancellation is being accepted, as reported by contracts_get_all.

No fee is passed here: the cancellation transaction was fully prepared and funded by side A when it called contracts_request_cancel, and this call only completes its multisig signature.

Response​

{
  "id": 0,
  "jsonrpc": "2.0",
  "result": {}
}

Response information​

The result object is empty. A successful call means the cancellation transaction became fully signed and was broadcast; failures are reported as a JSON-RPC error. Once confirmed, side A gets back to_pay and its pledge, side B gets back its pledge, and contracts_get_all reports the contract in state 6 (contract released cancelled).