Skip to content
StartupBuilder
by startups.studio
by Startups.Studio
Business
Changelog
Events

Dispute.opened

A card issuer opened a Dispute against a charge, and the rail holds the disputed amount.

PropertyValue
Raised byNo Verb: the rail raises it
NounDispute
MovesCustomer activated to atRisk when the disputed charge is this Customer’s
WakesAnswer a chargeback

Payload

Each delivery is an Event record. data holds the Dispute as it stands.

FieldTypeRequiredDescription
namestringrequiredDispute.opened.
atdatetimerequiredWhen it happened.
seqintegerIts position in the namespace, one more than the Event before; any seq is a cursor into the history.
datajsonrequiredThe Thing as the Action left it.
data.disputeDisputerequiredThe Dispute as the change left it.
data.dispute.kindstringrequiredOne of chargeback, outcome, or marketplace.
data.dispute.statusstringrequiredOne of open, answered, decided, appealed, or closed.
data.dispute.heldmoneyrequiredThe amount held from the seller until the Dispute closes.
data.dispute.reasontextrequiredWhat the buyer says fell short, in their words.
data.dispute.answerBydatetimeWhen the seller’s answer is due; a missed deadline decides for the buyer.
data.dispute.decisionstringOne of buyer, seller, or split, with the amounts each side keeps.
data.dispute.decidedBystringrequiredissuer (the cardholder’s bank) for a chargeback; worker, uninvolved in the Order, for an outcome or marketplace Dispute.
data.dispute.feemoneyThe card network’s fee on a chargeback, debited with the held amount when it opens.
data.transactionTransactionrequiredThe disputed charge.

Example

JSON
{
  "$id": "https://api.sb/leaseline.app/events/evt_SjZqiLxHV9",
  "$type": "Event",
  "name": "Dispute.opened",
  "at": "2026-10-22T12:00:00Z",
  "data": {
    "dispute": {
      "$id": "https://api.sb/leaseline.app/disputes/dp_gywlshZJ7A",
      "$type": "Dispute",
      "kind": "chargeback",
      "status": "open",
      "held": {
        "amount": 29,
        "currency": "USD"
      },
      "reason": "Example reason",
      "answerBy": "2026-10-22T12:00:00Z",
      "decision": "buyer",
      "decidedBy": "issuer",
      "fee": {
        "amount": 29,
        "currency": "USD"
      }
    },
    "transaction": {
      "$id": "https://api.sb/leaseline.app/transactions/txn_XoxtZe3CQI",
      "$type": "Transaction",
      "kind": "charge",
      "amount": {
        "amount": 29,
        "currency": "USD"
      }
    }
  },
  "seq": 1722
}