Rejection reasons payin
One of the most likely reasons for receiving a status code 400 in response to a request is compliance validation. In this scenario, the status will be set to false, indicating that the request was not fulfilled. Additionally, additional details will be provided to facilitate understanding of the error.Data Object
Upon receiving this error code, review the details provided in the Data object to understand the nature of the restriction and take appropriate action to correct the request:- Code: Indicates the specific type of restriction that caused the error
- Description: Provides a brief description of the reason for the error
Rejection Codes
restriction_overdue
restriction_overdue
Code:
restriction_overdueDescription EN: Rejected due to document restrictionDescription PT-BR: Rejeição devido a restrição de documentorestriction_underage
restriction_underage
Code:
restriction_underageDescription EN: Rejected due to document restriction underage Brazilian lawDescription PT-BR: Rejeição devido a restrição de documento menor de idade pela lei brasileirarestriction_deceased_holder
restriction_deceased_holder
Code:
restriction_deceased_holderDescription EN: Rejected due to document restriction deceased holderDescription PT-BR: Rejeição devido a restrição de documento de falecidorestriction_canceled
restriction_canceled
Code:
restriction_canceledDescription EN: Rejected due to document restriction canceled documentDescription PT-BR: Rejeição devido a restrição de documento canceladorestriction_unknown
restriction_unknown
Code:
restriction_unknownDescription EN: Rejected due to document restriction unknown documentDescription PT-BR: Rejeição devido a restrição de documento não encontrado na Receita Federalrestriction_pending_regularization
restriction_pending_regularization
Code:
restriction_pending_regularizationDescription EN: Rejected due to document restriction pending of regularizationDescription PT-BR: Rejeição devido a restrição de documento pendente de atualizaçãorestriction_suspended
restriction_suspended
Code:
restriction_suspendedDescription EN: Rejected due to document restriction suspendedDescription PT-BR: Rejeição devido a restrição de documento suspensorestriction_partners_and_ownership
restriction_partners_and_ownership
Code:
restriction_partners_and_ownershipDescription EN: Rejected due to document restriction partners and ownershipDescription PT-BR: Rejeição devido a restrição de documento de sócios e titularidadesrestriction_judicial_block
restriction_judicial_block
Code:
restriction_judicial_blockDescription EN: Rejected due to document restriction judicial blockDescription PT-BR: Rejeição devido a restrição de documento bloqueio judicialrestriction_cpf_irregular
restriction_cpf_irregular
Code:
restriction_cpf_irregularDescription EN: Rejected due to document restrictionDescription PT-BR: Rejeição devido a restrição de documentorestriction_list_restrict
restriction_list_restrict
Code:
restriction_list_restrictDescription EN: Rejected due to document restrictionDescription PT-BR: Rejeição devido a restrição de documentorestriction_pep
restriction_pep
Code:
restriction_pepDescription EN: Rejected due to document restriction PEP (Politically Exposed Person)Description PT-BR: Rejeição devido a restrição de documento PEP (Pessoa Politicamente Exposta)restriction_age_above_limit
restriction_age_above_limit
Code:
restriction_age_above_limitDescription EN: Rejected due to restriction age as per compliance policyDescription PT-BR: Rejeição devido a restrição de idade conforme política de conformidaderestriction_ofac
restriction_ofac
Code:
restriction_ofacDescription EN: Rejected due to document restriction on OFAC listDescription PT-BR: Rejeição devido a restrição de documento na lista do OFACrestriction_interpol
restriction_interpol
Code:
restriction_interpolDescription EN: Rejected due to document restriction on INTERPOL listDescription PT-BR: Rejeição devido a restrição de documento na lista da INTERPOLrestriction_onu
restriction_onu
Code:
restriction_onuDescription EN: Rejected due to document restriction on ONU listDescription PT-BR: Rejeição devido a restrição de documento na lista da ONUrestriction_euro
restriction_euro
Code:
restriction_euroDescription EN: Rejected due to document restriction on EURO listDescription PT-BR: Rejeição devido a restrição de documento na lista da EUROError Response Example
Handling Rejection Errors
1
Identify the Error Code
Check the
code field in the response to identify the specific restriction type.2
Review the Description
Read the
description field to understand the reason for rejection.3
Take Corrective Action
Based on the error code, take appropriate action:
- Update document information
- Verify customer age and eligibility
- Check compliance requirements
- Contact support if needed
4
Retry the Request
After correcting the issue, retry the payin creation request.
Common Scenarios
Underage Customer
Code:
restriction_underageSolution: Verify customer age. Brazilian law requires customers to be 18+ for financial transactions.Invalid Document
Code:
restriction_canceled or restriction_unknownSolution: Verify document number is correct and valid with Brazilian Federal Revenue.PEP Restriction
Code:
restriction_pepSolution: Additional compliance checks required for Politically Exposed Persons.Judicial Block
Code:
restriction_judicial_blockSolution: Document has judicial restrictions. Customer must resolve legal issues.Best Practices
Validate Documents Early: Implement document validation before attempting to create a payin to provide better user experience.

