Error Codes Brazil PayIn

Understand the possible errors returned by the PagSeguro Brazil PayIn API and how to handle them effectively. This page groups errors by feature or API area and provides explanations and guidance on resolving each issue.

Common Header Errors

Authorization Header

Code	Key	Description
10001	`header_authorization_missing`	Missing header Authorization in request
10002	`header_authorization_bad_format`	Authorization header bad formation
10003	`header_authorization_invalid`	Authorization header error

Accept Header

Code	Key	Description
10201	`header_accept_missing`	Missing header Accept in request
10202	`header_accept_application_missing`	Missing Application on header Accept
10203	`header_accept_bad_format`	Header Accept with bad format
10204	`header_accept_format_missing`	Missing Format on header Accept
10205	`header_accept_charset_missing`	Missing Charset on header Accept
10206	`header_accept_application_invalid`	Invalid Application on Accept Header
10207	`header_accept_format_invalid`	Invalid Format on Accept Header
10208	`header_accept_charset_invalid`	Invalid Charset on Accept Header
10209	`header_accept_version_invalid`	Invalid Version on Accept Header

Content-Type Header

Code	Key	Description
10301	`header_contenttype_missing`	Missing header Content-Type in request
10302	`header_contenttype_not_accepted`	Content-Type is not accepted

Accept Language

Code	Key	Description
10401	`header_language_not_accepted`	Language not accepted

Credit Card Installments API

Code	Key	Description
30301	`bin_missing`	Missing Bin
30302	`bin_invalid`	Invalid Bin
30303	`brand_missing`	Missing Brand
30304	`brand_invalid`	Invalid Brand
30305	`country_missing`	Missing Country
30306	`country_invalid`	Invalid Country
30307	`amount_missing`	Missing Amount
30308	`amount_invalid`	Invalid Amount
30309	`currency_missing`	Missing Currency
30310	`currency_invalid`	Invalid Currency

Transaction API

Code	Key	Description
210101	`transaction_missing`	Transaction is missing
210102	`transaction_invalid`	Transaction is invalid
210103	`transaction_reference_missing`	Transaction reference is missing
210104	`transaction_reference_invalid`	Transaction reference is invalid (special characters) or was already used
210105	`transaction_project_number_missing`	Transaction project number is missing
210106	`transaction_project_number_invalid`	Transaction project number is invalid
210107	`transaction_country_missing`	Transaction country is missing
210108	`transaction_country_invalid`	Transaction country is invalid. Should be BR
210109	`transaction_currency_missing`	Transaction currency is missing
210110	`transaction_currency_invalid`	Transaction currency is invalid. Should be BRL
210111	`transaction_checkout_type_missing`	Transaction checkout type is missing
210112	`transaction_checkout_type_invalid`	Transaction checkout type is invalid. Should be direct
210113	`transaction_notification_url_missing`	Transaction notification is missing
210114	`transaction_notification_url_invalid`	Transaction notification is not a valid URL
210115	`transaction_redirect_urls_missing`	Transaction redirect urls is missing
210116	`transaction_redirect_urls_invalid`	Transaction redirect urls is invalid [*]
210117	`transaction_language_missing`	Transaction language is missing
210118	`transaction_language_invalid`	Transaction language is invalid. Valid values: pt-BR, pt-PT, en-US, es-ES, tr-TR
210119	`transaction_redirect_urls_success_missing`	Transaction redirect urls is missing
210120	`transaction_redirect_urls_success_invalid`	Transaction redirect urls is invalid URL [*]
210121	`transaction_redirect_urls_fail_missing`	Transaction redirect urls is missing
210122	`transaction_redirect_urls_fail_invalid`	Transaction redirect urls is invalid URL [*]
210201	`charge_missing`	Charge is missing
210202	`charge_invalid`	Charge is invalid
210203	`charge\_[0‑9]\_amount_missing`	Charge amount is missing
210204	`charge\_[0‑9]\_amount_invalid`	Charge amount is invalid
210205	`charge\_[0‑9]\_payment_method_missing`	Charge payment method is missing
210206	`charge\_[0‑9]\_payment_method_invalid`	Charge payment method is invalid
210207	`charge\_[0‑9]\_payment_method_type_missing`	Charge payment method type is missing
210208	`charge\_[0‑9]\_payment_method_type_invalid`	Charge payment method type is invalid. Valid values: credit-card, postpay or e-wallet
210209	`charge\_[0‑9]\_payment_method_sub_type_missing`	Charge payment method sub type is missing
210210	`charge\_[0‑9]\_payment_method_sub_type_invalid`	Charge payment method sub type is invalid. Valid values: available credit-card brands, boleto, pagseguro or paypal
210211	`charge\_[0‑9]\_payment_info_missing`	Charge payment info is missing
210212	`charge\_[0‑9]\_payment_info_invalid`	Charge payment info is invalid
210213	`charge\_[0‑9]\_payment_info_installments_missing`	Charge payment info installments is missing
210214	`charge\_[0‑9]\_payment_info_installments_invalid`	Charge payment info installments is invalid
210215	`charge\_[0‑9]\_payment_info_token_missing`	Charge payment info token is missing
210216	`charge\_[0‑9]\_payment_info_token_invalid`	Charge payment info token is invalid. Issue generating token or not accepted card brand See more
210217	`charge\_[0‑9]\_payment_info_save_missing`	Charge payment info save is missing
210218	`charge\_[0‑9]\_payment_info_save_invalid`	Charge payment info save is invalid
210219	`charge\_[0‑9]\_payment_info_code_missing`	Charge payment info is missing
210220	`charge\_[0‑9]\_payment_info_code_invalid`	Charge payment info is invalid. Payment method code format doesn't match (alphanum, 32 chars)
210221	`charge\_[0‑9]\_payment_info_credit_card_invalid`	Charge payment info credit card is invalid. Validation of fields mandatory (CVV and Expiration Date) based on the rules of each brand
210222	`charge\_[0‑9]\_payment_info_credit_card_number_invalid`	Charge payment info credit card number is invalid. Validation of the credit card number based on Luhn's algorithm, except for brands: Hipercard
210223	`charge\_[0‑9]\_payment_info_credit_card_cvv_invalid`	Charge payment info credit card cvv is invalid. Credit card cvv format doesn't match (string, 3-4 characters)
210224	`charge\_[0‑9]\_payment_info_credit_card_expiration_date_invalid`	Charge payment info credit card expiration date is invalid. credit card expiration date format doesn't match (string, format:'YYYY-MM')
210225	`charge_payments_amount_sum_invalid`	Charge payment amount sum is invalid. Amount sum must be equal to shipping.cost plus cart items value .
210226	`charge\_[0‑9]\_payment_info_expiration_date_invalid`	Charge payment info eft expiration-date. EFT expiration-date format doesn't match (yyyy-MM-dd'T'HH:mm:ssz)
210302	`payer_invalid`	Payer is invalid
210303	`payer_name_missing`	Payer name is missing
210304	`payer_name_invalid`	Payer name is invalid. Payer name does not match the requirement
210305	`payer_email_missing`	Payer email is missing
210306	`payer_email_invalid`	Payer email is invalid. Payer email does not match the requirement
210307	`payer_birth_date_missing`	Payer birth date is missing
210308	`payer_birth_date_invalid`	Payer birth date is invalid
210309	`payer_ip_missing`	Payer ip is missing
210310	`payer_ip_invalid`	Payer ip is invalid
210311	`payer_phone_number_missing`	Payer phone number is missing
210312	`payer_phone_number_invalid`	Payer phone number is invalid
210313	`payer_document_missing`	Payer document is missing
210314	`payer_document_invalid`	Payer document is invalid
210315	`payer_document_type_missing`	Payer document type is missing
210316	`payer_document_type_invalid`	Payer document type is invalid. Valid values: CPF or CNPJ
210317	`payer_document_number_missing`	Payer document number is missing
210318	`payer_document_number_invalid`	Payer document number is invalid. Should be a valid document
210319	`payer_address_missing`	Payer address is missing. Required when Cart has an item of type physical
210320	`payer_address_invalid`	Payer address is invalid
210321	`payer_address_street_missing`	Payer address street is missing
210322	`payer_address_street_invalid`	Payer address street is invalid. Should have 1-160 characters
210323	`payer_address_number_missing`	Payer address number is missing
210324	`payer_address_number_invalid`	Payer address number is invalid. Should have 1-20 characters
210325	`payer_address_complement_missing`	Payer address complement is missing
210326	`payer_address_complement_invalid`	Payer address complement is invalid. Should have 1-40 characters
210327	`payer_address_district_missing`	Payer address district is missing
210328	`payer_address_district_invalid`	Payer address district is invalid. Should have 1-60 characters
210329	`payer_address_state_missing`	Payer address state is missing
210330	`payer_address_state_invalid`	Payer address state is invalid. Should have 2 characters (e.g.: SP)
210331	`payer_address_city_missing`	Payer address city is missing
210332	`payer_address_city_invalid`	Payer address city is invalid. Should have 1-60 characters
210333	`payer_address_country_missing`	Payer address country is missing
210334	`payer_address_country_invalid`	Payer address country is invalid. Should have 2 characters (e.g.: BR)
210335	`payer_address_zip_code_missing`	Payer address zip code is missing
210336	`payer_address_zip_code_invalid`	Payer address zip code is invalid. Should have 8 characters
210337	`payer_underaged`	Minor (individual under 18 y.o.) is prohibited from engaging in transactions within this business sector.
210338	`payer_irregular_register`	Payer is not compliant with our internal policies.
210339	`payer_name_does_not_match`	The payer's name does not meet our internal policies' minimum similarity threshold. Please use the exact name specified in the document and avoid special characters for conformity.
210340	`payer_legal_constraints`	Payer is not compliant with international standards.
210341	`payer_deceased`	The payer document indicates the demise of the individual. Consequently, it is recommended that this user be barred from your system controls.
210342	`payer_not_found`	Failure to retrieve the individual document.
210343	`payer_national_id_inactive`	The payer document is inactive.
210344	`payer_national_id_cancelled`	Due to some administrative measures, the document may be cancelled.
210345	`payer_legal_data_unavailable`	Failure to retrieve legal information for the individual document. Kindly attempt your request again.
210346	`payer_banks\_[0‑9]\_account_type_missing`	Payer bank account type is missing.
210347	`payer_banks\_[0‑9]\_account_type_invalid`	Payer bank account type is invalid. Valid values: CRN, SVN, PAC, SAL
210348	`payer_banks\_[0‑9]\_account_branch_missing`	Payer bank account branch is missing.
210349	`payer_banks\_[0‑9]\_account_branch_invalid`	Payer bank account branch is invalid.
210350	`payer_banks\_[0‑9]\_account_missing`	Payer bank account is missing.
210351	`payer_banks\_[0‑9]\_account_invalid`	Payer bank account is invalid.
210352	`payer_banks\_[0‑9]\_code_missing`	Payer bank code is missing.
210353	`payer_banks\_[0‑9]\_code_invalid`	Payer bank code is invalid.
210354	`payer_banks_invalid`	Array must have at most 3 elements.
210355	`payer_banks_not_allowed`	Payer bank is not allowed.
210356	`payer_banks\_[0‑9]\_account_number_missing`	Payer bank account number is missing.
210357	`payer_banks\_[0‑9]\_account_number_invalid`	Payer bank account number is invalid.
210358	`payer_document_type_not_allowed`	Payer document type not accepted for transaction.
210401	`shipping_missing`	Shipping is missing. Required when Cart has an item of type physical.
210402	`shipping_invalid`	Shipping is invalid
210403	`shipping_cost_missing`	Shipping cost is missing
210404	`shipping_cost_invalid`	Shipping cost is invalid
210405	`shipping_address_missing`	Shipping address is missing
210406	`shipping_address_invalid`	Shipping address is invalid
210407	`shipping_address_street_missing`	Shipping address street is missing
210408	`shipping_address_street_invalid`	Shipping address street is invalid. Should have 1-160 characters
210409	`shipping_address_number_missing`	Shipping address number is missing
210410	`shipping_address_number_invalid`	Shipping address number is invalid. Should have 1-20 characters
210411	`shipping_address_complement_missing`	Shipping address complement is missing
210412	`shipping_address_complement_invalid`	Shipping address complement is invalid. Should have 1-40 characters
210413	`shipping_address_district_missing`	Shipping address district is missing
210414	`shipping_address_district_invalid`	Shipping address district is invalid. Should have 1-60 characters
210415	`shipping_address_state_missing`	Shipping address state is missing
210416	`shipping_address_state_invalid`	Shipping address state is invalid. Should have 2 characters (e.g.: SP)
210417	`shipping_address_city_missing`	Shipping address city is missing
210418	`shipping_address_city_invalid`	Shipping address city is invalid. Should have 1-60 characters
210419	`shipping_address_country_missing`	Shipping address country is missing
210420	`shipping_address_country_invalid`	Shipping address country is invalid. Should have 2 characters (e.g.: BR)
210421	`shipping_address_zip_code_missing`	Shipping address zip code is missing
210422	`shipping_address_zip_code_invalid`	Shipping address zip code is invalid. Should have 8 characters
210501	`cart_missing`	Cart is missing
210502	`cart_invalid`	Cart is invalid
210503	`cart\_[0‑9]\_description_missing`	Cart description is missing
210504	`cart\_[0‑9]\_description_invalid`	Cart description is invalid. Should have 1-200 characters
210505	`cart\_[0‑9]\_category_missing`	Cart category is missing
210506	`cart\_[0‑9]\_category_invalid`	Cart category is invalid. Shoud have 1-64 characters
210507	`cart\_[0‑9]\_quantity_missing`	Cart quantity is missing
210508	`cart\_[0‑9]\_quantity_invalid`	Cart quantity is invalid. Should be grather than 1
210509	`cart\_[0‑9]\_unit_price_missing`	Cart unit price is missing
210510	`cart\_[0‑9]\_unit_price_invalid`	Cart unit price is invalid. Should be greather than 0.01
210511	`cart\_[0‑9]\_type_missing`	Cart type is missing
210512	`cart\_[0‑9]\_type_invalid`	Cart type is invalid. Valid values: digital, physical, service or subscription
210601	`unavailable_payment_method`	The choosen payment method is not avaliable (see more)
210602	`payment_exceed_limits`	Payment exceed the limit purchase (only for Brazil, R$ 10000) by Payer Document
210603	`payer_blacklisted`	Payer is blacklisted by our risk analysis and must contact PagSeguro's Customer Support
210604	`payer_blacklisted_by_psp`	Payer is blacklisted by our PSP and must contact PagSeguro's Customer Support
210605	`charge\_[0‑9]\_payment_info_code_not_found`	Payment method was not found for the payment method code given or is not active
210005	`body_invalid`	Payment method code and direct-token cannot be sent in the same request

📘
URL Params
All URL parameters must have less than 201 characeteres, otherwise they will be considered invalid

Refund API

Code	Key	Description
20601	`internal_server_error`
20604	`partner_not_found`	The store-id sent does not exist
20605	`payment_does_not_accept_refund`	The payment method used in the transaction does not accept refunds
20607	`refund_already_requested`	A refund for the referred transaction is already being processed
20608	`refund_amount_is_greater_than_limit`	An amount smaller than the transaction value + refund already requested is required
20609	`refund_amount_is<br>_greater_than_transaction`	The amount sent is greater than the transaction value
20610	`refund_not_found`	Refund not found
20612	`service_refund_access_not_authorized`	The merchant does not have permission to request refunds
20613	`transaction_is_reseller`	Merchant category does not allow refunds
20614	`transaction_not_found`	Transaction not found
20615	`transaction_status_not_accept_refund`	The current status of the transaction does not allow refunds
20621	`expired_refund_request`	Deadline for refund exceeded
20622	`partial_refund_not_allowed`	Partial refund not allowed
20698	`Property missing, invalid cons<br>traint / type or invalid data.`
20699	`unknown_error`

Search API

Code	Key	Description
22100	`initial_order_date_invalid`	Initial order date has an invalid format
22101	`final_order_date_invalid`	Final order date has an invalid format
22102	`initial_payment_date_invalid`	Initial payment date has an invalid format
22103	`final_payment_date_invalid`	Final payment date has an invalid format
22104	`initial_last_status_change_date_invalid`	Initial last status change date has an invalid format
22105	`final_last_status_change_date_invalid`	Final last status change date has an invalid format
22106	`initial_order_date_is_mandatory_to_filter_by_final_order_date`	Initial order date is mandatory to filter by final order date
22107	`final_order_date_must_be_greater_than_initial_order_date`	Initial order date must be greater than final order date
22108	`initial_payment_date_is_mandatory_to_filter_by_final_payment_date`	Initial payment date is mandatory to filter by final payment date
22109	`final_payment_date_must_be_greater_than_initial_payment_date`	Initial payment date must be greater than final payment date
22110	`initial_last_status_change_date_is_mandatory_to_filter_by_final_last_status_change_date`	Initial last status change date is mandatory to filter by final last status change date
22111	`final_last_status_change_date_must_be_greater_than_initial_last_status_change_date`	Initial last status change date must be greater than final last status change date
22112	`final_order_date_range_exceeded`	Order date range date exceeded
22113	`final_payment_date_range_exceeded`	Order payment range date exceeded
22114	`final_last_status_change_date_range_exceeded`	Order last status change range date exceeded
22115	`page_invalid`	Page has an invalid format
22116	`max_page_results_invalid`	Max page results has an invalid format
22117	`any_initial_date_is_mandatory_for_multiple_records`	TransactionCode or any initial-date is mandatory
22118	`status_invalid`	Transaction status provided is invalid
22119	`Status_not_exists`	Transaction status provided does not exists

Direct Payment JS

Errors that occur when using the JavaScript SDK on the frontend. The following errors only apply for credit_card payment-type.

Error	Description	Critical
callback_must_be_a_function	The callback parameter in the getDirectToken method is not a function	Yes*
creditcard_object_malformed	Credit card object is not a javascript object	Yes*
credit_card_internal_error	Error on save credit card on PCI environment	No
creditcard_invalid_fields	Data from credit card object is not valid	No
creditcard_invalid_object	Credit card object has an invalid structure	Yes*
session_create_error	The object cannot retrive a session from PagSeguro	No
session_creating_in_progress	The Process of retrieving a session from PagSeguro was not yet finished	No
session_network_error	The object receives a network error on a attempt to create a session	Yes

*Critical errors often indicate implementation issues and should be addressed during development.

Common Header Errors

Authorization Header

Accept Header

Content-Type Header

Accept Language

Credit Card Installments API

Transaction API

📘URL Params

Refund API

Search API

Direct Payment JS

📘
URL Params