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 appears once credit is actually owed under the regulation that covers the transaction and your organization's grace period has passed. A newly opened dispute with 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",
      "status": "DISPUTE_STATUS_OPEN",
      "transactions": [
        {
          "uuid": "txn-1",
          "merchant": "Acme Online Store",
          "amount": { "amountInCents": 4500, "currency": "USD" },
          "status": "DISPUTED_TRANSACTION_STATUS_INVESTIGATING"
        }
      ]
    },
    "requiredActions": [
      {
        "type": "REQUIRED_ACTION_TYPE_ISSUE_PROVISIONAL_CREDIT",
        "issueProvisionalCredit": {
          "transactionUuid": "txn-1",
          "amount": { "amountInCents": 4500, "currency": "USD" },
          "deadlineTimestamp": "1759276800"
        }
      }
    ]
  }
}