> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superpagamentos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Guia de Erros

Este documento lista todos os possíveis códigos de erro que podem ser retornados pelas APIs da Super. Os erros são retornados no parâmetro `returnCode` e estão organizados por categorias para facilitar a identificação e resolução de problemas.

## Erros de Autenticação

| Código | Descrição                       | Causa Provável                         |
| ------ | ------------------------------- | -------------------------------------- |
| -1000  | USER\_NOT\_FOUND                | Usuário não encontrado no sistema      |
| -1100  | USER\_NOT\_PERMITTED            | Usuário não está permitido             |
| -1200  | INVALID\_KEYS                   | Chaves de autenticação inválidas       |
| -1300  | INVALID\_REFRESHTOKEN           | Token de atualização inválido          |
| -1400  | INVALID\_PHONE\_NUMBER          | Número de telefone inválido            |
| -1500  | INVALID\_RESET\_TOKEN\_PASSWORD | Token de redefinição de senha inválido |
| -1800  | COMPANY\_NOT\_APPROVED          | Empresa ainda não foi aprovada         |

## Erros do Sistema

| Código | Descrição                 | Causa Provável                           |
| ------ | ------------------------- | ---------------------------------------- |
| -9999  | UNEXPECTED\_ERROR         | Erro inesperado no sistema               |
| -7000  | UNEXPECTED\_PARAMS\_ERROR | Erro inesperado em parâmetros do sistema |

## Erros internos

| Código | Descrição                                         | Causa Provável                     |
| ------ | ------------------------------------------------- | ---------------------------------- |
| -7200  | SELLER\_ALREADY\_EXISTS                           | Vendedor já existe no sistema      |
| -7201  | INVALID\_SELLER\_DATA                             | Dados do vendedor inválidos        |
| -7202  | SELLER\_CREATION\_FAILED                          | Falha ao criar vendedor            |
| -7203  | SELLER\_NOT\_FOUND                                | Vendedor não encontrado            |
| -7204  | SELLER\_UPDATE\_FAILED                            | Falha ao atualizar vendedor        |
| -7205  | SELLER\_DELETE\_FAILED                            | Falha ao deletar vendedor          |
| -7206  | SELLER\_DOCUMENT\_ALREADY\_EXISTS                 | Documento do vendedor já existe    |
| -7207  | CUSTOMER\_CREATION\_FAILED                        | Falha ao criar cliente             |
| -7208  | CARD\_TOKENIZATION\_FAILED                        | Falha na tokenização do cartão     |
| -7209  | CARD\_TOKENIZATION\_FAILED\_INVALID\_CARD\_NUMBER | Número do cartão inválido          |
| -7210  | SUSPEND\_SUBSCRIPTION\_ERROR\_IN                  | Erro ao suspender assinatura       |
| -7211  | REACTIVATE\_SUBSCRIPTION\_ERROR\_IN               | Erro ao reativar assinatura        |
| -7212  | UPDATE\_SUBSCRIPTION\_ERROR\_IN                   | Erro ao atualizar assinatura       |
| -7213  | REMOVE\_SUBSCRIPTION\_ERROR\_IN                   | Erro ao remover assinatura         |
| -7214  | CREATE\_PIX\_PAYMENT\_ERROR                       | Erro ao criar pagamento PIX        |
| -7215  | CREATE\_CARD\_PAYMENT\_ERROR                      | Erro ao criar pagamento com cartão |
| -7216  | CREATE\_BANK\_ACCOUNT\_ERROR\_IN                  | Erro ao criar conta bancária       |
| -7217  | INVALID\_CARD\_NUMBER                             | Número do cartão inválido          |
| -7218  | CREATE\_BILLET\_PAYMENT\_ERROR                    | Erro ao criar pagamento via boleto |
| -7219  | INVALID\_CUSTOMER\_DATA                           | Dados do cliente inválidos         |
| -7220  | INVALID\_ADDRESS\_DATA                            | Dados do endereço inválidos        |
| -7221  | INVALID\_LATE\_FEE\_DATA                          | Dados de multa inválidos           |
| -7222  | INVALID\_INTEREST\_DATA                           | Dados de juros inválidos           |
| -7223  | INSUFFICIENT\_BALANCE                             | Saldo insuficiente                 |

## Erros de Subconta

| Código | Descrição                                   | Causa Provável                            |
| ------ | ------------------------------------------- | ----------------------------------------- |
| -7300  | SUBCOMPANY\_ALREADY\_EXISTS                 | Subconta já existe                        |
| -7301  | INVALID\_SUBCOMPANY\_DATA                   | Dados da subconta inválidos               |
| -7302  | SUBCOMPANY\_CREATION\_FAILED                | Falha ao criar subconta                   |
| -7303  | SUBCOMPANY\_NOT\_FOUND                      | Subconta não encontrada                   |
| -7304  | SUBCOMPANY\_UPDATE\_FAILED                  | Falha ao atualizar subconta               |
| -7305  | SUBCOMPANY\_DELETE\_FAILED                  | Falha ao deletar subconta                 |
| -7306  | SUBCOMPANY\_INTERN\_CREATION\_FAILED        | Falha ao criar subconta internamente      |
| -7307  | SUBCOMPANY\_BANK\_ACCOUNT\_CREATION\_FAILED | Falha ao criar conta bancária da subconta |
| -7308  | SUBCOMPANY\_NOT\_APPROVED                   | Subconta não aprovada                     |

## Erros de Conta Bancária

| Código | Descrição                                | Causa Provável                        |
| ------ | ---------------------------------------- | ------------------------------------- |
| -7100  | BANK\_ACCOUNT\_NOT\_FOUND                | Conta bancária não encontrada         |
| -7101  | BANK\_ACCOUNT\_NOT\_BELONGS\_TO\_COMPANY | Conta bancária não pertence à empresa |
| -7102  | INVALID\_BANK\_ACCOUNT\_DATA             | Dados da conta bancária inválidos     |
| -7001  | CANNOT\_DELETE\_LAST\_ACCOUNT            | Não é possível deletar a última conta |

## Erros de Cliente

| Código | Descrição                           | Causa Provável                     |
| ------ | ----------------------------------- | ---------------------------------- |
| -7400  | CUSTOMER\_NOT\_FOUND                | Cliente não encontrado             |
| -7401  | CUSTOMER\_NOT\_BELONGS\_TO\_COMPANY | Cliente não pertence à empresa     |
| -7402  | INVALID\_CUSTOMER\_DATA             | Dados do cliente inválidos         |
| -7403  | CUSTOMER\_CREATION\_FAILED          | Falha ao criar cliente             |
| -7404  | CUSTOMER\_UPDATE\_FAILED            | Falha ao atualizar cliente         |
| -7405  | CUSTOMER\_DELETE\_FAILED            | Falha ao deletar cliente           |
| -7406  | CUSTOMER\_ADDRESS\_NOT\_FOUND       | Endereço do cliente não encontrado |

## Erros de Cartão

| Código | Descrição                  | Causa Provável                 |
| ------ | -------------------------- | ------------------------------ |
| -7500  | INVALID\_CARD\_DATA        | Dados do cartão inválidos      |
| -7501  | CARD\_TOKENIZATION\_FAILED | Falha na tokenização do cartão |
| -7502  | CARD\_IS\_EXPIRED          | Cartão expirado                |
| -7503  | CARD\_IS\_INVALID          | Cartão inválido                |
| -7504  | CARD\_IS\_BLOCKED          | Cartão bloqueado               |
| -7505  | CARD\_IS\_FRAUD            | Cartão marcado como fraude     |
| -7506  | CARD\_IS\_LOST             | Cartão reportado como perdido  |
| -7507  | CARD\_IS\_STOLEN           | Cartão reportado como roubado  |
| -7508  | CARD\_NOT\_FOUND           | Cartão não encontrado          |
| -7509  | CARD\_DELETION\_FAILED     | Falha ao deletar cartão        |

## Erros de Assinatura

| Código | Descrição                               | Causa Provável                              |
| ------ | --------------------------------------- | ------------------------------------------- |
| -7600  | SUBSCRIPTION\_CREATION\_FAILED          | Falha ao criar assinatura                   |
| -7601  | SUBSCRIPTION\_NOT\_FOUND                | Assinatura não encontrada                   |
| -7602  | SUBSCRIPTION\_UPDATE\_FAILED            | Falha ao atualizar assinatura               |
| -7603  | SUBSCRIPTION\_DELETE\_FAILED            | Falha ao deletar assinatura                 |
| -7604  | INVALID\_SUBSCRIPTION\_DATA             | Dados da assinatura inválidos               |
| -7605  | SPLIT\_AMOUNT\_EXCEEDS\_SUBSCRIPTION    | Valor do split excede o valor da assinatura |
| -7606  | SPLIT\_PERCENTAGE\_NOT\_FOUND           | Percentual do split não encontrado          |
| -7607  | SPLIT\_AMOUNT\_NOT\_FOUND               | Valor do split não encontrado               |
| -7608  | SELLER\_ID\_NOT\_FOUND                  | ID do vendedor não encontrado               |
| -7609  | INTERN\_PLAN\_CREATION\_FAILED          | Falha ao criar plano internamente           |
| -7610  | INTERN\_SUBSCRIPTION\_CREATION\_FAILED  | Falha ao criar assinatura internamente      |
| -7611  | CUSTOMER\_NOT\_FOUND                    | Cliente não encontrado                      |
| -7612  | TOKENIZED\_CARD\_NOT\_FOUND             | Cartão tokenizado não encontrado            |
| -7613  | SUBSCRIPTION\_NOT\_BELONGS\_TO\_COMPANY | Assinatura não pertence à empresa           |
| -7614  | INTERN\_ERROR                           | Erro na integração interna                  |
| -7615  | INVALID\_DATE\_FORMAT                   | Formato de data inválido                    |
| -7616  | INVALID\_DATE                           | Data inválida                               |
| -7617  | SUBSCRIPTION\_ALREADY\_SUSPENDED        | Assinatura já está suspensa                 |
| -7618  | SUBSCRIPTION\_NOT\_SUSPENDED            | Assinatura não está suspensa                |
| -7619  | SUBSCRIPTION\_NOT\_REACTIVATED          | Assinatura não foi reativada                |
| -7620  | REMOVE\_SPLIT\_ERROR                    | Erro ao remover split                       |
| -7621  | SPLIT\_NOT\_FOUND                       | Split não encontrado                        |
| -7622  | ADD\_SPLIT\_ERROR                       | Erro ao adicionar split                     |
| -7623  | SUBSCRIPTION\_NOT\_DELETED              | Assinatura não foi deletada                 |
| -7624  | SUBSCRIPTION\_ALREADY\_DELETED          | Assinatura já foi deletada                  |
| -7625  | REMOVE\_SUBSCRIPTION\_ERROR             | Erro ao remover assinatura                  |
| -7626  | SUBSCRIPTION\_IS\_CANCELED              | Assinatura está cancelada                   |
| -7627  | SUBSCRIPTION\_IS\_DELETED               | Assinatura está deletada                    |

## Erros de Pagamento

| Código | Descrição                           | Causa Provável                             |
| ------ | ----------------------------------- | ------------------------------------------ |
| -7700  | INVALID\_PAYMENT\_METHOD            | Método de pagamento inválido               |
| -7701  | SPLIT\_AMOUNT\_EXCEEDS\_TRANSACTION | Valor do split excede o valor da transação |
| -7702  | INVALID\_CUSTOMER\_DATA             | Dados do cliente inválidos                 |
| -7703  | INVALID\_CARD\_DATA                 | Dados do cartão inválidos                  |
| -7704  | INVALID\_BILLING\_DATA              | Dados de cobrança inválidos                |
| -7705  | INVALID\_SPLIT\_DATA                | Dados do split inválidos                   |
| -7706  | INVALID\_LATE\_FEE\_DATA            | Dados de multa inválidos                   |
| -7707  | INVALID\_INTEREST\_DATA             | Dados de juros inválidos                   |
| -7708  | PAYMENT\_NOT\_FOUND                 | Pagamento não encontrado                   |
| -7709  | INVALID\_PAYMENT\_STATUS            | Status do pagamento inválido               |
| -7710  | REFUND\_FAILED                      | Falha ao realizar reembolso                |

<Note>
  Em caso de dúvidas sobre algum código de erro específico, entre em contato com nosso suporte técnico.
</Note>
