Square Connect API Chargebacks/Disputes

Question

If a merchant experiences a dispute / chargeback, where does that appear in the Square Connect API? As a refund? As a negative payment? Is there another endpoint specifically for this event?

Answer 1

Thanks for pointing out this gap in the documentation. I've updated this answer with the definitive settlement entry type.

Events like chargebacks are reflected in the entries of Settlement objects returned by the List and Retrieve Settlement endpoints. All chargeback-related settlement entries have the type HOLD_ADJUSTMENT. These entries can indicate the placing of a hold on disputed funds, or the subsequent release of a hold if a chargeback is won by the merchant.

Chargebacks are not reflected in payment- or refund-related endpoints.