Get merchant categories

GET 
/merchant-categories

Get the merchant categories that are accepted by the calculation API.

Responses

200

Merchant categories response

application/json

Schema

Schema

merchantCategories

object[]

Array [

code stringrequired

Possible values: non-empty and <= 4 characters, Value must match regular expression [0-9]{1,4}

Merchant Category Code in ISO 18245 format

]

Example (from schema)

{
  "merchantCategories": [
    {
      "code": "string"
    }
  ]
}

401

Unauthorized client

403

Insufficient scope for accessing this resource

application/json

Schema

Schema

errors

object[]

required

Errors

Array [

source stringrequired

Possible values: non-empty and <= 100 characters

The application name that generated this error.

reasonCode stringrequired

Possible values: non-empty and <= 100 characters

A unique constant identifying the error case encountered during request processing.

• BAD_REQUEST - Malformed request, please advice the description and details fields for more information
• FORBIDDEN - Insufficient scope to access the resource
• INTERNAL_SERVER_ERROR - Unexpected server error
• METHOD_NOT_ALLOWED - Method not allowed
• UNSUPPORTED_MEDIA_TYPE - Unsupported media type
• SERVICE_UNAVAILABLE - Service is unavailable

description stringrequired

Possible values: >= 10 characters and <= 1000 characters

Short description of the reasonCode field.

recoverable booleanrequired

Indicates whether this error will always be returned for this request, or retrying could change the outcome.

details string

Possible values: <= 5000 characters

Where appropriate, indicates detailed information about data received and calculated during request processing, to help the user with diagnosing errors.

]

Example (from schema)

{
  "errors": [
    {
      "source": "Doconomy",
      "reasonCode": "BAD_REQUEST",
      "description": "cardTransactions[0].mcc must match \\\"[0-9]{1,4}\\\"",
      "recoverable": false,
      "details": "string"
    }
  ]
}

405

Method not allowed

application/json

Schema

Schema

errors

object[]

required

Errors

Array [

source stringrequired

Possible values: non-empty and <= 100 characters

The application name that generated this error.

reasonCode stringrequired

Possible values: non-empty and <= 100 characters

A unique constant identifying the error case encountered during request processing.

• BAD_REQUEST - Malformed request, please advice the description and details fields for more information
• FORBIDDEN - Insufficient scope to access the resource
• INTERNAL_SERVER_ERROR - Unexpected server error
• METHOD_NOT_ALLOWED - Method not allowed
• UNSUPPORTED_MEDIA_TYPE - Unsupported media type
• SERVICE_UNAVAILABLE - Service is unavailable

description stringrequired

Possible values: >= 10 characters and <= 1000 characters

Short description of the reasonCode field.

recoverable booleanrequired

Indicates whether this error will always be returned for this request, or retrying could change the outcome.

details string

Possible values: <= 5000 characters

Where appropriate, indicates detailed information about data received and calculated during request processing, to help the user with diagnosing errors.

]

Example (from schema)

{
  "errors": [
    {
      "source": "Doconomy",
      "reasonCode": "BAD_REQUEST",
      "description": "cardTransactions[0].mcc must match \\\"[0-9]{1,4}\\\"",
      "recoverable": false,
      "details": "string"
    }
  ]
}

429

Too many requests, check the headers X-RateLimit-Limit-second and X-RateLimit-Remaining-second

500

Unexpected server error

application/json

Schema

Schema

errors

object[]

required

Errors

Array [

source stringrequired

Possible values: non-empty and <= 100 characters

The application name that generated this error.

reasonCode stringrequired

Possible values: non-empty and <= 100 characters

A unique constant identifying the error case encountered during request processing.

• BAD_REQUEST - Malformed request, please advice the description and details fields for more information
• FORBIDDEN - Insufficient scope to access the resource
• INTERNAL_SERVER_ERROR - Unexpected server error
• METHOD_NOT_ALLOWED - Method not allowed
• UNSUPPORTED_MEDIA_TYPE - Unsupported media type
• SERVICE_UNAVAILABLE - Service is unavailable

description stringrequired

Possible values: >= 10 characters and <= 1000 characters

Short description of the reasonCode field.

recoverable booleanrequired

Indicates whether this error will always be returned for this request, or retrying could change the outcome.

details string

Possible values: <= 5000 characters

Where appropriate, indicates detailed information about data received and calculated during request processing, to help the user with diagnosing errors.

]

Example (from schema)

{
  "errors": [
    {
      "source": "Doconomy",
      "reasonCode": "BAD_REQUEST",
      "description": "cardTransactions[0].mcc must match \\\"[0-9]{1,4}\\\"",
      "recoverable": false,
      "details": "string"
    }
  ]
}

default

Default response

Response Headers

• X-RateLimit-Limit-second

  integer

  Request limit per second

• X-RateLimit-Remaining-second

  integer

  Number of requests left for the time window

Loading...