Headers

Authorization Header

CodeKeyDescription
10001header_authorization_missingMissing header Authorization in request
10002header_authorization_bad_formatAuthorization header bad formation
10003header_authorization_invalidAuthorization header error

Accept Header

CodeKeyDescription
10201header_accept_missingMissing header Accept in request
10202header_accept_application_missingMissing Application on header Accept
10203header_accept_bad_formatHeader Accept with bad format
10204header_accept_format_missingMissing Format on header Accept
10205header_accept_charset_missingMissing Charset on header Accept
10206header_accept_application_invalidInvalid Application on Accept Header
10207header_accept_format_invalidInvalid Format on Accept Header
10208header_accept_charset_invalidInvalid Charset on Accept Header
10209header_accept_version_invalidInvalid Version on Accept Header

Content-Type Header

CodeKeyDescription
10301header_contenttype_missingMissing header Content-Type in request
10302header_contenttype_not_acceptedContent-Type is not accepted

Accept Language

CodeKeyDescription
10401header_language_not_acceptedLanguage not accepted

Credit Card Installments API

CodeKeyDescription
30301bin_missingMissing Bin
30302bin_invalidInvalid Bin
30303brand_missingMissing Brand
30304brand_invalidInvalid Brand
30305country_missingMissing Country
30306country_invalidInvalid Country
30307amount_missingMissing Amount
30308amount_invalidInvalid Amount
30309currency_missingMissing Currency
30310currency_invalidInvalid Currency

Direct Payment JS

Only for credit_card payment-type.

ErrorDescriptionCritical
callback_must_be_a_functionThe callback parameter in the getDirectToken method is not a functionYes*
creditcard_object_malformedCredit card object is not a javascript objectYes*
credit_card_internal_errorError on save credit card on PCI environmentNo
creditcard_invalid_fieldsData from credit card object is not validNo
creditcard_invalid_objectCredit card object has an invalid structureYes*
session_create_errorThe object cannot retrive a session from PagSeguroNo
session_creating_in_progressThe Process of retrieving a session from PagSeguro was not yet finishedNo
session_network_errorThe object receives a network error on a attempt to create a sessionYes

*Implementation error

Transaction API

CodeKeyDescription
210101transaction_missingTransaction is missing
210102transaction_invalidTransaction is invalid
210103transaction_reference_missingTransaction reference is missing
210104transaction_reference_invalidTransaction reference is invalid (special characters) or was already used
210105transaction_project_number_missingTransaction project number is missing
210106transaction_project_number_invalidTransaction project number is invalid
210107transaction_country_missingTransaction country is missing
210108transaction_country_invalidTransaction country is invalid. Should be BR
210109transaction_currency_missingTransaction currency is missing
210110transaction_currency_invalidTransaction currency is invalid. Should be BRL
210111transaction_checkout_type_missingTransaction checkout type is missing
210112transaction_checkout_type_invalidTransaction checkout type is invalid. Should be direct
210113transaction_notification_url_missingTransaction notification is missing
210114transaction_notification_url_invalidTransaction notification is not a valid URL
210115transaction_redirect_urls_missingTransaction redirect urls is missing
210116transaction_redirect_urls_invalidTransaction redirect urls is invalid [*]
210117transaction_language_missingTransaction language is missing
210118transaction_language_invalidTransaction language is invalid. Valid values: pt-BR, pt-PT, en-US, es-ES, tr-TR
210119transaction_redirect_urls_success_missingTransaction redirect urls is missing
210120transaction_redirect_urls_success_invalidTransaction redirect urls is invalid URL [*]
210121transaction_redirect_urls_fail_missingTransaction redirect urls is missing
210122transaction_redirect_urls_fail_invalidTransaction redirect urls is invalid URL [*]
210201charge_missingCharge is missing
210202charge_invalidCharge is invalid
210203charge_[0‑9]_amount_missingCharge amount is missing
210204charge_[0‑9]_amount_invalidCharge amount is invalid
210205charge_[0‑9]_payment_method_missingCharge payment method is missing
210206charge_[0‑9]_payment_method_invalidCharge payment method is invalid
210207charge_[0‑9]_payment_method_type_missingCharge payment method type is missing
210208charge_[0‑9]_payment_method_type_invalidCharge payment method type is invalid. Valid values: credit-card, postpay or e-wallet
210209charge_[0‑9]_payment_method_sub_type_missingCharge payment method sub type is missing
210210charge_[0‑9]_payment_method_sub_type_invalidCharge payment method sub type is invalid. Valid values: available credit-card brands, boleto, pagseguro or paypal
210211charge_[0‑9]_payment_info_missingCharge payment info is missing
210212charge_[0‑9]_payment_info_invalidCharge payment info is invalid
210213charge_[0‑9]_payment_info_installments_missingCharge payment info installments is missing
210214charge_[0‑9]_payment_info_installments_invalidCharge payment info installments is invalid
210215charge_[0‑9]_payment_info_token_missingCharge payment info token is missing
210216charge_[0‑9]_payment_info_token_invalidCharge payment info token is invalid. Issue generating token or not accepted card brand See more
210217charge_[0‑9]_payment_info_save_missingCharge payment info save is missing
210218charge_[0‑9]_payment_info_save_invalidCharge payment info save is invalid
210219charge_[0‑9]_payment_info_code_missingCharge payment info is missing
210220charge_[0‑9]_payment_info_code_invalidCharge payment info is invalid. Payment method code format doesn't match (alphanum, 32 chars)
210221charge_[0‑9]_payment_info_credit_card_invalidCharge payment info credit card is invalid. Validation of fields mandatory (CVV and Expiration Date) based on the rules of each brand
210222charge_[0‑9]_payment_info_credit_card_number_invalidCharge payment info credit card number is invalid. Validation of the credit card number based on Luhn's algorithm, except for brands: Hipercard
210223charge_[0‑9]_payment_info_credit_card_cvv_invalidCharge payment info credit card cvv is invalid. Credit card cvv format doesn't match (string, 3-4 characters)
210224charge_[0‑9]_payment_info_credit_card_expiration_date_invalidCharge payment info credit card expiration date is invalid. credit card expiration date format doesn't match (string, format:'YYYY-MM')
210225charge_payments_amount_sum_invalidCharge payment amount sum is invalid. Amount sum must be equal to shipping.cost plus cart items value .
210302payer_invalidPayer is invalid
210303payer_name_missingPayer name is missing
210304payer_name_invalidPayer name is invalid. Payer name does not match the requirement
210305payer_email_missingPayer email is missing
210306payer_email_invalidPayer email is invalid. Payer email does not match the requirement
210307payer_birth_date_missingPayer birth date is missing
210308payer_birth_date_invalidPayer birth date is invalid
210309payer_ip_missingPayer ip is missing
210310payer_ip_invalidPayer ip is invalid
210311payer_phone_number_missingPayer phone number is missing
210312payer_phone_number_invalidPayer phone number is invalid
210313payer_document_missingPayer document is missing
210314payer_document_invalidPayer document is invalid
210315payer_document_type_missingPayer document type is missing
210316payer_document_type_invalidPayer document type is invalid. Valid values: CPF or CNPJ
210317payer_document_number_missingPayer document number is missing
210318payer_document_number_invalidPayer document number is invalid. Should be a valid document
210319payer_address_missingPayer address is missing. Required when Cart has an item of type physical
210320payer_address_invalidPayer address is invalid
210321payer_address_street_missingPayer address street is missing
210322payer_address_street_invalidPayer address street is invalid. Should have 1-160 characters
210323payer_address_number_missingPayer address number is missing
210324payer_address_number_invalidPayer address number is invalid. Should have 1-20 characters
210325payer_address_complement_missingPayer address complement is missing
210326payer_address_complement_invalidPayer address complement is invalid. Should have 1-40 characters
210327payer_address_district_missingPayer address district is missing
210328payer_address_district_invalidPayer address district is invalid. Should have 1-60 characters
210329payer_address_state_missingPayer address state is missing
210330payer_address_state_invalidPayer address state is invalid. Should have 2 characters (e.g.: SP)
210331payer_address_city_missingPayer address city is missing
210332payer_address_city_invalidPayer address city is invalid. Should have 1-60 characters
210333payer_address_country_missingPayer address country is missing
210334payer_address_country_invalidPayer address country is invalid. Should have 2 characters (e.g.: BR)
210335payer_address_zip_code_missingPayer address zip code is missing
210336payer_address_zip_code_invalidPayer address zip code is invalid. Should have 8 characters
210337payer_underagedMinor (individual under 18 y.o.) is prohibited from engaging in transactions within this business sector.
210338payer_irregular_registerPayer is not compliant with our internal policies.
210339payer_name_does_not_matchThe 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.
210340payer_legal_constraintsPayer is not compliant with international standards.
210341payer_deceasedThe payer document indicates the demise of the individual. Consequently, it is recommended that this user be barred from your system controls.
210342payer_not_foundFailure to retrieve the individual document.
210343payer_national_id_inactiveThe payer document is inactive.
210344payer_national_id_cancelledDue to some administrative measures, the document may be cancelled.
210345payer_legal_data_unavailableFailure to retrieve legal information for the individual document. Kindly attempt your request again.
210401shipping_missingShipping is missing. Required when Cart has an item of type physical.
210402shipping_invalidShipping is invalid
210403shipping_cost_missingShipping cost is missing
210404shipping_cost_invalidShipping cost is invalid
210405shipping_address_missingShipping address is missing
210406shipping_address_invalidShipping address is invalid
210407shipping_address_street_missingShipping address street is missing
210408shipping_address_street_invalidShipping address street is invalid. Should have 1-160 characters
210409shipping_address_number_missingShipping address number is missing
210410shipping_address_number_invalidShipping address number is invalid. Should have 1-20 characters
210411shipping_address_complement_missingShipping address complement is missing
210412shipping_address_complement_invalidShipping address complement is invalid. Should have 1-40 characters
210413shipping_address_district_missingShipping address district is missing
210414shipping_address_district_invalidShipping address district is invalid. Should have 1-60 characters
210415shipping_address_state_missingShipping address state is missing
210416shipping_address_state_invalidShipping address state is invalid. Should have 2 characters (e.g.: SP)
210417shipping_address_city_missingShipping address city is missing
210418shipping_address_city_invalidShipping address city is invalid. Should have 1-60 characters
210419shipping_address_country_missingShipping address country is missing
210420shipping_address_country_invalidShipping address country is invalid. Should have 2 characters (e.g.: BR)
210421shipping_address_zip_code_missingShipping address zip code is missing
210422shipping_address_zip_code_invalidShipping address zip code is invalid. Should have 8 characters
210501cart_missingCart is missing
210502cart_invalidCart is invalid
210503cart_[0‑9]_description_missingCart description is missing
210504cart_[0‑9]_description_invalidCart description is invalid. Should have 1-200 characters
210505cart_[0‑9]_category_missingCart category is missing
210506cart_[0‑9]_category_invalidCart category is invalid. Shoud have 1-64 characters
210507cart_[0‑9]_quantity_missingCart quantity is missing
210508cart_[0‑9]_quantity_invalidCart quantity is invalid. Should be grather than 1
210509cart_[0‑9]_unit_price_missingCart unit price is missing
210510cart_[0‑9]_unit_price_invalidCart unit price is invalid. Should be greather than 0.01
210511cart_[0‑9]_type_missingCart type is missing
210512cart_[0‑9]_type_invalidCart type is invalid. Valid values: digital, physical, service or subscription
210601unavailable_payment_methodThe choosen payment method is not avaliable (see more)
210602payment_exceed_limitsPayment exceed the limit purchase (only for Brazil, R$ 10000) by Payer Document
210603payer_blacklistedPayer is blacklisted by our risk analysis and must contact PagSeguro's Customer Support
210604payer_blacklisted_by_pspPayer is blacklisted by our PSP and must contact PagSeguro's Customer Support
210605charge_[0‑9]_payment_info_code_not_foundPayment method was not found for the payment method code given or is not active
210005body_invalidPayment method code and direct-token cannot be sent in the same request

📘

Notice URL Params

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

Refund API

CodeKeyDescription
20601internal_server_error
20604partner_not_foundThe store-id sent does not exist
20605payment_does_not_accept_refundThe payment method used in the transaction does not accept refunds
20607refund_already_requestedA refund for the referred transaction is already being processed
20608refund_amount_is_greater_than_limitAn amount smaller than the transaction value + refund already requested is required
20609refund_amount_is_greater_than_transactionThe amount sent is greater than the transaction value
20610refund_not_foundRefund not found
20612service_refund_access_not_authorizedThe merchant does not have permission to request refunds
20613transaction_is_resellerMerchant category does not allow refunds
20614transaction_not_foundTransaction not found
20615transaction_status_not_accept_refundThe current status of the transaction does not allow refunds
20621expired_refund_requestDeadline for refund exceeded
20622partial_refund_not_allowedPartial refund not allowed
20698Property missing, invalid constraint / type or invalid data.
20699unknown_error

Transaction Search API

CodeKeyDescription
22100initial_order_date_invalidInitial order date has an invalid format
22101final_order_date_invalidFinal order date has an invalid format
22102initial_payment_date_invalidInitial payment date has an invalid format
22103final_payment_date_invalidFinal payment date has an invalid format
22104initial_last_status_change_date_invalidInitial last status change date has an invalid format
22105final_last_status_change_date_invalidFinal last status change date has an invalid format
22106initial_order_date_is_mandatory_to_filter_by_final_order_dateInitial order date is mandatory to filter by final order date
22107final_order_date_must_be_greater_than_initial_order_dateInitial order date must be greater than final order date
22108initial_payment_date_is_mandatory_to_filter_by_final_payment_dateInitial payment date is mandatory to filter by final payment date
22109final_payment_date_must_be_greater_than_initial_payment_dateInitial payment date must be greater than final payment date
22110initial_last_status_change_date_is_mandatory_to_filter_by_final_last_status_change_dateInitial last status change date is mandatory to filter by final last status change date
22111final_last_status_change_date_must_be_greater_than_initial_last_status_change_dateInitial last status change date must be greater than final last status change date
22112final_order_date_range_exceededOrder date range date exceeded
22113final_payment_date_range_exceededOrder payment range date exceeded
22114final_last_status_change_date_range_exceededOrder last status change range date exceeded
22115page_invalidPage has an invalid format
22116max_page_results_invalidMax page results has an invalid format
22117any_initial_date_is_mandatory_for_multiple_recordsTransactionCode or any initial-date is mandatory
22118status_invalidTransaction status provided is invalid
22119Status_not_existsTransaction status provided does not exists