Accept Dispute

Use our API to accept a dispute.

Follow this guide to accept a dispute through the Dispute Management API resource. See Accept Dispute in API Reference for field definitions.

Please note:

  • You can use this API request to accept the following disputes:
    • A first-time chargeback for Visa, Mastercard, Discover, or American Express
    • A pre-arbitration for Visa, Mastercard, or Discover
  • See the Dispute Types table in Dispute Conventions for more information about dispute types.

See the Dispute Management Guide in Additional Features for information on how to handle disputes. If you wish to use API to manage disputes, please contact Maast Support first.


Prerequisites

  1. Do the following to get your ID for disputes:
    • If you are an individual merchant: Follow the steps in Get Started to create a sandbox account and get a sandbox security key and merchant ID. Use the Authentication guide to generate your API token.
    • If you are a dispute vendor: Email [email protected] and provide either your Maast merchant ID (MID) or your dispute vendor name.
  2. Follow the steps in Create Dispute Data to create a test dispute case and save its control number (rec_id).

Implement

Write a GET request. For the request endpoint, include the control number (recid) of the dispute you want to accept between dispute/ and /accept. The resulting endpoint is /platform/dispute/{recId}/accept, where the number replaces {recId}.

Your request will resemble the sample code below:

curl --request GET \
     --url https://api-test.maast.com/platform/dispute/393435800000003/accept \
     --header 'accept: application/json' \
     --header 'authorization: Basic OjllZGVjMjFhMzFjMHh5ejc4OWUzMGEzNDE2YWJjMTIz'

Integrate

Send your GET request. You will receive a response like this from the Maast server:

{
  "code": 0,
  "message": "Success"
}

Check the code field in the request response: 0 confirms success. If the value is something other than 0, check Platform API Response Codes in Reference. See Accept Dispute in API Reference for field definitions.


Test and Go Live

See our Test and Go Live guide to test your API integration and to start transacting with an active production account.