API responses

In this section, you will find possible responses related to the creation of the Zero Dollar Auth validation, with details about each type of response, including success and error cases.

Upon receiving the 200 Return, which confirms the Zero Dollar Auth authorization for the card, and the status indicates "approved", it is concluded that the card validation was done correctly. On the other hand, if the status is "rejected", it means that the card validation was not possible. This negative result can be caused by various factors, such as a blocked or expired card.

Below, we list the response body for each of the scenarios.

• Status: approved
• Description: response indicating the success of the Zero Dollar Auth validation creation.
• Response body:

{
    "id": 0000000000,
    "version": null,
    "date_created": "2023-01-12T11:36:19.497-04:00",
    "date_approved": "2023-01-12T11:36:20.345-04:00",
    "date_last_updated": "2023-01-12T11:36:20.345-04:00",
    "date_of_expiration": null,
    "money_release_date": "2023-01-12T11:36:20.345-04:00",
    "operation_type": "card_validation",
    "issuer_id": "205",
    "payment_method_id": "master",
    "payment_type_id": "credit_card",
    "status": "approved",
    "status_detail": "accredited",
    "transaction_amount": 0,
}

• Status: rejected
• Description: Response indicating that the creation of the Zero Dollar Auth validation was rejected. If you receive this error, we recommend reviewing the parameters of the request to ensure that they all comply with the values accepted by our API. After reviewing it, make a new request.

• Response body:

{
    "id": 0000000000,
    "version": null,
    "date_created": "2023-01-12T11:36:19.497-04:00",
    "date_approved": "2023-01-12T11:36:20.345-04:00",
    "date_last_updated": "2023-01-12T11:36:20.345-04:00",
    "date_of_expiration": null,
    "money_release_date": "2023-01-12T11:36:20.345-04:00",
    "operation_type": "card_validation",
    "issuer_id": "205",
    "payment_method_id": "master",
    "payment_type_id": "credit_card",
    "status": "rejected",
    "status_detail": "cc_rejected_other_reason",
    "transaction_amount": 0,
}

If you receive a 400 response code, it generally means that the request body contains data that is incompatible with what is accepted by the API. A common example of this situation is attempting to validate the transaction by sending a transaction_amount with a non-zero value.

Below, we list the response body for each of the scenarios.

• Status: 400
• Description: This error occurs when the transaction_amount field has a value different from zero. To avoid this type of error, review the request body and make sure that the transaction_amount parameter has a value equal to zero.
• Response body:

{
    "message": "Invalid value for transaction_amount",
    "error": "bad_request",
    "status": 400,
    "cause": [
        {
            "code": 2072,
            "description": "Invalid value for transaction_amount",
            "data": "26-09-2023T17:27:50UTC;76230673-8376-47ee-8d7f-6ccaacdb5b2a"
        }
    ]
}

• Status: 400
• Description: If you receive this error, we recommend reviewing the parameters of the request to ensure they comply with the values accepted by our API. After reviewing it, make a new request.
• Response body:

{
    "message": "<BADREQUEST MESSAGE>",
    "error": "bad_request",
    "status": 400,
    "cause": [
        {
            "code": <error_code>,
            "description": "<detail error description>",
            "data": "12-01-2023T15:27:07UTC;bcd3be45-fcb4-4647-ba35-a0396cd71b90"
        }
    ]
}

The 500 responses (Internal Error) can indicate a failure of the server during the attempt to process the operation. Below is the body of the response.

{
   "message": "<ERROR MESSAGE>",
   "error": "internal_error",
   "status": 500,
   "cause": [
       {
           "code": <error_code>,
           "description": "<detail error description>",
           "data": "12-01-2023T15:21:28UTC;82c52796-1026-41d2-8ef9-4cbda2d0db8d"
       }
   ]
}

If the 500 error persists in multiple requests, please contact our Support.

If the merchant is not included in the permission list, the response will be the message "Forbidden" along with the status code 403. Below is an example code illustrating this response.

{
   "message": "Forbidden"
}

If you receive this response, we recommend that you contact your Mercado Pago sales representative.

• Description: This message is returned when the Zero Dollar Auth feature is temporarily disabled.
• Response body:

{
    "message": "This feature is temporarily off"
}