Replace card

  • transactionUuids (array of string) - Every disputed transaction made on the card to replace.

Sent only on a dispute whose reason is an unauthorised charge. It names no single transaction because the card covers all of them, and it clears once the replacement 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_OPEN",
      "reason": "DISPUTE_REASON_UNAUTH",
      "transactions": [
        { "uuid": "txn-1", "merchant": "Acme Online Store", "amount": { "amountInCents": 4500, "currency": "USD" }, "status": "DISPUTED_TRANSACTION_STATUS_INVESTIGATING" },
        { "uuid": "txn-2", "merchant": "Northwind Books", "amount": { "amountInCents": 8999, "currency": "USD" }, "status": "DISPUTED_TRANSACTION_STATUS_INVESTIGATING" }
      ]
    },
    "requiredActions": [
      {
        "type": "REQUIRED_ACTION_TYPE_REPLACE_CARD",
        "replaceCard": { "transactionUuids": ["txn-1", "txn-2"] }
      }
    ]
  }
}