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.