Skip to main content

Documentación

Update Merchant Service Charge Fees on an Agreement

Update the merchant's Merchant Service Charge (MSC) fees for a specific agreement.

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.

    • Content-Type

    • Only application/json is supported.

    • Accept

    • Only application/json is supported.

      application/json

Request Body Parameters

    • merchantServiceChargeFees

    • The Merchant Service Charge fees to set on the agreement. Each fee replaces the matching fee by name.

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

    • Empty object. The update returns no data on success.

400 Bad Request Response

    • success

    • Indicates whether the request was successful.

    • statusCode

    • The HTTP status code of the response.

    • message

    • A human-readable message describing the validation error.

    • data

    • No data is returned for bad request responses.

401 Unauthorized Response

    • success

    • Indicates whether the request was successful.

    • statusCode

    • The HTTP status code of the response.

    • message

    • A human-readable message describing the authentication error.

    • data

    • No data is returned for unauthorized requests.

404 Not Found Response

    • success

    • Indicates whether the request was successful.

    • statusCode

    • The HTTP status code of the response.

    • message

    • A human-readable message describing the not found error.

    • data

    • No data is returned when the resource is not found.

500 Internal Server Error Response

    • success

    • Indicates whether the request was successful.

    • statusCode

    • The HTTP status code of the response.

    • message

    • A human-readable message describing the server error.

    • data

    • No data is returned for internal server error responses.

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

  • 200 Success

  • curl -X POST
https://boarding.valitor.com/isoapi/merchants/{merchant_id}/agreements/{agreement_id}/merchant_service_charge
-H 'ApiKey: my-ApiKey'
-H 'Content-Type: application/json'
-d '{
  "merchantServiceChargeFees": [
    {
      "name": "string",
      "fixedValue": 0.1,
      "percentageValue": 0.1
    }
  ]
}
'

  • {
  "success": true,
  "statusCode": 200,
  "message": "Success",
  "data": {}
}

  • 400 Bad Request

  • curl -X POST
https://boarding.valitor.com/isoapi/merchants/{merchant_id}/agreements/{agreement_id}/merchant_service_charge
-H 'ApiKey: my-ApiKey'
-H 'Content-Type: application/json'
-d '{
  "merchantServiceChargeFees": [
    {
      "name": "string",
      "fixedValue": 0.1,
      "percentageValue": 0.1
    }
  ]
}
'

  • {
  "success": false,
  "statusCode": 400,
  "message": "Bad request",
  "data": {
    "property": "error message"
  }
}

  • 401 Unauthorized

  • curl -X POST
https://boarding.valitor.com/isoapi/merchants/{merchant_id}/agreements/{agreement_id}/merchant_service_charge
-H 'ApiKey: my-ApiKey'
-H 'Content-Type: application/json'
-d '{
  "merchantServiceChargeFees": [
    {
      "name": "string",
      "fixedValue": 0.1,
      "percentageValue": 0.1
    }
  ]
}
'

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

  • 404 Not Found

  • curl -X POST
https://boarding.valitor.com/isoapi/merchants/{merchant_id}/agreements/{agreement_id}/merchant_service_charge
-H 'ApiKey: my-ApiKey'
-H 'Content-Type: application/json'
-d '{
  "merchantServiceChargeFees": [
    {
      "name": "string",
      "fixedValue": 0.1,
      "percentageValue": 0.1
    }
  ]
}
'

  • {
  "success": false,
  "statusCode": 404,
  "message": "Not Found",
  "data": null
}

  • 500 Internal Server Error

  • curl -X POST
https://boarding.valitor.com/isoapi/merchants/{merchant_id}/agreements/{agreement_id}/merchant_service_charge
-H 'ApiKey: my-ApiKey'
-H 'Content-Type: application/json'
-d '{
  "merchantServiceChargeFees": [
    {
      "name": "string",
      "fixedValue": 0.1,
      "percentageValue": 0.1
    }
  ]
}
'

  • {
  "success": false,
  "statusCode": 500,
  "message": "Unexpected error occured. Please contact support.",
  "data": null
}
En esta sección: