# Error Responses source: https://developer.mastercard.com/straight-through-processing/documentation/code-and-formats/errors/index.md All error responses returned by the STP API are encoded according to the application/vnd.error Multipurpose Internet Mail Extensions (MIME) type specification. For more details, refer to . The error response body includes the following: * A unique reference value that identifies the failed request and that the user can provide to the application support team for troubleshooting. * A description of the cause of the error. * The URL of the resource being requested when the error occurred. In some scenarios, there may be more than a single error cause. For example, when multiple request fields contain invalid values. In such scenarios, the error response returned contains further details for each specific error within a nested list of application/vnd.error. * Json ```json { "logref": "abf3b007-dd6b-49bf-bf27-5e7bccfec7e1", "message": "Invalid request", "_links": { "about": { "href": "/suppliers" } }, "_embedded": { "errors": [ { "logref": "abf3b007-dd6b-49bf-bf27-5e7bccfec7e1", "message": " cannot be null nor empty", "_links": { "about": { "href": "/suppliers" } } } ] } } ``` ## Error codes {#error-codes} ### Gateway errors {#gateway-errors} When first integrating with the API, you will likely encounter errors from the gateway. These errors occur when the wrong IDs are used, your access is incorrect, or you hit a rate limit. These errors are common across Mastercard's APIs, and you can see all of them documented [here](https://developer.mastercard.com/platform/documentation/gateway-error-codes/). ### STP responses {#stp-responses} | Code | Description | Tip to Resolve | |-------------------------------|---------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------| | APPROVED | "Transaction Approved" | This transaction has been approved. No further action is required. | | UNSPECIFIED_FAILURE | "Transaction could not be processed" | Please resubmit your transaction. If the error persists, please contact the API Support team. | | DECLINED | "Transaction declined by issuer" | Please contact your issuing bank to inquire about the decline. | | TIMED_OUT | "Response timed out" | Please resubmit your transaction. If the error persists, please contact the API Support team. | | EXPIRED_CARD | "Transaction declined due to expired card" | Please resubmit your transaction using an unexpired card. | | INSUFFICIENT_FUNDS | "Transaction declined due to insufficient funds" | Please ensure that the card has sufficient funds for the transaction. | | ACQUIRER_SYSTEM_ERROR | "Acquirer system error occurred processing the transaction" | Please resubmit your transaction. If the error persists, please contact the API Support team. | | SYSTEM_ERROR | "Internal system error occurred processing the transaction" | Please resubmit your transaction. If the error persists, please contact the API Support team. | | NOT_SUPPORTED | "Transaction type not supported" | Please ensure you are using the appropriate card. | | DECLINED_DO_NOT_CONTACT | "Transaction declined - do not contact issuer" | Please ensure you are using the appropriate card. | | ABORTED | "Transaction aborted by payer" | Please resubmit the transaction when the payer is ready. | | BLOCKED | "Transaction blocked due to Risk or 3D Secure blocking rules" | Please ensure you are using the appropriate card. | | CANCELLED | "Transaction cancelled by payer" | Please resubmit the transaction when the payer is ready | | DEFERRED_TRANSACTION_RECEIVED | "Deferred transaction received and awaiting processing" | No further action is required. | | REFERRED | "Transaction declined - refer to issuer" | Please contact your issuing bank to inquire about the decline. | | AUTHENTICATION_FAILED | "3D Secure authentication failed" | Please use the appropriate authentication credentials. | | INVALID_CSC | "Invalid card security code" | Please resubmit the transaction with an appropriate card security code. | | LOCK_FAILURE | "Order locked - another transaction is in progress for this order" | Please wait and resubmit the transaction. If the error persists, please contact the API Support team. | | SUBMITTED | "Transaction submitted - response has not yet been received" | No further action is required. | | NOT_ENROLLED_3D_SECURE | "Cardholder is not enrolled in 3D Secure" | Please ensure that the cardholder is enrolled in 3D secure. | | PENDING | "Transaction is pending" | No further action is required. | | EXCEEDED_RETRY_LIMIT | "Transaction retry limit exceeded" | Please wait and resubmit the transaction. If the error persists, please contact the API Support team. | | DECLINED_AVS | "Transaction declined due to address verification" | Please ensure that you have submitted the correct cardholder address. | | DECLINED_CSC | "Transaction declined due to card security code" | Please resubmit the transaction with an appropriate card security code. | | DECLINED_AVS_CSC | "Transaction declined due to address verification and card security code" | Please ensure that you have submitted the correct cardholder address and card security code. | | DECLINED_PAYMENT_PLAN | "Transaction declined due to payment plan" | Please resubmit the transaction with the appropriate card details. | | APPROVED_PENDING_SETTLEMENT | "Transaction Approved - pending batch settlement" | No further action is required. | | PARTIALLY_APPROVED | "The transaction was approved for a lesser amount than requested" | No further action is required. | | UNKNOWN | "Response unknown" | Please resubmit the transaction. If the error persists, please contact the API Support team. |