MATCH - Error Codes
Help assess risk prior to signing a merchant

If a transaction can't be processed, an error will occur. The errors can be for system, service or even network issues.

Why would I need to use this resource?
This resource is provided to you in the event the transaction can't be completed. The error can be for a specific service format issue, network connection or overall message format issue.

Response Values

Errors.Error.Source

Description:  This is the unique identifier that attempts to define the field in error when available.  If a specific field can't be identified, System will be returned.
Example:  If an error is produced because of required data it would be presented with the field missing data.

  • Request.Payload
  • Security.Credential
  • Merchant.Principal
Errors.Error.ReasonCode

Description:  This will identify the reason for the error.
Example: 

  • INVALID_INPUT_VALUE
  • SECURITY_CREDENTIAL_MISSING
  • SECURITY_CREDENTIAL_UNAUTHORIZED
  • VOLUME_THRESHOLD_EXCEEDED
Errors.Error.Description

Description:  This is the text description of the error. This is optional and will only be displayed if more information is available than is stored in the data identifier and reason code.
Example: 

  • Merchant Principals exceed length 5
  • The system is experiencing heavy traffic volume, please try again later
  • Maximum requests exceeded for the current time window
Errors.Error.Recoverable

Description:  This is a true/false presentation to explain if the transaction was submitted again would it be successful or not.
Example:  True or False

Example Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
     <Error>
          <Source>Merchant.Principal</Source>
	  <ReasonCode>INVALID_INPUT_VALUE</ReasonCode>
	  <Description>The merchant principal is invalid</Description>
	  <Recoverable>False</Recoverable>
     </Error>
</Errors>

Need an account?

Get started by registering an account on MasterCard Developer Zone.

Register

Need help getting started?

After registering, the next thing you need to do is register an Application using the "Add An App" button on your dashboard.

Go To My Dashboard

Get an SDK

Download a software development kit to make integration with MasterCard easy.

Get an SDK


© 1994-2014. MasterCard. All rights reserved.