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",
      "status": "DISPUTE_STATUS_CLOSED",
      "transactions": [
        {
          "uuid": "txn-1",
          "merchant": "Acme Online Store",
          "amount": { "amountInCents": 4500, "currency": "USD" },
          "status": "DISPUTED_TRANSACTION_STATUS_CLOSED",
          "transactionFinalStatus": "RECORD_FINAL_DECISION_TYPE_DENIED",
          "provisionalCreditAmount": { "amountInCents": 4500, "currency": "USD" }
        }
      ]
    },
    "requiredActions": [
      {
        "type": "REQUIRED_ACTION_TYPE_REVERSE_PROVISIONAL_CREDIT",
        "reverseProvisionalCredit": {
          "transactionUuid": "txn-1",
          "amount": { "amountInCents": 4500, "currency": "USD" }
        }
      }
    ]
  }
}