Responses handling for the creation of payments and card tokens

Provide clear and accurate information to your customers in the event of possible errors when entering card data and about the payment status. This will allow you to improve your checkout conversion, since users will know if they should correct any information or take any action to successfully complete the payment process.

When receiving a payment

Results when creating a payment: HTTP Status 201 OK

status status_detail Comunicación sugerida
approved accredited Done, your payment was approved! You will see the amount charged in your bill as statement_descriptor.
in_process pending_contingency We are processing the payment.

In less than 2 business days we will e-mail you the results.
in_process pending_review_manual We are processing the payment.

In less than 2 business days we will tell you by e-mail whether it was approved or if we need more information.
rejected cc_rejected_bad_filled_card_number Check the card number.
rejected cc_rejected_bad_filled_date Check the expiration date.
rejected cc_rejected_bad_filled_other Check the information.
rejected cc_rejected_bad_filled_security_code Check the security code.
rejected cc_rejected_blacklist We could not process your payment.
rejected cc_rejected_call_for_authorize You must authorize payment_method_id to pay the amount to MercadoPago
rejected cc_rejected_card_disabled Call payment_method_id to activate your card.

The phone number is on the back of your card. | | rejected | cc_rejected_card_error | We could not process your payment. | | rejected | cc_rejected_duplicated_payment | You already made a payment for that amount.

If you need to repay, use another card or other payment method. | | rejected | cc_rejected_high_risk | Your payment was declined.

Choose another payment method. We recommend cash. | | rejected | cc_rejected_insufficient_amount | Your payment_method_id do not have sufficient funds. | | rejected | cc_rejected_invalid_installments | payment_method_id does not process payments in installments. | | rejected | cc_rejected_max_attempts | You have reached the limit of allowed attempts.

Choose another card or another payment method. | | rejected | cc_rejected_other_reason | payment_method_id did not process the payment. |

Note

The expiration of a payment in pending or in_process state occurs after 30 days and the cancellation is automatic, is this case the final status of the payment is cancelled/expired.

Errors in data entry: HTTP Status 400 Bad Request

Code Description Suggested communication
205 parameter cardNumber can not be null/empty Enter your card number.
208 parameter cardExpirationMonth can not be null/empty Select a month.
209 parameter cardExpirationYear can not be null/empty Select a year.
212 parameter docType can not be null/empty Enter your identification type.
213 The parameter cardholder.document.subtype can not be null or empty Enter your identification subtype.
214 parameter docNumber can not be null/empty Enter your identification number.
220 parameter cardIssuerId can not be null/empty Enter your issuing bank.
221 parameter cardholderName can not be null/empty Enter your full name.
224 parameter securityCode can not be null/empty Enter the security code.
E301 invalid parameter cardNumber There is something wrong with that number. Please reenter.
E302 invalid parameter securityCode Check the security code.
316 invalid parameter cardholderName Enter a valid name.
322 invalid parameter docType Check your identification type.
323 invalid parameter cardholder.document.subtype Enter your identification subtype.
324 invalid parameter docNumber Enter your identification number.
325 invalid parameter cardExpirationMonth Check the date.
326 invalid parameter cardExpirationYear Check the date.
default (cualquier otro código de error) Check the information.

Errors in card token creation

If there is any error in the card data, we will inform it to you with the following codes, so you can communicate the situation to your users and how to correct it.

status status_detail Suggested communication sugerida
106 Cannot operate between users from different countries You cannot make payments to users in other countries.
109 Invalid number of shares for this payment_method_id payment_method_id does not process payments in installments.

Choose another card or another payment method.
126 The action requested is not valid for the current payment state We could not process your payment.
129 Cannot pay this amount with this paymentMethod payment_method_id id does not process payments for the selected amount.

Choose another card or another payment method
145 Invalid users involved We could not process your payment.
150 The payer_id cannot do payments currently You cannot make payments.
151 The payer_id cannot do payments with this payment_method_id You cannot make payments.
160 Collector not allowed to operate We could not process your payment.
204 Unavailable payment_method payment_method_id is not available at this time.

Choose another card or another payment method
801 Already posted the same request in the last minute You made a similar payment moments ago.

Try again in a few minutes.
default (cualquier otro código de error) We could not process your payment.

La búsqueda no arrojó ningún resultado.

Verifica la la ortografía de los términos de búsqueda o prueba con otras palabras clave.