Skip to content
StartupBuilder
by startups.studio
by Startups.Studio
Code
Changelog
APILegal & trustDispute

Dispute routes: accept, answer, appeal, decide

The Dispute Verbs accept, answer, appeal, decide as api.sb routes, with inputs, result, refusals and an example.

Reference for Dispute, one group of Dispute routes.

Dispute.accept

Accept concedes an open Dispute without contest, so the buyer keeps the held amount and the Dispute closes. Verb page.

Text
POST /{namespace}/disputes/{dispute}/accept

Path: dispute. Body, as JSON: the other inputs. Emits Dispute.accepted.

Inputs

InputTypeRequiredDescription
disputeDisputerequiredThe open Dispute.
reasontextrequiredWhy contesting is not worth it, such as a fraud chargeback with no delivery Evidence.

Returns

OutputTypeRequiredDescription
disputeDisputerequiredThe closed Dispute, decided for the buyer.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
curl -X POST https://api.sb/leaseline.app/disputes/dp_gywlshZJ7A/accept \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reason":"Example reason"}'
JSON
{
  "api": "https://api.sb/leaseline.app",
  "dispute": {
    "$id": "https://api.sb/leaseline.app/disputes/dp_gywlshZJ7A",
    "$type": "Dispute",
    "kind": "chargeback",
    "status": "open",
    "held": {
      "amount": 29,
      "currency": "USD"
    },
    "reason": "Example reason"
  },
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/act_br07HsG8MG",
    "operation": "Dispute.accept",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/leaseline.app/actions/act_br07HsG8MG"
  }
}

Dispute.answer

Answer submits the seller’s Evidence on an open Dispute before its deadline: the contract, the delivered work, and its verdicts. Verb page.

Text
POST /{namespace}/disputes/{dispute}/answer

Path: dispute. Body, as JSON: the other inputs. Emits Dispute.answered.

Inputs

InputTypeRequiredDescription
disputeDisputerequiredThe open Dispute.
evidencelist of EvidencerequiredThe records that show the promise was kept.

Returns

OutputTypeRequiredDescription
disputeDisputerequiredThe answered Dispute.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
curl -X POST https://api.sb/leaseline.app/disputes/dp_gywlshZJ7A/answer \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"evidence":["evidence_6xsa6iYImd"]}'
JSON
{
  "api": "https://api.sb/leaseline.app",
  "dispute": {
    "$id": "https://api.sb/leaseline.app/disputes/dp_gywlshZJ7A",
    "$type": "Dispute",
    "kind": "chargeback",
    "status": "answered",
    "held": {
      "amount": 29,
      "currency": "USD"
    },
    "reason": "Example reason"
  },
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/act_br07HsG8MG",
    "operation": "Dispute.answer",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/leaseline.app/actions/act_br07HsG8MG"
  }
}

Dispute.appeal

Appeal asks for one review of a decided Dispute by a Worker who took no part in the first decision. Verb page.

Text
POST /{namespace}/disputes/{dispute}/appeal

Path: dispute. Body, as JSON: the other inputs. Emits Dispute.appealed.

Inputs

InputTypeRequiredDescription
disputeDisputerequiredThe decided Dispute.
reasontextrequiredWhat the first decision got wrong.

Returns

OutputTypeRequiredDescription
disputeDisputerequiredThe appealed Dispute.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
curl -X POST https://api.sb/leaseline.app/disputes/dp_gywlshZJ7A/appeal \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reason":"Example reason"}'
JSON
{
  "api": "https://api.sb/leaseline.app",
  "dispute": {
    "$id": "https://api.sb/leaseline.app/disputes/dp_gywlshZJ7A",
    "$type": "Dispute",
    "kind": "chargeback",
    "status": "appealed",
    "held": {
      "amount": 29,
      "currency": "USD"
    },
    "reason": "Example reason"
  },
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/act_br07HsG8MG",
    "operation": "Dispute.appeal",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/leaseline.app/actions/act_br07HsG8MG"
  }
}

Dispute.decide

Decide rules on an answered Dispute for the buyer, the seller, or a split, and releases or returns the held amount. Verb page.

Text
POST /{namespace}/disputes/{dispute}/decide

Path: dispute. Body, as JSON: the other inputs. Emits Dispute.decided.

Inputs

InputTypeRequiredDescription
disputeDisputerequiredThe answered Dispute.
decisionstringrequiredOne of buyer, seller, or split.
reasontextrequiredWhy, citing the Evidence and the contract term it turns on.

Returns

OutputTypeRequiredDescription
disputeDisputerequiredThe decided Dispute.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
curl -X POST https://api.sb/leaseline.app/disputes/dp_gywlshZJ7A/decide \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"decision":"buyer","reason":"Example reason"}'
JSON
{
  "api": "https://api.sb/leaseline.app",
  "dispute": {
    "$id": "https://api.sb/leaseline.app/disputes/dp_gywlshZJ7A",
    "$type": "Dispute",
    "kind": "chargeback",
    "status": "decided",
    "held": {
      "amount": 29,
      "currency": "USD"
    },
    "reason": "Example reason"
  },
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/act_br07HsG8MG",
    "operation": "Dispute.decide",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/leaseline.app/actions/act_br07HsG8MG"
  }
}

get, list

Previous

Evaluator

Next