Issue provisional credit

transactionUuid (string) — The transaction to credit.
amount.amountInCents (number) — Amount owed, in minor units.
amount.currency (string) — ISO 4217 code, for example CAD.
deadlineTimestamp (string) — Unix seconds. When the credit is due.

The amount is the disputed amount less any credit already issued and any merchant credit received. When a partial credit has been issued, the entry stays and the amount shows the remainder.

The entry only appears once credit is actually owed. Three conditions have to hold: the regulation covering the transaction has to require a credit, credit must not be locked on the dispute, and your grace period for issuing it has to have passed. A newly opened dispute showing no credit entry is normal.

Example

{
  "type": "dispute.updated",
  "disputeUuid": "3f8e2c1a-9b47-4d6e-a1f0-7c2d5b8e4a91",
  "occurredAt": "2026-08-03T12:00:00Z",
  "data": {
    "dispute": {
      "uuid": "3f8e2c1a-9b47-4d6e-a1f0-7c2d5b8e4a91",
      "resolutionDeadline": "1788393600",
      "status": "DISPUTE_STATUS_OPEN",
      "transactions": [
        {
          "uuid": "txn-1",
          "settledTimestamp": "1783641600",
          "amount": {
            "amountInCents": 4500,
            "currency": "USD"
          },
          "merchant": "Acme Online Store",
          "status": "DISPUTED_TRANSACTION_STATUS_INVESTIGATING",
          "transactionStatus": "TRANSACTION_STATUS_SETTLED"
        }
      ],
      "shortId": "D-1042",
      "reason": "DISPUTE_REASON_MERCHANT_ISSUE",
      "disputeReason": {
        "reason": "DISPUTE_REASON_MERCHANT_ISSUE",
        "displayMessage": "Merchant Issue"
      }
    },
    "statusMessage": "Your dispute is under review.",
    "timeline": [
      {
        "eventType": "TIMELINE_EVENT_TYPE_CREATED",
        "message": "Dispute created",
        "timestamp": "1783728000"
      }
    ],
    "requiredActions": [
      {
        "type": "REQUIRED_ACTION_TYPE_ISSUE_PROVISIONAL_CREDIT",
        "issueProvisionalCredit": {
          "transactionUuid": "txn-1",
          "amount": {
            "amountInCents": 4500,
            "currency": "USD"
          },
          "deadlineTimestamp": "1759276800"
        }
      }
    ]
  }
}

Collect member information

Issue final credit