Reason Codes

Standardized Codes

To provide a consistent and unified experience for merchants, our platform standardizes dispute reason codes across all integrated payment providers.

Authorization & Authentication Disputes

Dispute API CodeReason DescriptionCommon Scenarios
PDSP_AUTH_001Transaction not authorized by cardholder"I never approved this charge" / "Someone else used my card" / "I don't recognize this merchant"
PDSP_AUTH_002Fraudulent transaction - Card Not Present"I didn't make this online purchase" / "My card was used without my knowledge" / "Someone hacked my account"
PDSP_AUTH_003Fraudulent transaction - 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 API 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 API 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 API 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 API 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"