v5

latestOpenAPI 3.1.02026-07-262421791.5 MB

disputes

Retrieve dispute reasons

Retrieves the list of possible reasons for submitting a dispute.

If a reason code has subOptions, those should be used as the reason code when submitting disputes.

get/v3/spend/profiles/{profileId}/dispute-form/reasons

Path parameters

profileIdinteger required

Your profile ID.

Headers

X-External-Correlation-Idstring uuid

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Response

List of dispute reasons.

codestring

The type of reasons available for the dispute. Top-level codes include ATM_DISPENSED_NO_FUNDS, WRONG_AMOUNT, TROUBLE_WITH_GOODS_SERVICES, MERCHANT_CHARGED_AGAIN, NO_REFUND, UNAUTHORIZED.

If a reason has subOptions, use the sub-option reason code when submitting a dispute.

descriptionstring

The description of the dispute reason.

isFraudboolean

Flag indicating that the dispute reason is fraud-related.

tooltipstring

Text to display when showing the dispute form to your users.

supportsMultipleTransactionsboolean

Whether the dispute supports multiple transactions.