Skip to main content

Documentation

Get Merchant Service Charge Fees on an Agreement

Returns the current Merchant Service Charge (MSC) fees configured on a merchant agreement. Use it before calling the update endpoint to see the current fees and the exact fee names to send. The response data has the same shape as the update request body, so it can be retrieved, modified, and sent back as the update request.

Parameters
Request Path Parameters

    • merchant_id

    • Identifier of merchant.

    • agreement_id

    • Identifier of a specific merchant agreement.

Request Header Parameters

    • api-version

    • The requested API version

      3.0

    • ApiKey

    • Standard Authorization header using the ApiKey scheme.

    • Accept

    • Only application/json is supported.

      application/json

200 Success Response

    • success

    • Indicates whether the request was successful.

    • statusCode

    • The HTTP status code of the response.

    • message

    • A human-readable message describing the result.

    • data

    • An object containing the Merchant Service Charge fees configured on the agreement.

401 Unauthorized Response

    • success

    • Indicates whether the request was successful.

    • statusCode

    • The HTTP status code of the response.

    • message

    • Api Key was not provided.

    • data

    • No data is returned for unauthorized requests.

500 Internal Server Error Response

    • success

    • Indicates whether the request was successful.

    • statusCode

    • The HTTP status code of the response.

    • message

    • Unexpected error occurred. Please contact support.

    • data

    • null

  • /isoapi/merchants/{merchant_id}/agreements/{agreement_id}/merchant_service_charge

  • 200 Success

  • curl -X GET
https://boarding.valitor.com/isoapi/merchants/{merchant_id}/agreements/{agreement_id}/merchant_service_charge
-H 'ApiKey: my-ApiKey'

  • {
  "success": true,
  "statusCode": 200,
  "message": "Success",
  "data": {
    "merchantServiceChargeFees": [
      {
        "name": "string",
        "fixedValue": 0.1,
        "percentageValue": 0.1
      }
    ]
  }
}

  • 401 Unauthorized

  • curl -X GET
https://boarding.valitor.com/isoapi/merchants/{merchant_id}/agreements/{agreement_id}/merchant_service_charge
-H 'ApiKey: my-ApiKey'

  • {
  "success": false,
  "statusCode": 401,
  "message": "Api Key was not provided",
  "data": null
}

  • 500 Internal Server Error

  • curl -X GET
https://boarding.valitor.com/isoapi/merchants/{merchant_id}/agreements/{agreement_id}/merchant_service_charge
-H 'ApiKey: my-ApiKey'

  • {
  "success": false,
  "statusCode": 500,
  "message": "Unexpected error occured. Please contact support.",
  "data": null
}
In this section: