application/problem+json. O esquema Detail desta referência de API descreve esse corpo, que segue a RFC 9457.
{
"type": "https://errors.lerian.studio/v1/PIX-0012",
"title": "PIX Key Not Found",
"status": 404,
"detail": "The specified PIX key was not found in the system. Please verify the key value and try again.",
"code": "PIX-0012"
}
code– Código de erro de domínio estável e legível por máquina, limitado ao serviço que o emite. Nesta API, ele tem a formaPIX-NNNN.title– Um resumo curto e legível do tipo de problema. Recomenda-se que esse valor não mude entre ocorrências do erro.detail– Uma explicação legível específica para esta ocorrência do problema.status– O código de status HTTP.type– Um URI que identifica o erro no catálogo de erros da Lerian, construído comohttps://errors.lerian.studio/v1/<code>.instance– Uma referência de URI que identifica a ocorrência específica do problema.errors– Uma lista opcional de detalhes por campo. Cada entrada traz olocationque falhou, umamessagee ovaluedaquele local.upstream– Um membro de extensão da RFC 9457. Ele traz o código e a mensagem relatados por um provedor terceiro por trás de um proxy, e fica ausente a menos que o serviço tenha exposto um.
detail que o serviço envia por padrão. Quando o serviço monta esse texto a partir da requisição que falhou, a linha indica isso.
A partir do status 500, a resposta carrega texto fixo, não a causa bruta. A coluna detail mostra se um código envia internal error ou uma frase que o serviço escreveu para ele.
Requisições e regras de negócio do serviço Pix
Esses códigos vêm do próprio serviço Pix. Eles cobrem validação de requisição, gestão de chaves Pix, reivindicação de chaves, ordens de pagamento, devoluções, QR codes, participantes indiretos, créditos recebidos e créditos em espera.
Validação de requisição e acesso
code | Descrição | detail |
|---|---|---|
PIX-0001 | 400 Erro de validação de campo | Um ou mais campos contêm erros de validação. Verifique o objeto de campos para obter detalhes e corrija os valores inválidos. |
PIX-0002 | 400 Requisição inválida | Definido pela operação que gerou o erro. |
PIX-0003 | 400 Campos inesperados | Definido pela operação que gerou o erro. |
PIX-0004 | 401 Não autorizado | Definido pela operação que gerou o erro. |
PIX-0005 | 403 Proibido | Definido pela operação que gerou o erro. |
PIX-0006 | 404 Não encontrado | Definido pela operação que gerou o erro. |
PIX-0007 | 409 Conflito | Definido pela operação que gerou o erro. |
PIX-0008 | 422 Entidade não processável | Definido pela operação que gerou o erro. |
PIX-0009 | 429 Muitas requisições | Definido pela operação que gerou o erro. |
PIX-0058 | 400 ID inválido | O ID fornecido é inválido ou malformado. Verifique o formato do ID e tente novamente. |
PIX-0059 | 401 Token inválido | O token fornecido é inválido ou expirou. Obtenha um novo token e tente novamente. |
PIX-0060 | 400 Localização obrigatória | Informações de localização são obrigatórias para esta operação. Forneça dados de localização válidos. |
PIX-0061 | 400 Parâmetros inválidos | Um ou mais parâmetros da requisição são inválidos. Verifique os valores dos parâmetros e tente novamente. |
PIX-0062 | 400 Informação inválida | A informação fornecida é inválida ou está incompleta. Verifique todos os campos e tente novamente. |
PIX-0082 | 401 Autenticação obrigatória | Credenciais de autenticação válidas são obrigatórias para acessar este recurso. Forneça um bearer token válido. |
PIX-0083 | 403 Acesso proibido | Você não tem permissões suficientes para executar esta ação. Entre em contato com o suporte se você acredita que isso é um erro. |
PIX-0084 | 400 Erro de validação da requisição | A validação da requisição falhou. Verifique todos os campos obrigatórios e tente novamente. |
Chaves Pix
code | Descrição | detail |
|---|---|---|
PIX-0010 | 422 Formato de chave Pix inválido | O formato da chave PIX é inválido para o tipo especificado. Verifique se o formato corresponde ao padrão esperado e tente novamente. |
PIX-0011 | 409 Chave Pix já existe | Já existe uma chave PIX com este valor. Use uma chave PIX diferente. |
PIX-0012 | 404 Chave Pix não encontrada | A chave PIX especificada não foi encontrada no sistema. Verifique o valor da chave e tente novamente. |
PIX-0013 | 429 Limite de chaves Pix excedido | Você atingiu o número máximo de chaves PIX permitido. Exclua uma chave existente antes de criar uma nova. |
PIX-0014 | 422 Tipo de chave Pix inválido | O tipo de chave PIX não é válido para esta operação. Use um tipo de chave aceito. |
PIX-0015 | 422 Chave Pix expirada | Definido pela operação que gerou o erro. |
PIX-0016 | 422 Chave Pix pendente de confirmação | Definido pela operação que gerou o erro. |
PIX-0017 | 422 Chave Pix inativa | Definido pela operação que gerou o erro. |
PIX-0018 | 403 Exclusão de chave Pix não permitida | Esta chave PIX não está registrada na conta informada, portanto não pode ser excluída. Verifique a chave e a conta. |
PIX-0067 | 422 Chave Pix expirada | A chave PIX expirou e não pode ser usada. Crie uma nova chave PIX. |
PIX-0068 | 422 Confirmação de chave Pix obrigatória | A chave PIX exige confirmação antes da ativação. Verifique seu e-mail ou SMS em busca do código de confirmação. |
PIX-0069 | 404 Chave Pix não encontrada | A chave PIX especificada não foi encontrada no sistema. Verifique o valor da chave e tente novamente. |
PIX-0070 | 422 Chave Pix inválida | A chave PIX é inválida ou foi desativada. Use uma chave PIX válida. |
PIX-0071 | 409 Chave Pix já possuída | Você já possui esta chave PIX. Cada chave PIX pode ser associada a apenas uma conta. |
PIX-0072 | 422 Limite de chaves Pix excedido | Você atingiu o número máximo de chaves PIX permitido. Exclua uma chave existente antes de criar uma nova. |
PIX-0073 | 422 Status de chave Pix inválido | A chave PIX não está em um status válido para esta operação. Verifique o status da chave. |
PIX-0074 | 404 Chave Pix interna não encontrada | A referência interna da chave PIX não foi encontrada. Entre em contato com o suporte. |
PIX-0086 | 422 Divergência de documento | O documento da conta não corresponde ao documento associado à chave PIX. Apenas o dono da chave pode reivindicá-la. |
Reivindicações de chave Pix
code | Descrição | detail |
|---|---|---|
PIX-0020 | 404 Reivindicação não encontrada | A reivindicação especificada não foi encontrada para esta conta. Verifique o ID da reivindicação e tente novamente. |
PIX-0021 | 409 Reivindicação já existe | Definido pela operação que gerou o erro. |
PIX-0022 | 422 Reivindicação de chave Pix ou instrução agendada está em um status que esta ação não permite | A autorização do Pix Automático não está em um status válido para esta operação. Verifique o status da autorização. |
PIX-0023 | 422 Reivindicação expirada | Definido pela operação que gerou o erro. |
PIX-0024 | 403 Ação não autorizada na reivindicação | Definido pela operação que gerou o erro. |
PIX-0025 | 409 Reivindicação já processada | Definido pela operação que gerou o erro. |
PIX-0026 | 422 Dados de reivindicação inválidos | Definido pela operação que gerou o erro. |
PIX-0027 | 400 Reivindicação indica um participante que não corresponde ao registro da chave | Definido pela operação que gerou o erro. |
Transações e pagamentos
code | Descrição | detail |
|---|---|---|
PIX-0028 | 404 Transação não encontrada | Definido pela operação que gerou o erro. |
PIX-0029 | 409 Transação duplicada | Já existe uma transação com este identificador. Use um ID de transação exclusivo. |
PIX-0030 | 422 Valor de transação inválido | O valor da transação é inválido. Forneça um valor positivo válido. |
PIX-0031 | 400 Saldo insuficiente | Definido pela operação que gerou o erro. |
PIX-0032 | 409 Limite de transação excedido | Definido pela operação que gerou o erro. |
PIX-0033 | 422 Dados do destinatário inválidos | Os dados do destinatário são inválidos. Verifique todas as informações do destinatário. |
PIX-0034 | 422 Transação expirada | Definido pela operação que gerou o erro. |
PIX-0035 | 422 Transação cancelada | Definido pela operação que gerou o erro. |
PIX-0036 | 422 Status de transação inválido | A transição de status da transação não é permitida para o estado atual. |
PIX-0037 | 422 ID end-to-end inválido | O id end-to-end é inválido para esta ordem de pagamento. Verifique o valor e tente novamente. |
PIX-0075 | 409 Limite de transação excedido | O valor da transação excede seus limites configurados. Tente um valor menor ou entre em contato com o suporte para aumentar seus limites. |
PIX-0076 | 409 Saldo insuficiente | Sua conta não tem saldo suficiente para esta transação. Adicione fundos à sua conta e tente novamente. |
PIX-0077 | 409 Transferência para o mesmo Bank ID não permitida | Transferências para o mesmo Bank ID não são permitidas para esta operação. Use um destino diferente. |
PIX-0078 | 409 Transferência para a mesma conta não permitida | Transferências para a mesma conta não são permitidas. Use uma conta de destino diferente. |
PIX-0090 | 422 Saldo insuficiente para bloqueio | A conta transacional do pagador não tem saldo suficiente para reservar o débito agendado. (SGCTPIX001) |
PIX-0091 | 500 Bloqueio rejeitado | internal error |
PIX-0127 | 422 Participante pagador obrigatório | Este tenant atua como vários participantes diretos, então a ordem deve nomear aquele que paga. Envie payerIspb e tente novamente. |
PIX-0128 | 422 Participante pagador desconhecido | O participante pagador informado não é um participante direto como o qual este tenant atua. Verifique payerIspb e tente novamente. Quando a ordem carregou um payerIspb, o detail o anexa. |
PIX-0129 | 422 Recebedor on-us não mantido aqui | A conta recebedora está neste participante, mas não é mantida nestes livros, então não pode ser creditada como uma transferência interna. Nenhum fundo foi reservado e nenhuma transferência foi registrada. Quando a ordem carregou um ISPB do recebedor, o detail o anexa. |
PIX-0130 | 503 Mapa de titularidade indisponível | internal error |
PIX-0131 | 502 Mapa de titularidade inutilizável | internal error |
PIX-0132 | 422 Registro do recebedor não pode servir de chave | A conta recebedora está neste participante, mas a agência ou a conta no registro não podem ser usadas para estabelecer quais livros a mantêm. Nenhum fundo foi reservado e nenhuma transferência foi registrada. |
PIX-0133 | 409 Ordem anterior recusada | A ordem anterior enviada com esta chave de idempotência foi recusada e não moveu dinheiro. Para pagar, envie uma nova ordem com uma nova chave de idempotência, e um novo endToEndId se você o fornecer. |
PIX-0134 | 422 Divergência de documento do recebedor on-us | A conta recebedora pertence a um titular diferente do indicado pelo documento do recebedor, então não pode ser creditada. Nenhum fundo foi reservado e nenhuma transferência foi registrada. Verifique payee.document em relação a payee.branch, payee.accountNumber e payee.accountDigit. |
PIX-0136 | 409 Assinatura de pagamento mal configurada | Composto pelo serviço. Diz que a ordem de pagamento não foi enviada porque não pode ser assinada, nomeia o item de assinatura a corrigir e o motivo, e diz que nenhum dinheiro se moveu. Veja Assinatura da ordem de pagamento. |
PIX-0145 | 422 Recebedor on-us recusou | A conta recebedora está neste participante e recusou o crédito. Nenhum fundo foi debitado: o valor reservado foi liberado. Verifique o recebedor antes de tentar novamente. |
PIX-0146 | 503 Recebedor on-us inalcançável | A conta recebedora está neste participante e não pôde ser alcançada. Nenhum fundo foi debitado: o valor reservado foi liberado. Tente novamente mais tarde com uma nova requisição. |
PIX-0149 | 409 Tarifa configurada para descontar do valor | A tarifa de um pagamento para uma conta neste participante está configurada para ser descontada do valor; ela tem que ser cobrada à parte. Nenhum fundo foi debitado: o valor reservado será liberado. Entre em contato com o suporte. |
PIX-0150 | 409 Conta de compensação ausente | O ledger não tem uma conta @intercore, pela qual passa um pagamento para uma conta neste participante mantida em outros livros. Nenhum fundo foi debitado. Um operador precisa criar a conta @intercore na organização <organizationId>, ledger <ledgerId>; repetir esta requisição sem essa mudança falha da mesma forma. |
PIX-0162 | 422 Contexto de tarifa não aceito | Composto pelo serviço. Diz que nenhum pacote de tarifas do ledger do pagador seleciona pelo rótulo feeContext, ou que o ledger do pagador não precifica Pix por pacote de tarifas. Diz que nada ficou retido. |
Devoluções e reembolsos
code | Descrição | detail |
|---|---|---|
PIX-0038 | 403 Devolução não permitida | Definido pela operação que gerou o erro. |
PIX-0039 | 422 Motivo de devolução inválido | Definido pela operação que gerou o erro. |
PIX-0040 | 422 Valor da devolução excede o original | Definido pela operação que gerou o erro. |
PIX-0041 | 403 Prazo de devolução expirado | Definido pela operação que gerou o erro. |
PIX-0042 | 404 Transação original não encontrada | Definido pela operação que gerou o erro. |
PIX-0087 | 400 Não é possível reembolsar a própria transação | Você não pode solicitar reembolso da sua própria transação de saída. Apenas o destinatário pode solicitar um reembolso. |
PIX-0088 | 400 Não é possível reembolsar transação não recebida | Você pode solicitar reembolso apenas de transações que recebeu. |
PIX-0089 | 400 Não é possível reembolsar transação de saída | Transações de saída (CASH_OUT) não podem ser reembolsadas. Apenas transações recebidas podem ser reembolsadas. |
PIX-0135 | 422 Divergência de participante da devolução | Esta transação não foi recebida pelo participante que esta devolução nomeia. Um Pix recebido na posição de um participante indireto é devolvido por esse indireto: envie o indirectId dele. Um Pix recebido em uma conta direta é devolvido sem ele. Nenhum fundo foi movido e nenhuma devolução foi registrada. |
PIX-0142 | 409 Ledger original não configurado | O pagamento que esta devolução retorna foi lançado em um ledger que não está mais configurado para Pix neste deployment, então não pode ser devolvido aqui. Nada foi lançado e nenhuma devolução foi registrada. Um operador precisa restaurar essa configuração. |
Participantes e contas
code | Descrição | detail |
|---|---|---|
PIX-0043 | 422 Bank ID inválido | Definido pela operação que gerou o erro. |
PIX-0044 | 422 Bank ID não participante | Definido pela operação que gerou o erro. |
PIX-0045 | 422 Número de conta inválido | Definido pela operação que gerou o erro. |
PIX-0046 | 422 Conta bloqueada | Definido pela operação que gerou o erro. |
PIX-0047 | 422 Conta encerrada | Definido pela operação que gerou o erro. |
PIX-0137 | 422 Ledger da conta não configurado | A conta é mantida em um ledger que não está configurado para Pix neste participante, então não pode ser usada aqui. Nenhum fundo foi reservado e nada foi registrado. Use uma conta mantida em um ledger configurado para Pix, ou peça ao operador para adicionar o ledger dela à configuração do Pix. Quando a conta é conhecida, o detail anexa Account: <id>. |
PIX-0138 | 422 Ledger da conta indeterminado | O registro da conta neste participante não diz qual ledger a mantém, então ela não pode ser usada aqui. Nada foi reservado nem registrado. Faça o registro da conta nomear o ledger dela, ou use outra conta. Quando a conta é conhecida, o detail anexa Account: <id>. |
PIX-0139 | 422 Divergência de participante da conta | O registro da conta nomeia uma instituição diferente daquela como a qual esta operação atua, então ela não pode ser usada aqui. Nada foi reservado nem registrado. Verifique o participante nomeado na requisição. Quando a conta é conhecida, o detail anexa Account: <id>. |
PIX-0141 | 422 Conta fora dos livros do indireto | A conta pagadora é mantida em um ledger diferente daquele em que o participante indireto está montado, então não pode pagar como esse indireto. Nada foi reservado nem registrado. Quando a conta é conhecida, o detail anexa Account: <id>. |
PIX-0143 | 422 Conta ambígua | O documento ou a agência e a conta desta requisição correspondem a mais de uma conta neste participante, então a conta não pode ser determinada. Nada foi registrado. Informe a agência e a conta. |
PIX-0144 | 422 Divergência de titular da conta | A agência e a conta desta requisição pertencem a um titular diferente do documento que ela nomeia. Nada foi registrado. Confira o documento com a agência e a conta. |
PIX-0147 | 404 Registro não mantido para o participante | Nenhum registro com este identificador é mantido sob o participante direto ou indireto que a requisição nomeia, ou o registro não tem titular. Nada foi lido nem alterado. Confira o identificador. |
QR codes
code | Descrição | detail |
|---|---|---|
PIX-0048 | 422 QR code inválido | Definido pela operação que gerou o erro. |
PIX-0049 | 504 QR code expirado | internal error |
PIX-0050 | 422 QR code já usado | Definido pela operação que gerou o erro. |
PIX-0124 | 409 Escopo de ledger não atendido | Esta operação só lança na organização e no ledger padrão do Midaz do tenant, e o registro sobre o qual ela deveria agir pertence a outro, então nada foi lançado. Quando o serviço conhece a organização e o ledger do registro, o detail os anexa. |
Entidades, templates e conciliação
code | Descrição | detail |
|---|---|---|
PIX-0063 | 404 Entidade não encontrada | A entidade especificada não foi encontrada no sistema. Verifique o identificador e tente novamente. |
PIX-0064 | 409 Entidade já existe | Já existe uma entidade com este identificador. Use um identificador exclusivo. |
PIX-0065 | 409 ID de conciliação já existe | Já existe um registro com este ID de conciliação. Use um ID de conciliação exclusivo. |
PIX-0066 | 404 Template não encontrado | O template especificado não foi encontrado. Verifique o identificador do template. |
PIX-0110 | 409 Entidade já retirada | A entidade especificada já foi retirada e não pode mais receber ações. |
Fraude, conformidade e regulação
code | Descrição | detail |
|---|---|---|
PIX-0055 | 400 Fraude detectada | Definido pela operação que gerou o erro. |
PIX-0056 | 403 Violação de conformidade | Definido pela operação que gerou o erro. |
PIX-0057 | 403 Restrição regulatória | Definido pela operação que gerou o erro. |
Falhas de serviço e dependência
code | Descrição | detail |
|---|---|---|
PIX-0051 | 503 Serviço indisponível | A integração PIX está temporariamente indisponível para este tenant. Tente novamente em instantes. |
PIX-0052 | 504 Timeout | internal error |
PIX-0053 | 500 Erro interno | internal error |
PIX-0054 | 502 Erro de serviço externo | internal error |
PIX-0079 | 502 Erro de serviço externo | internal error |
PIX-0080 | 500 Erro de core banking | internal error |
PIX-0085 | 500 Erro de conexão com o banco de dados | internal error |
PIX-0109 | 500 Falha do servidor que o serviço não conseguiu atribuir a uma condição específica | internal error |
PIX-0126 | 503 Licença indisponível | internal error |
Configuração do tenant
code | Descrição | detail |
|---|---|---|
PIX-0092 | 409 Integração Pix do tenant não provisionada | A integração PIX para este tenant não foi provisionada. Entre em contato com o suporte para concluir o onboarding do tenant. |
PIX-0105 | 409 Configuração de rota do tenant ausente | A configuração de roteamento PIX para este tenant está ausente ou é inválida. Entre em contato com o suporte para concluir o onboarding do tenant. |
PIX-0106 | 409 Configuração de ledger do tenant ausente | A identidade de ledger do Midaz para este tenant não está provisionada, então nenhuma transação foi lançada. A organização de lançamento, o ledger, o ativo de lançamento e a conta externa de compensação devem estar todos definidos: a organização e o ledger nos campos organizationId e ledgerId de tenancy/jd_integration_binding, o ativo e a conta de compensação nas chaves do systemplane tenant_policy/midaz.asset_id e tenant_policy/midaz.external_id. Não há fallback por variável de ambiente para nenhum dos quatro. Apenas um operador pode fornecê-los, então repetir esta requisição sem essa mudança falhará de forma idêntica. |
PIX-0107 | 409 Criptografia de entrega indireta não provisionada. Gerado quando a chave de criptografia do segredo de entrega do tenant está ausente, em branco ou malformada, e quando nenhuma cifra está conectada. Ausente e malformada compartilham este código porque compartilham a correção: um operador altera o valor. Em um deploy self-hosted, esse valor é INDIRECTS_DELIVERY_ENCRYPTION_KEY, e deve ter exatamente 64 caracteres hexadecimais (uma chave AES-256 codificada em hexadecimal) | Nenhuma chave de criptografia do segredo de entrega está provisionada para este tenant, então o participante indireto não foi salvo e nenhum segredo foi armazenado. Deploys self-hosted definem INDIRECTS_DELIVERY_ENCRYPTION_KEY; na Lerian Cloud, a Lerian gerencia essa chave. Apenas um operador pode fornecê-la, então repetir esta requisição sem essa mudança falhará de forma idêntica. |
PIX-0108 | 422 Alias de conta do ledger não resolvido | Definido pela operação que gerou o erro. |
PIX-0121 | 409 ISPB da integração Pix do tenant inválido | A integração PIX deste tenant está configurada incorretamente: o campo “ispb” da chave systemplane tenancy/jd_integration_binding deve ter exatamente 8 letras maiúsculas ou dígitos. Entre em contato com o suporte para corrigir o binding de integração PIX do tenant. |
PIX-0122 | 503 Configuração do tenant ilegível | Uma parte da configuração deste tenant não pôde ser lida a partir do plano de configuração do tenant, então a requisição não foi executada. Não se sabe se a configuração está ausente: a leitura em si não foi concluída. Portanto, esta é uma falha do nosso lado, não uma lacuna de onboarding. Tente novamente em instantes; se persistir, entre em contato com o suporte. |
PIX-0123 | 503 Fonte da chave de entrega indireta indisponível | A chave de criptografia do segredo de entrega para este tenant não pôde ser lida da sua fonte, então o participante indireto não foi salvo e nenhum segredo foi armazenado. Não se sabe se a chave está ausente: a leitura em si não foi concluída. Portanto, esta é uma falha do nosso lado, não uma lacuna de onboarding. Tente novamente em instantes; se persistir, entre em contato com o suporte. |
PIX-0125 | 500 Escopo de ledger do tenant mal provisionado | internal error |
O status, não a família, diz se vale a pena tentar de novo. Um
409 nesta seção significa uma lacuna de provisionamento. O serviço sabe que o valor está ausente. Apenas um operador pode fornecê-lo, e repetir a requisição não pode mudar isso.Um 503 é o irmão ilegível da mesma condição. O serviço não sabe que a configuração está ausente, porque a leitura em si não foi concluída. A resposta nomeia a dependência com falha, e uma nova tentativa pode ter sucesso.Os pares são PIX-0092/PIX-0121 contra PIX-0051, PIX-0106 contra PIX-0122, e PIX-0107 contra PIX-0123.Participantes indiretos
code | Descrição | detail |
|---|---|---|
PIX-0093 | 409 Conflito de ISPB indireto | Um participante indireto com este ISPB já está registrado e ativo para este tenant. Um indireto encerrado pode ser registrado novamente, mas um aberto é único por ISPB. |
PIX-0094 | 409 Transição indireta ilegal | A mudança de ciclo de vida solicitada não é permitida para o status atual do participante indireto. |
PIX-0095 | 404 Indireto não encontrado | O participante indireto especificado não foi encontrado para este tenant. Verifique o identificador e tente novamente. |
PIX-0096 | 409 Não é possível encerrar indireto com saldo | O participante indireto não pode ser encerrado enquanto sua conta PIX mantiver fundos. Zere o saldo disponível e o valor retido e tente novamente. |
PIX-0097 | 409 Indireto não aguarda provisionamento | A nova tentativa de provisionamento apenas é válida para um participante indireto no estado PENDING_PROVISIONING. |
PIX-0098 | 422 Participante indireto inválido | A requisição do participante indireto é inválida. Verifique o nome, o ISPB, o endpoint de entrega, o secret e o modo de mensageria, e tente novamente. |
PIX-0099 | 502 Provisionamento indireto falhou | internal error |
PIX-0100 | 422 Indireto não ativo | O participante indireto especificado não está ativo e não pode originar uma transação. Reative-o e tente novamente. |
PIX-0102 | 422 Divergência de pagador indireto | O ISPB do pagador fornecido não é o participante direto ao qual este indireto está vinculado. Verifique o identificador indireto e o ISPB do pagador, e tente novamente. |
PIX-0103 | 409 Retenção de crédito não está aberta | O crédito recebido retido não está mais como PARKED (já foi resolvido ou rejeitado, possivelmente por uma requisição concorrente). Nenhuma ação adicional foi tomada. |
PIX-0104 | 409 Alvo indireto não ativo | O participante indireto alvo desta resolução não está ACTIVE e não pode receber o crédito. Reative-o ou escolha um alvo diferente. |
PIX-0111 | 422 Recurso de indiretos desabilitado | Definido pela operação que gerou o erro. |
PIX-0112 | 422 Localização do QR indireto muito longa | Definido pela operação que gerou o erro. |
PIX-0113 | 422 Host do QR indireto não é público | Definido pela operação que gerou o erro. |
PIX-0114 | 422 Indireto não tem certificado QR próprio | Definido pela operação que gerou o erro. |
PIX-0140 | 409 Livros do indireto não configurados | O participante indireto que esta requisição nomeia está montado em livros que não estão mais configurados para Pix neste deployment. Nada foi reservado nem registrado. Um operador precisa restaurar essa configuração. |
Créditos recebidos
code | Descrição | detail |
|---|---|---|
PIX-0115 | 404 Conta de cash-in não encontrada | A conta recebedora indicada por este crédito não foi encontrada neste participante, portanto nenhum crédito foi registrado. |
PIX-0116 | 409 Destino do cash-in ambíguo | O documento do recebedor indica mais de uma conta neste participante, então não é possível determinar o destino deste crédito. Nenhum crédito foi registrado. Direcione o crédito para uma conta específica (recebedor.nrAgencia e recebedor.nrConta) ou entre em contato com este participante para corrigir os registros duplicados. |
PIX-0117 | 409 Divergência de titular do cash-in | A conta endereçada por este crédito pertence a um titular diferente do indicado pelo documento do recebedor, então nenhum crédito foi registrado. Verifique recebedor.cpfCnpj em relação a recebedor.nrAgencia e recebedor.nrConta. |
PIX-0118 | 409 Conta de cash-in não creditável | A conta endereçada por este crédito existe neste participante, mas não está configurada para receber créditos, então nenhum crédito foi registrado. Entre em contato com este participante para que o registro da conta seja completado. |
PIX-0119 | 404 Recebedor do cash-in não atendido | O participante recebedor indicado por este crédito não é atendido por este participante, então nenhum crédito foi registrado. Verifique recebedor.ispb. |
PIX-0120 | 500 Ledger de cash-in mal provisionado | internal error |
PIX-0151 | 500 Saldo do cash-in não recebe. O ledger recusou o crédito porque o saldo de destino não aceita créditos. O Pix espera como PENDING, e a JD o entrega de novo. | internal error |
Créditos em espera
Esses códigos vêm das ações do operador sobre um Pix recebido que espera: Creditar um Pix recebido em espera e Devolver ao pagador um Pix recebido em espera.code | Descrição | detail |
|---|---|---|
PIX-0152 | 404 Crédito em espera não encontrado | Não existe nenhum Pix recebido com este id. Nada foi alterado. |
PIX-0153 | 409 Crédito fora de espera | Este Pix recebido não espera um operador: ele foi creditado, devolvido ou falhou, ou um crédito dele ou outra ação sobre ele está em andamento. Nada foi alterado. |
PIX-0154 | 422 Ação indisponível para o crédito em espera | Esta ação não se aplica a este Pix recebido: ele foi recebido pelo outro core, ou foi registrado sem o tipo de iniciação, ou é uma devolução recebida, que só é creditada, nunca devolvida. Nada foi alterado. |
PIX-0155 | 409 Crédito em espera já no ledger | O ledger já tem um lançamento para este Pix recebido. Nada foi alterado: um crédito liquidado é adotado ao creditá-lo, e um Pix creditado é devolvido por POST /v1/refunds. |
PIX-0156 | 409 Saldo do crédito em espera não recebe | O saldo da conta de destino ainda não aceita créditos, então nada foi lançado. O Pix recebido continua esperando: credite-o quando o saldo aceitar créditos, ou devolva-o ao pagador (uma devolução recebida só é creditada). |
PIX-0157 | 409 Destino do crédito em espera não encontrado | O ledger não conhece a conta ou a rota contábil que este crédito nomeia, então nada foi lançado. O Pix recebido continua esperando: devolva-o ao pagador, ou corrija o ledger e credite-o de novo (uma devolução recebida só é creditada). |
PIX-0158 | 409 Crédito em espera creditado no lugar | Creditado no lugar: o saldo aceita créditos ou um crédito já entrou. O Pix recebido está EXECUTED e nada foi enviado à JD; devolva-o ao pagador por POST /v1/refunds. |
PIX-0159 | 409 Crédito em espera fora da janela de reenvio | Composto pelo serviço. Diz que o Pix recebido está fora da janela de reenvio do ledger: 23 horas depois que chegou, enquanto o resultado do primeiro crédito é desconhecido, ou 7 dias menos 1 hora depois que o ledger recusou esse crédito. Diz que nenhuma ação pode provar o que um crédito anterior fez, e que nada foi alterado. Entre em contato com o suporte da Lerian. |
PIX-0160 | 409 Crédito em espera ainda pode ser lançado | Composto pelo serviço. Diz que um crédito deste Pix recebido está em andamento, ou que o ledger não respondeu a um que ainda pode ser lançado, então uma devolução poderia pagar o pagador duas vezes. Diz que nada foi alterado, e que é preciso creditar o Pix no lugar, o que o lança no máximo uma vez. Fora da janela de reenvio (PIX-0159), entre em contato com o suporte da Lerian. |
Trilho Pix e diretório de chaves
Esses códigos vêm da infraestrutura Pix conectada. O serviço traduz uma falha do trilho em um destes códigos antes de responder. Quem chama a API decide o fluxo com base no valor
PIX-NNNN, não no vocabulário próprio do trilho.
Validação de requisição e autenticação
code | Descrição | detail |
|---|---|---|
PIX-1000 | 400 Erro de validação de campo | Um ou mais campos contêm erros de validação. Verifique o objeto de campos para obter detalhes e corrija os valores inválidos. |
PIX-1001 | 400 Requisição inválida | O servidor não conseguiu entender a requisição devido a sintaxe malformada. Verifique o formato da requisição e tente novamente. |
PIX-1002 | 400 Campos inesperados na requisição | O corpo da requisição contém mais campos do que o esperado. Envie apenas os campos permitidos conforme a documentação. |
PIX-1003 | 401 Não autorizado | As credenciais de autenticação estavam ausentes ou incorretas. Forneça credenciais válidas. |
PIX-1004 | 403 Proibido | O servidor entendeu a requisição, mas se recusa a autorizá-la. Verifique suas permissões. |
PIX-1005 | 404 Não encontrado | O recurso solicitado não foi encontrado. Verifique o identificador e tente novamente. |
PIX-1006 | 409 Conflito | A requisição não pôde ser concluída devido a um conflito com o estado atual. |
PIX-1007 | 422 Entidade não processável | A requisição estava bem formada, mas não pôde ser processada devido a erros semânticos. |
PIX-1008 | 429 Muitas requisições | Muitas requisições foram enviadas. Aguarde antes de fazer outra requisição. |
PIX-1059 | 400 Token de autenticação ausente | O token de autenticação está ausente na requisição. Forneça um Bearer token válido no header Authorization. |
PIX-1060 | 400 Token de autenticação inválido | O token de autenticação fornecido é inválido. Obtenha um novo token e tente novamente. |
PIX-1061 | 400 Token de autenticação expirado | O token de autenticação expirou. Obtenha um novo token usando o endpoint de autenticação. |
PIX-1062 | 400 Permissões insuficientes | O participante autenticado não tem permissões suficientes para executar esta operação. |
PIX-1063 | 400 Participante não autorizado | O participante autenticado não está autorizado a executar esta operação no recurso especificado. |
PIX-1064 | 400 Regra de autenticação ou autorização violada | A requisição viola regras de autenticação ou autorização. Verifique suas credenciais e permissões. |
Chaves Pix
code | Descrição | detail |
|---|---|---|
PIX-1009 | 422 Formato de chave Pix inválido | O formato da chave PIX é inválido para o tipo especificado. Verifique se o formato corresponde ao padrão esperado e tente novamente. |
PIX-1010 | 409 Chave Pix já existe | Já existe uma chave PIX com este valor. Use uma chave PIX diferente. |
PIX-1011 | 404 Chave Pix não encontrada | A chave PIX especificada não foi encontrada no sistema. Verifique o valor da chave e tente novamente. |
PIX-1012 | 400 Limite de chaves Pix excedido | Você atingiu o número máximo de chaves PIX permitido. Exclua uma chave existente antes de criar uma nova. |
PIX-1013 | 422 Tipo de chave Pix inválido | O tipo de chave PIX é inválido. Use um tipo de chave PIX válido. |
PIX-1014 | 422 Chave Pix expirada | A chave PIX expirou e não pode ser usada. Crie uma nova chave PIX. |
PIX-1015 | 400 Chave Pix pendente de confirmação | A chave PIX está pendente de confirmação. Conclua o processo de confirmação. |
PIX-1016 | 400 Chave Pix inativa | A chave PIX está inativa e não pode ser usada. Ative a chave PIX. |
PIX-1017 | 403 Exclusão de chave Pix não permitida | A chave PIX não pode ser excluída em seu estado atual. Verifique o status da chave. |
PIX-1018 | 422 Tipo de conta inválido | O tipo de conta é inválido para esta operação. Use um tipo de conta válido. |
Reivindicações de chave Pix
code | Descrição | detail |
|---|---|---|
PIX-1019 | 404 Reivindicação de chave Pix não encontrada | A reivindicação de chave PIX especificada não foi encontrada. Verifique o identificador da reivindicação. |
PIX-1020 | 409 Reivindicação de chave Pix já existe | Já existe uma reivindicação de chave PIX com este identificador. Use um identificador exclusivo. |
PIX-1021 | 422 Status de reivindicação inválido | A reivindicação não está em um status válido para esta operação. Verifique o status da reivindicação. |
PIX-1022 | 422 Reivindicação de chave Pix expirada | A reivindicação de chave PIX expirou e não pode ser processada. Crie uma nova reivindicação. |
PIX-1023 | 403 Ação de reivindicação não autorizada | Você não está autorizado a executar esta ação na reivindicação. Verifique suas permissões. |
PIX-1024 | 409 Reivindicação já processada | A reivindicação de chave PIX já foi processada e não pode ser modificada. |
PIX-1025 | 422 Dados de reivindicação inválidos | Os dados da reivindicação fornecidos são inválidos. Verifique todos os campos e tente novamente. |
PIX-1026 | 400 Divergência de Bank ID na reivindicação | Há uma divergência de Bank ID na requisição de reivindicação. Verifique os valores de Bank ID. |
Transações e pagamentos
code | Descrição | detail |
|---|---|---|
PIX-1027 | 404 Transação não encontrada | A transação especificada não foi encontrada. Verifique o identificador da transação. |
PIX-1028 | 409 Transação já existe | Já existe uma transação com este identificador. Use um ID de transação exclusivo. |
PIX-1029 | 422 Valor de transação inválido | O valor da transação é inválido. Forneça um valor positivo válido. |
PIX-1030 | 400 Saldo insuficiente | A conta não tem saldo suficiente para esta transação. Adicione fundos e tente novamente. |
PIX-1031 | 409 Limite de transação excedido | O valor da transação excede os limites configurados. Tente um valor menor. |
PIX-1032 | 422 Dados do destinatário inválidos | Os dados do destinatário são inválidos. Verifique todas as informações do destinatário. |
PIX-1033 | 422 Transação expirada | A transação expirou e não pode ser processada. Crie uma nova transação. |
PIX-1034 | 422 Transação cancelada | A transação foi cancelada e não pode ser processada. |
PIX-1035 | 422 Validação de pagamento falhou | A validação do pagamento falhou. Verifique todos os detalhes do pagamento e tente novamente. |
PIX-1036 | 400 ID end-to-end inválido | O formato do ID end-to-end é inválido. Use um identificador end-to-end válido. |
Devoluções
code | Descrição | detail |
|---|---|---|
PIX-1037 | 400 Devolução não permitida | A devolução não é permitida para esta transação. Verifique o status da transação e a elegibilidade para devolução. |
PIX-1038 | 422 Motivo de devolução inválido | O código do motivo de devolução é inválido. Use um código de motivo de devolução válido. |
PIX-1039 | 422 Valor da devolução excede o original | O valor da devolução excede o valor da transação original. Informe um valor de devolução válido. |
PIX-1040 | 400 Prazo de devolução expirado | O prazo de devolução para esta transação expirou. Devoluções não são mais permitidas. |
PIX-1041 | 404 Transação original não encontrada | A transação original não foi encontrada para esta devolução. Verifique o identificador da transação. |
Participantes e contas
code | Descrição | detail |
|---|---|---|
PIX-1042 | 422 Bank ID inválido | O código do Bank ID é inválido. Forneça um código de Bank ID válido. |
PIX-1043 | 422 Bank ID não participante | O Bank ID não é participante do sistema PIX. Use um Bank ID participante. |
PIX-1044 | 422 Número de conta inválido | O formato do número de conta é inválido. Forneça um número de conta válido. |
PIX-1045 | 422 Conta bloqueada | A conta está bloqueada e não pode ser acessada. Entre em contato com o suporte. |
PIX-1046 | 400 Conta encerrada | A conta está encerrada e não pode ser acessada. Use uma conta ativa. |
QR codes
code | Descrição | detail |
|---|---|---|
PIX-1047 | 422 QR code inválido | O formato do QR code é inválido ou está corrompido. Verifique o QR code e tente novamente. |
PIX-1048 | 404 QR code expirado | O QR code expirou e não pode ser usado. Gere um novo QR code. |
PIX-1049 | 422 QR code já usado | O QR code já foi usado e não pode ser usado novamente. |
PIX-1065 | 422 URL do payload do QR inalcançável | Composto pelo serviço. Diz que o payload do QR code não pôde ser buscado na URL dele, nomeia o host da URL, diz que esse host pertence à instituição que recebe o pagamento e que a falha é do host, e anexa a explicação da própria JDPI quando ela dá uma. |
Disponibilidade do trilho
code | Descrição | detail |
|---|---|---|
PIX-1050 | 503 Serviço JDPI indisponível | O serviço JDPI está temporariamente indisponível. Tente novamente mais tarde. |
PIX-1051 | 504 Timeout do serviço JDPI | A requisição ao serviço JDPI atingiu o tempo limite. Tente novamente. |
PIX-1052 | 500 Erro interno do JDPI | Ocorreu um erro interno no JDPI. Entre em contato com o suporte se o problema persistir. |
PIX-1053 | 429 Muitas requisições | Muitas requisições foram enviadas. Aguarde antes de fazer outra requisição. |
PIX-1054 | 503 Erro de conexão com o JDPI | internal error |
PIX-1055 | 502 Erro de serviço externo | internal error |
Fraude, conformidade e regulação
code | Descrição | detail |
|---|---|---|
PIX-1056 | 403 Fraude detectada | A transação foi bloqueada devido à detecção de fraude. Entre em contato com o suporte. |
PIX-1057 | 403 Violação de conformidade | Foi detectada uma violação de conformidade. Garanta que todos os requisitos sejam atendidos. |
PIX-1058 | 403 Restrição regulatória | Uma restrição regulatória se aplica a esta operação. Entre em contato com o suporte. |
Falhas originadas fora do trilho Pix
Uma requisição Pix também pode falhar porque outro serviço da plataforma a recusou. Três faixas de código carregam essas recusas: registros de clientes, autorização e o ledger do Midaz. No webhook de cash-in de entrada (
POST /v1/webhooks/cash-ins), uma indisponibilidade do CRM, do Access Manager ou do Midaz responde 500 em vez de 503 ou 504. O code é o código da dependência, por exemplo PIX-3007, e o detail nomeia a dependência.
Registros de clientes
code | Descrição | detail |
|---|---|---|
PIX-2000 | 422 Aninhamento inválido de metadados | O objeto metadados não pode conter valores aninhados. Confirme que o valor não está aninhado e tente novamente. |
PIX-2001 | 422 Chave de metadados muito longa | A chave de metadados excede o tamanho máximo permitido. Use um nome de chave mais curto. |
PIX-2002 | 400 Campos ausentes na requisição | Sua requisição está sem um ou mais campos obrigatórios. Forneça todos os campos obrigatórios e tente novamente. |
PIX-2003 | 400 Tipo de campo inválido na requisição | Um ou mais campos têm tipos de dados incorretos. Verifique os tipos dos campos e tente novamente. |
PIX-2004 | 400 Parâmetro de caminho inválido | Os parâmetros de caminho estão em formato incorreto. Verifique o formato do parâmetro. |
PIX-2005 | 400 Campos inesperados na requisição | A requisição contém mais campos do que o esperado. Envie apenas os campos permitidos conforme a documentação. |
PIX-2006 | 422 Limite de paginação excedido | O limite de paginação excede o valor máximo permitido. Use um limite menor. |
PIX-2007 | 400 Ordem de classificação inválida | A ordem de classificação deve ser “asc” ou “desc”. Use uma ordem de classificação válida. |
PIX-2008 | 400 Valor de metadados muito longo | O valor de metadados excede o tamanho máximo permitido. Use um valor mais curto. |
PIX-2009 | 409 Conta já associada | A conta pode ser associada a apenas uma conta relacionada. Use uma conta diferente. |
PIX-2010 | 400 Requisição inválida | O servidor não conseguiu entender a requisição devido a sintaxe inválida. Verifique o formato da requisição. |
PIX-2011 | 400 Parâmetro de consulta inválido | Os parâmetros de consulta estão em formato incorreto. Verifique os valores dos parâmetros. |
PIX-2012 | 422 Não é possível excluir o titular | O titular não pode ser excluído devido a contas associadas. Remova as contas associadas primeiro. |
PIX-2013 | 400 Headers ausentes na requisição | Parâmetros de header obrigatórios estão ausentes na requisição. Inclua todos os headers obrigatórios. |
PIX-2014 | 400 Formato de metadados inválido | O formato do parâmetro metadata está incorreto. Use o formato de metadados correto. |
PIX-2015 | 404 ID do titular não encontrado | O ID do titular especificado não existe. Verifique o ID do titular e tente novamente. |
PIX-2016 | 404 ID de conta não encontrado | O ID de conta especificado não existe. Verifique o ID de conta e tente novamente. |
PIX-2017 | 403 Falha na autenticação do CRM | A autenticação do CRM falhou. Verifique suas credenciais. |
PIX-2018 | 409 Erro de associação de documento | O documento apenas pode ser associado a um titular. Use um documento diferente. |
PIX-2019 | 500 Erro interno do servidor | internal error |
PIX-2020 | 503 Erro de conexão com o CRM | internal error |
PIX-2021 | 504 Timeout do serviço CRM | internal error |
PIX-2022 | 503 Serviço CRM indisponível | internal error |
PIX-2023 | 401 Falha na autenticação do CRM | A autenticação do CRM falhou. Verifique suas credenciais. |
PIX-2024 | 429 Rate limit do CRM excedido | O rate limit do serviço CRM foi excedido. Aguarde antes de fazer outra requisição. |
PIX-2025 | 403 CRM recusou o parceiro | O CRM recusou esta requisição pelas regras da própria credencial do parceiro para o CRM. O parceiro precisa de uma concessão para o CRM que cubra esta operação. Quando o CRM informa um motivo, o detail o anexa. |
Autorização
code | Descrição | detail |
|---|---|---|
PIX-3000 | 400 Campos ausentes na requisição | Sua requisição está sem um ou mais campos obrigatórios. Forneça todos os campos obrigatórios e tente novamente. |
PIX-3001 | 422 Tipo de concessão inválido | O tipo de concessão fornecido é inválido. Use “client_credentials” para autenticação. |
PIX-3002 | 422 Tipo de concessão com campos ausentes | Campos obrigatórios estão ausentes para o tipo de concessão. Forneça client_id e client_secret. |
PIX-3003 | 422 Tipo de concessão não suportado | O tipo de concessão não é aceito pela aplicação. Use “client_credentials”. |
PIX-3004 | 401 Cliente inválido | As credenciais de cliente fornecidas são inválidas. Verifique seu ID do cliente e o Secret do cliente. |
PIX-3005 | 400 Requisição inválida | O servidor não conseguiu entender a requisição devido a sintaxe inválida. Verifique o formato da requisição. |
PIX-3006 | 400 Erro de conexão com o Access Manager | Falha ao conectar com o serviço Access Manager. Verifique a disponibilidade do serviço e tente novamente. |
PIX-3007 | 504 Timeout do Access Manager. Por exemplo, o Access Manager não respondeu a tempo quando o serviço pediu o seu próprio token. | internal error |
PIX-3008 | 503 Serviço Access Manager indisponível. Por exemplo, a requisição de token do serviço ao Access Manager não teve resposta ou recebeu um status 5xx. | internal error |
Ledger
code | Descrição | detail |
|---|---|---|
PIX-4000 | 503 Erro de conexão com o Midaz | internal error |
PIX-4001 | 504 Timeout do serviço Midaz | internal error |
PIX-4002 | 503 Serviço Midaz indisponível. Por exemplo, uma leitura de conta no Midaz deu timeout ou recebeu um status 5xx, ou o Midaz respondeu 401 ou 403 ao serviço. A resposta traz Retry-After: 5. | internal error |
PIX-4005 | 400 Requisição inválida ao Midaz | Requisição inválida para o serviço Midaz. Verifique o formato da requisição. |
PIX-4006 | 404 Conta Midaz não encontrada | A conta Midaz especificada não foi encontrada. Verifique o ID da conta e tente novamente. |
PIX-4007 | 422 Conta Midaz bloqueada. O ledger recusou um lançamento porque uma conta dele não tem saldo em que o ledger possa lançar: nenhum saldo foi aberto nesse ledger, ou ele foi excluído. | A conta Midaz está bloqueada e não pode ser acessada. Entre em contato com o suporte. |
PIX-4008 | 400 Conta Midaz encerrada | A conta Midaz está encerrada e não pode ser acessada. Entre em contato com o suporte. |
PIX-4009 | 422 Saldo Midaz insuficiente | A conta não tem saldo suficiente para esta operação. Adicione fundos e tente novamente. |
PIX-4010 | 503 Erro ao buscar saldo do Midaz | internal error |
PIX-4011 | 500 Falha na transação do Midaz | internal error |
PIX-4012 | 500 Falha no débito do Midaz | internal error |
PIX-4013 | 500 Falha no crédito do Midaz | internal error |
PIX-4014 | 404 Transação Midaz não encontrada | A transação Midaz especificada não foi encontrada. Verifique o ID da transação. |
PIX-4015 | 409 Transação Midaz duplicada | Já existe uma transação Midaz com este identificador. Use um ID de transação exclusivo. |
PIX-4016 | 422 Valor de transação inválido | O valor da transação é inválido. Forneça um valor positivo válido. |
PIX-4017 | 409 Limite de transação Midaz excedido | O valor da transação excede os limites configurados do Midaz. Tente um valor menor. |
PIX-4018 | 422 Transação Midaz negada | A transação foi negada pelas regras de validação de transações da instituição. |
PIX-4019 | 403 Midaz recusou o parceiro | O Midaz recusou esta requisição pelas regras da própria credencial do parceiro para o Midaz. O parceiro precisa de uma concessão para o Midaz que cubra esta operação. Quando o Midaz informa um motivo, o detail o anexa. |
Entrega de notificação
Os fluxos de posse de chave Pix enviam um código de uso único por e-mail ou por SMS. Estes códigos relatam uma falha nessa etapa de entrega.
Entrega por e-mail
code | Descrição | detail |
|---|---|---|
PIX-5000 | 401 Chave de API inválida | A chave de API do SendGrid é inválida, foi excluída ou as permissões mudaram. Verifique sua chave de API. |
PIX-5001 | 400 Payload malformado | O payload da requisição da API do SendGrid está malformado. Verifique o formato da requisição. |
PIX-5002 | 403 Permissões insuficientes | Você tem permissões insuficientes para esta operação do SendGrid. Verifique as permissões da sua conta. |
PIX-5003 | 429 Rate limit excedido | O rate limit do SendGrid foi excedido. Aguarde antes de fazer outra requisição. |
PIX-5004 | 400 Erro de conexão com o SendGrid | Falha ao conectar com o serviço de e-mail do SendGrid. Verifique a disponibilidade do serviço e tente novamente. |
PIX-5005 | 504 Timeout do serviço SendGrid | A requisição ao serviço de e-mail do SendGrid atingiu o tempo limite. Tente novamente. |
PIX-5006 | 503 Serviço SendGrid indisponível | O serviço de e-mail do SendGrid está temporariamente indisponível. Tente novamente mais tarde. |
Entrega por SMS
code | Descrição | detail |
|---|---|---|
PIX-6000 | 403 Permissão negada | Permissão negada para a operação de SMS do Twilio. Verifique as permissões da sua conta e tente novamente. |
PIX-6001 | 401 Token de acesso inválido | O token de acesso do Twilio é inválido. Verifique suas credenciais de autenticação. |
PIX-6002 | 401 Falha na autenticação | A autenticação de SMS do Twilio falhou. Verifique as credenciais da sua conta. |
PIX-6003 | 400 Limitação de conta de avaliação | Este recurso não está disponível para contas de avaliação. Atualize sua conta Twilio. |
PIX-6004 | 400 Formato de URL inválido | Formato de URL inválido para o webhook do Twilio. Verifique o formato da URL e tente novamente. |
PIX-6005 | 400 Violação de protocolo HTTP | Violação de protocolo HTTP na requisição do Twilio. Verifique o formato da requisição. |
PIX-6006 | 429 Rate limit de SMS excedido | O rate limit de envio de SMS do Twilio foi excedido. Aguarde antes de enviar mais mensagens. |
PIX-6007 | 400 Telefone não capacitado para SMS | O número de telefone remetente não é capacitado para SMS. Use um número de telefone com suporte a SMS. |
PIX-6008 | 400 Limite de resposta excedido | O limite de mensagens de resposta do TwiML foi excedido. Reduza o número de mensagens de resposta. |
PIX-6009 | 400 Verb usado para a requisição de SMS não é permitido | Verb inválido para a resposta de SMS. Use um Verb do TwiML válido. |
PIX-6010 | 400 Telefone inválido para avaliação | Número de telefone de destino inválido para o modo de avaliação. Verifique o número ou atualize sua conta. |
PIX-6011 | 400 Número de telefone remetente não verificado | O número de telefone remetente não está verificado para sua conta Twilio. Verifique o número. |
PIX-6012 | 400 Número de telefone remetente não verificado | O número de telefone remetente não está verificado para sua conta Twilio. Verifique o número. |
PIX-6013 | 400 Número de telefone de destino inválido | O formato do número de telefone de destino é inválido. Use um número de telefone válido. |
PIX-6014 | 400 Número de telefone remetente inválido | O formato do número de telefone remetente é inválido. Use um número de telefone válido. |
PIX-6015 | 400 Erro de conexão com o Twilio | Falha ao conectar com o serviço de SMS do Twilio. Verifique a disponibilidade do serviço e tente novamente. |
PIX-6016 | 504 Timeout do serviço Twilio | A requisição ao serviço de SMS do Twilio atingiu o tempo limite. Tente novamente. |
PIX-6017 | 503 Serviço Twilio indisponível | O serviço de SMS do Twilio está temporariamente indisponível. Tente novamente mais tarde. |
Motivos de rejeição de reembolso do MED
Uma requisição de reembolso do MED que este participante analisa e rejeita carrega um motivo de rejeição numerado. O domínio usa os valores 0, 1, 3 e 4.
| Valor | Rótulo | O que significa |
|---|---|---|
0 | Falta de saldo | A conta do cliente não tem saldo para cobrir o reembolso. |
1 | Relacionamento encerrado | O relacionamento com o cliente está encerrado. |
3 | Generico | Um motivo que os outros três valores não cobrem. |
4 | Requisicao invalida | A requisição de reembolso é inválida. Este valor se aplica quando o motivo do reembolso é uma falha operacional. |
Códigos de motivo de devolução Pix
Um Pix devolvido carrega um motivo de devolução próprio do Bacen, separado dos códigos
PIX-NNNN acima. Esta referência de API documenta os valores permitidos no campo que os carrega. Esse campo é codigoDevolucao em um crédito recebido. Na visualização de status do crédito de reembolso, é refundCode. Em uma requisição de reembolso, é code.