Skip to main content

DisputeResolve

Step 2: Resolve dispute​

After carful review of the dispute, by WePay administration team, the dispute will be resolved in favor of either the buyer or the seller.

The resolution may include a refund to the buyer, a chargeback to the seller, or other actions as deemed appropriate by WePay.

Once the dispute is resolved, the status of the contract will be updated accordingly, and a resolve-dispute webhook will be sent to inform third party system. Another webhook will be sent to inform the third party about the contract status update. A third webhook may be sent according to the resolution, either a refund or a chargeback webhook will be sent to inform third party system.

Example Response​

Dispute Resolved Webhook

{
  "id": "71d4028e-7f4b-46b5-809d-3e4d8184ab82",
  "event": "dispute.resolved",
  "createdAt": "2026-07-13T14:46:52.3197379Z",
  "data": {
    "contractId": "CNT-01KXDYKNZBYQXZA8GE7C55FC7S",
    "milestoneId": "MST-01KXDYKNWWFTYZYDXBZ4819DS5",
    "disputeId": "DSP-01KXDYKNZBYQXZA8GE7C55FC7S",
    "disputeDecision": "FullRefund",
    "reference": "TEST-001",
    "currency": "SAR",
    "timestamp": "2026-07-13T14:46:52.3197378Z",
    "metadata": {
      "reference": "TEST-001"
    }
  }
}

Contract/Milestone Status Update Webhook

{
  "id": "9f007a8e-8d30-472b-9b9c-38e42fd3244e",
  "event": "milestone.disput.resolved",
  "createdAt": "2026-07-13T14:46:52.2042894Z",
  "data": {
    "contractId": "CNT-01KXDYKNZBYQXZA8GE7C55FC7S",
    "milestoneId": "MST-01KXDYKNWWFTYZYDXBZ4819DS5",
    "disputeId": "3",
    "disputeDecision": "FullRefund",
    "reference": "TEST-001",
    "status": "Refunded",
    "previousStatus": "Escrow",
    "contractStatus": "Approved",
    "contractPreviousStatus": "Dispute",
    "amount": 0,
    "currency": "SAR",
    "transactionReference": "trans_01KXDYNCAGBT2MQSKAXAAV86NQ",
    "timestamp": "2026-07-13T14:46:52.2041761Z",
    "metadata": {
      "reference": "TEST-001"
    }
  }
}

Full Refund Webhook

{
  "id": "8e8c6968-8d50-408b-b573-4d0eecbe406a",
  "event": "milestone.refund.full-initiated",
  "createdAt": "2026-07-13T14:46:52.4325303Z",
  "data": {
    "contractId": "CNT-01KXDYKNZBYQXZA8GE7C55FC7S",
    "milestoneId": "MST-01KXDYKNWWFTYZYDXBZ4819DS5",
    "status": "Refunded",
    "previousStatus": "Escrow",
    "contractStatus": "Approved",
    "contractPreviousStatus": "Dispute",
    "amount": 1000,
    "currency": "SAR",
    "transactionId": "3",
    "timestamp": "2026-07-13T14:46:52.4325299Z",
    "metadata": {
      "milestoneId": "MST-01KXDYKNWWFTYZYDXBZ4819DS5"
    }
  }
}