Reason codes

To provide a consistent and unified experience for merchants, dispute reason codes are standardized across all integrated payment providers.

Authorization & Authentication Disputes

Dispute CodeReason DescriptionCommon Scenarios
PDSP_AUTH_001Payment not authorized by cardholder"I never approved this charge"
"Someone else used my card"
"I don't recognize this merchant"
PDSP_AUTH_002Fraudulent payment
Card Not Present
"I didn't make this online purchase"
"My card was used without my knowledge"
"Someone hacked my account"
PDSP_AUTH_003Fraudulent payment
Card Present
"I wasn't at that store"
"My card was stolen and used"
"I was in a different city that day"
PDSP_AUTH_004Card/account stolen or lost"My wallet was stolen"
"I lost my card last week"
"Card was used after I reported it lost"

Product & Service Issues

Dispute CodeReason DescriptionCommon Scenarios
PDSP_PROD_001Product not received"My order never arrived"
"Tracking shows not delivered"
"Package was lost in transit"
PDSP_PROD_002Product significantly different"This isn't what I ordered"
"Color/size/model is wrong"
"Features don't match listing"
PDSP_PROD_003Product defective or damaged"Item arrived broken"
"Product doesn't work"
"Damaged in shipping"
PDSP_PROD_004Service not provided"Service appointment was missed"
"Work was never completed"
"Subscription access denied"
PDSP_PROD_005Partial shipment"Missing items from my order"
"Only received 2 of 5 items"
"Rest of order never came"

Cancellation & Refund Issues

Dispute CodeReason DescriptionCommon Scenarios
PDSP_CANC_001Cancelled recurring transaction"I cancelled my subscription"
"Charged after cancellation"
"Unwanted auto-renewal"
PDSP_CANC_002Refund not processed"Promised refund never came"
"Still waiting for my money back"
"Refund confirmed but not received"
PDSP_CANC_003Cancelled order"I cancelled within the window"
"Order cancelled before shipping"
"Changed my mind immediately"
PDSP_CANC_004Return merchandise authorization"I sent the item back"
"Return was delivered to seller"
"Following your return process"

Subscription & Recurring Payment Issues

Dispute CodeReason DescriptionCommon Scenarios
PDSP_SUBS_001Unwanted recurring charge"I didn't know it would recur"
"Thought it was one-time"
"Never agreed to subscription"
PDSP_SUBS_002Subscription terms violation"Price increased without notice"
"Terms changed mid-contract"
"Features removed from plan"
PDSP_SUBS_003Trial period abuse"Charged during free trial"
"Trial ended too early"
"Didn't know trial was ending"
PDSP_SUBS_004Subscription modification dispute"Didn't approve plan upgrade"
"Downgrade not processed"
"Wrong subscription tier charged"

General & Miscellaneous

Dispute CodeReason DescriptionCommon Scenarios
PDSP_GEN_001General dispute"Problem with transaction"
"Issue needs resolution"
"Dispute this charge"
PDSP_GEN_002Consumer inquiry"Just asking about this charge"
"Need more information"
"Don't understand this transaction"
PDSP_GEN_003Credit not processed"Promised credit not received"
"Adjustment never applied"
"Still waiting for credit"