v1

latestOpenAPI 3.0.0ISC2026-07-249501.1 MB
Chargebacks

Dispute a chargeback

Flags a chargeback as disputed. You may include additional information if wanted.

<!-- theme: info -->

📘 Note

By submitting a chargeback dispute via the Nexio API you agree to the following: "I agree that I am not including sensitive information. Sensitive information includes: full credit or debit card numbers, credit or debit card security codes (CVV/CVC), social security numbers, driver's license numbers, health records, and so forth."<br/><br/>Your dispute will be rejected if you include sensitive information.

<!-- theme: warning -->

⚠️ Try It

To use the Try It feature for this endpoint, you must use the credentials for your Sandbox API user.<br/><br/>Include at least the chargeback ID and a Nexio account username.

<div style="display:none;">

Request parameters

  • chargebackId
  • userName
  • description
  • images
  • images.name
  • images.data
  • isPreview

Response parameters

  • message
</div>
post/chargeback/v3/dispute

Request body

chargebackIdstring required

The Nexio chargeback ID to flag as disputed.

userNamestring required

Your Nexio account username.

descriptionstring

A description of the reason the chargeback has been disputed. 800 character limit.

isPreviewboolean

Set to true to return a PDF preview of the chargeback dispute in the response.

Example request

{
  "chargebackId": "305422",
  "userName": "apiuser@example.com",
  "images": [
    {
      "name": "Receipt with customer signature",
      "data": "data:image/png;base64,iVBO"
    }
  ]
}

Response

Success

messagestring

A description of the status of your request.

Example response

{
  "message": "success"
}