Merchant Enrolment Errors

Ravelin will perform validation on a merchant enrolment request to ensure that it will conform to Mastercard’s API requirements.

If the request fails validation, an error will be returned with a message that should help in the construction of a future successful request. An example of such an error message is shown below:

{
  "code": "400",
  "message": "invalid value in field `scheme` - should be \"Mastercard\"",
  "timestamp": 1629395847
}

In addition to validation errors, Mastercard may return an error if they are unable to process the request. Where appropriate these errors will be passed back to you, with a description to help with diagnosis of the issue.

Example Errors

Mandatory parameter is missing
Ensure that data has been supplied for all required fields for the endpoint you are calling.

{
  "code": "400",
  "message": "Mastercard could not process the request. ReasonCode: 0000, Description: Mandatory parameter is missing",
  "timestamp": 1629395847
}

Invalid parameter value for parameter
Ensure that the data provided is valid for the endpoint that you are calling.

{
  "code": "400",
  "message": "Mastercard could not process the request. ReasonCode: 0001, Description: Invalid parameter value for parameter",
  "timestamp": 1629395847
}

EnrolmentRequestID not found or expired
The enrolmentRequestID provided was not found by Mastercard or it has expired.

{
  "code": "404",
  "message": "transaction could not be found by Mastercard. ReasonCode: 2001, Description: enrolmentRequestID not found or Expired",
  "timestamp": 1629395847
}

EnrolmentRequestID is invalid
Ensure that the enrolmentRequestID provided is correct.

{
  "code": "400",
  "message": "Mastercard could not process the request. ReasonCode: 2002, Description: enrolmentRequestID is invalid",
  "timestamp": 1629395847
}

Invalid payload format
The format of the request body was not able to be processed by Mastercard.

{
  "code": "400",
  "message": "Mastercard could not process the request. ReasonCode: 3002, Description: Invalid payload format",
  "timestamp": 1629395847
}

Internal server error, please try again
Mastercard are experiencing internal server errors. Please try again later. Further details may be found on Mastercard’s status page.

{
  "code": "502",
  "message": "Mastercard endpoint is unavailable. ReasonCode: 5000, Description: Internal server error, please try again",
  "timestamp": 1629395847
}

Further information on the errors that Mastercard return can be found on Mastercard’s website.

For errors relating to 3DS, see 3DS Error Responses.

Feedback

Was this page helpful?

Thanks for the feedback. If you'd like to provide more detail, please email support@ravelin.com.