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.
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.
Was this page helpful?