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. A dispute raised for any other reason never carries this entry, however the card was used. 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",
"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"
},
{
"uuid": "txn-2",
"settledTimestamp": "1783641600",
"amount": {
"amountInCents": 8999,
"currency": "USD"
},
"merchant": "Northwind Books",
"status": "DISPUTED_TRANSACTION_STATUS_INVESTIGATING",
"transactionStatus": "TRANSACTION_STATUS_SETTLED"
}
],
"shortId": "D-1042",
"reason": "DISPUTE_REASON_UNAUTH",
"actions": [
"ACTION_REPLACE_CARD"
],
"disputeReason": {
"reason": "DISPUTE_REASON_UNAUTH",
"displayMessage": "Unauth"
}
},
"statusMessage": "Your dispute is under review.",
"timeline": [
{
"eventType": "TIMELINE_EVENT_TYPE_CREATED",
"message": "Dispute created",
"timestamp": "1783728000"
}
],
"requiredActions": [
{
"type": "REQUIRED_ACTION_TYPE_REPLACE_CARD",
"replaceCard": {
"transactionUuids": [
"txn-1",
"txn-2"
]
}
}
]
}
}