Handling responses - Checkout API - Mercado Pago Developers
Developers
API Reference
Support
Sign in

    Home

    Getting started

    Online Payments

    Checkout Pro

    Checkout API

    Payment Link

    Marketplace

    Mobile Checkout

    Web Tokenize Checkout

    In person payments

    QR Code

    Plugins and platforms

    WooCommerce

    Prestashop

    Magento 2

    Shopify

    VTEX

    SDKs

    Notifications

    Webhooks

    IPN

    Account Management

    Requirements for production environment

    Get payments

    Reports

    Cashback and Cancellations

    Chargeback Management

    Improves approval

    Resources

    Localization

    Changelog

    Status

IN THIS PAGE

Suggest edit
Help us improve the documentation
Did you see wrong information and would you like us to explain something else or improve our manuals? Please leave your suggestions on GitHub.

Response Handling

Offer your customers clear and accurate information about possible card data entry or payment status errors. This way they are notified of the resolution actions they can take, or any additional step required.

For example, if the card has insufficient balance, you can suggest trying again with another payment method to complete the transaction.

Note
To get more information about the possible errors, view the API reference.

Collection creation results

Statusstatus_detailSuggested communication
approvedaccreditedDone! Your payment was credited. Your statement will show the amount charge as statement_descriptor.
in_processpending_contingencyWe are processing your payment.

Don't worry! You will be notified via e-mail
if payment was credited in less than 2 business days.
in_processpending_review_manualWe are processing your payment.

Don't worry! You will be notified via email if it is credited or if we need more information in less than 2 business days.
rejectedcc_rejected_bad_filled_card_numberCheck card number.
rejectedcc_rejected_bad_filled_dateCheck expiration date.
rejectedcc_rejected_bad_filled_otherCheck data.
rejectedcc_rejected_bad_filled_security_codeCheck card security code.
rejectedcc_rejected_blacklistYour payment couldn't be processed.
rejectedcc_rejected_call_for_authorizeAuthorize the amount payment to payment_method_id.
rejectedcc_rejected_card_disabledCall payment_method_id to activate your card, or use a different payment method. The phone is on the back of your card.
rejectedcc_rejected_card_errorYour payment couldn't be processed.
rejectedcc_rejected_duplicated_paymentYou have already made a payment for that value.

If you need to pay again, use a different card or payment method.
rejectedcc_rejected_high_riskYour payment was rejected.

Select a different payment method; we recommend cash methods.
rejectedcc_rejected_insufficient_amountYour payment_method_id does not have enough funds.
rejectedcc_rejected_invalid_installmentspayment_method_id does not process payments in installments installments.
rejectedcc_rejected_max_attemptsYou reached the allowed attempt limit.

Select a different card or payment method.
rejectedcc_rejected_other_reasonpayment_method_id did not process payment.

Data entry errors

Client-Side

CodeDescriptionSuggested communication
205parameter cardNumber can not be null/emptyEnter card number.
208parameter cardExpirationMonth can not be null/emptySelect month.
209parameter cardExpirationYear can not be null/emptySelect year.
212parameter docType can not be null/emptyEnter your ID type.
213The parameter cardholder.document.subtype can not be null or emptyEnter your ID.
214parameter docNumber can not be null/emptyEnter your ID.
220parameter cardIssuerId can not be null/emptyEnter your bank.
221parameter cardholderName can not be null/emptyEnter name and surname.
224parameter securityCode can not be null/emptyEnter security code.
E301invalid parameter cardNumberEnter a valid card number.
E302invalid parameter securityCodeCheck security code.
316invalid parameter cardholderNameEnter a valid name.
322invalid parameter docTypeInvalid ID type.
323invalid parameter cardholder.document.subtypeCheck your ID.
324invalid parameter docNumberInvalid ID.
325invalid parameter cardExpirationMonthInvalid month.
326invalid parameter cardExpirationYearInvalid year.
defaultAnother error codeCheck data.

Card token generation errors

Statusstatus_detailSuggested communication
106Cannot operate between users from different countriesYou cannot make payments to other countries.
109Invalid number of shares for this payment_method_idpayment_method_id does not process payments in installments installments.

Select a different card or payment method.
126The action requested is not valid for the current payment stateYour payment couldn't be processed.
129Cannot pay this amount with this paymentMethodpayment_method_id does not process payments for the selected amount.

Select a different card or payment method.
145Invalid users involvedYou are trying to make a payment to a test user and a real user.
150The payer_id cannot do payments currentlyYou cannot make payments.
151The payer_id cannot do payments with this payment_method_idYou cannot make payments.
160Collector not allowed to operateYour payment couldn't be processed.
204Unavailable payment_methodpayment_method_id is not available right now.

Select a different card or payment method.
801Already posted the same request in the last minuteYou made a similar payment a while ago.

Try again in a few minutes.
defaultAnother error codeYour payment couldn't be processed.

Next steps

RECOMMENDED

Advanced integration

Enhance your integration and improve your sales management.

RECOMMENDED

API References

Find all the information required to interact with our APIs.

Was this information helpful?

Copyright © 1999-2021 MercadoLibre Perú S.R.L.

Terms and conditionsHow we take care of your privacy
Partners Mercado Pago

Al navegar en este sitio aceptas las cookies que utilizamos para mejorar tu experiencia. Más información.