Notification keys
NOTIFICATION_KEY_DISPUTE_RECEIVED— The dispute has been received and is on record. Names a transaction: No.NOTIFICATION_KEY_INVESTIGATION_STARTED— The dispute is being looked into, for the first time or again after being reopened. Names a transaction: No.NOTIFICATION_KEY_MORE_INFO_REQUESTED— Information has been requested from the member. Names a transaction: Yes.NOTIFICATION_KEY_PROVISIONAL_CREDIT_ISSUED— A provisional credit has been issued. Names a transaction: Yes.NOTIFICATION_KEY_MERCHANT_CONTACTED— The merchant has been contacted about the transaction. Names a transaction: Usually.NOTIFICATION_KEY_CHARGEBACK_FILED— A chargeback has been filed with the card network. Names a transaction: Yes.NOTIFICATION_KEY_FINAL_DECISION_APPROVED— The dispute was resolved in the member's favour. Names a transaction: Yes.NOTIFICATION_KEY_FINAL_DECISION_DENIED— The dispute was denied. Names a transaction: Yes.NOTIFICATION_KEY_FINAL_DECISION_CANCELLED— The dispute was cancelled. Names a transaction: Yes.
Dispute received and investigation started are about the dispute as a whole, so they carry no transactionUuid. Merchant contacted carries one when the contact was about a single charge, and none when it was about the dispute.
Information requested
The notification rides in the same message that records the request.
{
"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",
"auditLog": [
{
"timestamp": "1785412800",
"eventType": "TRANSACTION_EVENT_TYPE_REQUEST_MORE_INFO",
"agentEmail": "sam.rivera@example.com"
}
],
"transactionStatus": "TRANSACTION_STATUS_SETTLED",
"requiredActions": [
"REQUIRED_ACTION_PROVIDE_MORE_INFO"
]
}
],
"shortId": "D-1042",
"reason": "DISPUTE_REASON_MERCHANT_ISSUE",
"disputeReason": {
"reason": "DISPUTE_REASON_MERCHANT_ISSUE",
"displayMessage": "Merchant Issue"
}
},
"statusMessage": "Your dispute is under review.",
"timeline": [
{
"eventType": "TIMELINE_EVENT_TYPE_INFORMATION_REQUESTED",
"message": "We requested more information from you",
"timestamp": "1785412800",
"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_COLLECT_CUSTOMER_INFORMATION",
"collectCustomerInformation": {
"transactionUuid": "txn-1",
"requestedItemKey": "PoliceReport",
"deadlineTimestamp": "1759708800"
}
},
{
"type": "REQUIRED_ACTION_TYPE_NOTIFY_CUSTOMER",
"notifyCustomer": {
"key": "NOTIFICATION_KEY_MORE_INFO_REQUESTED",
"transactionUuid": "txn-1",
"effectiveTimestamp": "1759190400",
"extraParams": {
"requestedItemKey": "PoliceReport"
},
"informationRequest": {
"requestedItemKey": "PoliceReport",
"deadlineTimestamp": "1759708800"
}
}
}
]
}
}
Provisional credit issued
The credit has been issued, so no credit entry remains. Only the notification is left.
{
"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",
"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"
]
}
}
],
"transactionStatus": "TRANSACTION_STATUS_SETTLED",
"provisionalCreditAmount": {
"amountInCents": 4500,
"currency": "USD"
}
}
],
"shortId": "D-1042",
"reason": "DISPUTE_REASON_MERCHANT_ISSUE",
"actions": [
"ACTION_ISSUE_PROVISIONAL_CREDIT"
],
"disputeReason": {
"reason": "DISPUTE_REASON_MERCHANT_ISSUE",
"displayMessage": "Merchant Issue"
}
},
"statusMessage": "Your dispute is under review.",
"timeline": [
{
"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_NOTIFY_CUSTOMER",
"notifyCustomer": {
"key": "NOTIFICATION_KEY_PROVISIONAL_CREDIT_ISSUED",
"transactionUuid": "txn-1",
"amount": {
"amountInCents": 4500,
"currency": "USD"
},
"effectiveTimestamp": "1759190400"
}
}
]
}
}
About the dispute as a whole
Dispute received and investigation started carry no transactionUuid.
{
"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"
}
],
"shortId": "D-1042",
"reason": "DISPUTE_REASON_MERCHANT_ISSUE",
"disputeReason": {
"reason": "DISPUTE_REASON_MERCHANT_ISSUE",
"displayMessage": "Merchant Issue"
}
},
"statusMessage": "Your dispute is under review.",
"timeline": [
{
"eventType": "TIMELINE_EVENT_TYPE_CREATED",
"message": "Dispute created",
"timestamp": "1783728000"
}
],
"requiredActions": [
{
"type": "REQUIRED_ACTION_TYPE_ISSUE_PROVISIONAL_CREDIT",
"issueProvisionalCredit": {
"transactionUuid": "txn-1",
"amount": {
"amountInCents": 4500,
"currency": "USD"
},
"deadlineTimestamp": "1759276800"
}
},
{
"type": "REQUIRED_ACTION_TYPE_NOTIFY_CUSTOMER",
"notifyCustomer": {
"key": "NOTIFICATION_KEY_DISPUTE_RECEIVED",
"effectiveTimestamp": "1759190400"
}
}
]
}
}
Final decision denied
The reversal entry and the notification arrive together.
{
"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"
}
}
},
{
"type": "REQUIRED_ACTION_TYPE_NOTIFY_CUSTOMER",
"notifyCustomer": {
"key": "NOTIFICATION_KEY_FINAL_DECISION_DENIED",
"transactionUuid": "txn-1",
"effectiveTimestamp": "1759190400",
"finalDecision": {
"reasonKey": "merchantIssues",
"subReasonKey": "merchandiseDelivered",
"provisionalCreditIssued": true,
"provisionalCreditReversal": {
"timing": "REVERSAL_TIMING_IMMEDIATE",
"reversalTimestamp": "1785585600",
"amount": {
"amountInCents": 4500,
"currency": "USD"
}
}
}
}
}
]
}
}
Final decision approved
The amount on the notification is what the member is actually getting. An agent who approved for less than the disputed total set that figure on the decision, and it is the one quoted here.
{
"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": "1785585600",
"eventType": "TRANSACTION_EVENT_TYPE_RECORD_FINAL_DECISION",
"agentEmail": "sam.rivera@example.com",
"recordFinalDecision": {
"type": "RECORD_FINAL_DECISION_TYPE_ACCEPTED",
"actions": [
"ACTION_ISSUE_FINAL_CREDIT"
],
"accepted": {
"type": "ACCEPTED_TYPE_GENERAL_APPROVE"
}
}
}
],
"transactionStatus": "TRANSACTION_STATUS_SETTLED",
"finalCreditAmount": {
"amountInCents": 4500,
"currency": "USD"
},
"transactionFinalStatus": "RECORD_FINAL_DECISION_TYPE_ACCEPTED"
}
],
"shortId": "D-2001",
"reason": "DISPUTE_REASON_MERCHANT_ISSUE",
"actions": [
"ACTION_ISSUE_FINAL_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 in your favor",
"timestamp": "1785585600",
"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_ISSUE_FINAL_CREDIT",
"issueFinalCredit": {
"transactionUuid": "txn-1",
"amount": {
"amountInCents": 4500,
"currency": "USD"
}
}
},
{
"type": "REQUIRED_ACTION_TYPE_NOTIFY_CUSTOMER",
"notifyCustomer": {
"key": "NOTIFICATION_KEY_FINAL_DECISION_APPROVED",
"transactionUuid": "txn-1",
"amount": {
"amountInCents": 4500,
"currency": "USD"
},
"effectiveTimestamp": "1759190400",
"finalDecision": {
"reasonKey": "chargebackWon",
"provisionalCreditIssued": false
}
}
}
]
}
}
Cancelled uses the same shape as denied, with NOTIFICATION_KEY_FINAL_DECISION_CANCELLED.