Reverse provisional credit

  • transactionUuid (string) — The transaction to debit.
  • amount.amountInCents (number) — Amount still to reverse, in minor units.
  • amount.currency (string) — ISO 4217 code.

Sent when a transaction closes denied or cancelled and a provisional credit is still outstanding. The amount is what was credited, less anything the merchant already refunded. The entry clears once the reversal is recorded.

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_CLOSED",
      "transactions": [
        {
          "uuid": "txn-1",
          "settledTimestamp": "1783641600",
          "amount": {
            "amountInCents": 4500,
            "currency": "USD"
          },
          "merchant": "Acme Online Store",
          "status": "DISPUTED_TRANSACTION_STATUS_CLOSED",
          "auditLog": [
            {
              "timestamp": "1784721600",
              "eventType": "TRANSACTION_EVENT_TYPE_ISSUE_PROVISIONAL_CREDIT",
              "agentEmail": "sam.rivera@example.com",
              "issueProvisionalCredit": {
                "amount": {
                  "amountInCents": 4500,
                  "currency": "USD"
                },
                "actions": [
                  "ACTION_ISSUE_PROVISIONAL_CREDIT"
                ]
              }
            },
            {
              "timestamp": "1785585600",
              "eventType": "TRANSACTION_EVENT_TYPE_RECORD_FINAL_DECISION",
              "agentEmail": "sam.rivera@example.com",
              "recordFinalDecision": {
                "type": "RECORD_FINAL_DECISION_TYPE_DENIED",
                "denied": {
                  "type": "DENIED_TYPE_INSUFFICIENT_EVIDENCE"
                }
              }
            }
          ],
          "transactionStatus": "TRANSACTION_STATUS_SETTLED",
          "provisionalCreditAmount": {
            "amountInCents": 4500,
            "currency": "USD"
          },
          "transactionFinalStatus": "RECORD_FINAL_DECISION_TYPE_DENIED"
        }
      ],
      "shortId": "D-2001",
      "reason": "DISPUTE_REASON_MERCHANT_ISSUE",
      "actions": [
        "ACTION_ISSUE_PROVISIONAL_CREDIT"
      ],
      "disputeReason": {
        "reason": "DISPUTE_REASON_MERCHANT_ISSUE",
        "displayMessage": "Merchant Issue"
      }
    },
    "statusMessage": "Your dispute has been resolved.",
    "timeline": [
      {
        "eventType": "TIMELINE_EVENT_TYPE_FINAL_DECISION",
        "message": "Dispute resolved",
        "timestamp": "1785585600",
        "transactions": [
          {
            "uuid": "txn-1",
            "merchant": "Acme Online Store",
            "amount": {
              "amountInCents": 4500,
              "currency": "USD"
            },
            "settledTimestamp": "1783641600"
          }
        ]
      },
      {
        "eventType": "TIMELINE_EVENT_TYPE_PROVISIONAL_CREDIT",
        "message": "Provisional credit issued",
        "subMessage": "$45.00",
        "timestamp": "1784721600",
        "transactions": [
          {
            "uuid": "txn-1",
            "merchant": "Acme Online Store",
            "amount": {
              "amountInCents": 4500,
              "currency": "USD"
            },
            "settledTimestamp": "1783641600"
          }
        ]
      },
      {
        "eventType": "TIMELINE_EVENT_TYPE_CREATED",
        "message": "Dispute created",
        "timestamp": "1783728000"
      }
    ],
    "requiredActions": [
      {
        "type": "REQUIRED_ACTION_TYPE_REVERSE_PROVISIONAL_CREDIT",
        "reverseProvisionalCredit": {
          "transactionUuid": "txn-1",
          "amount": {
            "amountInCents": 4500,
            "currency": "USD"
          }
        }
      }
    ]
  }
}