{"id":1995,"date":"2026-03-30T16:06:50","date_gmt":"2026-03-30T19:06:50","guid":{"rendered":"https:\/\/www.bancosemear.com.br\/docs\/?post_type=docs&p=1995"},"modified":"2026-03-30T16:06:50","modified_gmt":"2026-03-30T19:06:50","slug":"guia-de-referencia-codigos-de-retorno-e-erros-da-api","status":"publish","type":"docs","link":"https:\/\/www.bancosemear.com.br\/docs\/?docs=guia-de-referencia-codigos-de-retorno-e-erros-da-api","title":{"rendered":"Guia de Refer\u00eancia: C\u00f3digos de Retorno e Erros da API"},"content":{"rendered":"
\n

\ud83d\udcd6 Guia de Refer\u00eancia: C\u00f3digos de Retorno e Erros da API<\/h2>\n

Este documento serve como refer\u00eancia oficial para todos os c\u00f3digos de erro e mensagens descritivas que podem ser retornados pelas nossas APIs durante o processamento de transa\u00e7\u00f5es, pagamentos e integra\u00e7\u00f5es.<\/p>\n

Para facilitar a navega\u00e7\u00e3o e o tratamento sist\u00eamico, os c\u00f3digos foram categorizados em tr\u00eas blocos principais.<\/p>\n

<\/p>\n

1. \ud83d\uded1 Erros de Neg\u00f3cio e Valida\u00e7\u00e3o (S\u00e9rie AB)<\/h3>\n

Esta categoria concentra as falhas relacionadas a regras de neg\u00f3cio, limites de valores, hor\u00e1rios de opera\u00e7\u00e3o e dados inv\u00e1lidos nas requisi\u00e7\u00f5es.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
C\u00f3digo<\/th>\nDescri\u00e7\u00e3o da Mensagem<\/th>\n<\/tr>\n<\/thead>\n
AB00001<\/strong><\/td>\nPagamentos da Institui\u00e7\u00e3o bloqueados. Sistema temporariamente indispon\u00edvel. Por favor, tente novamente mais tarde. [1]<\/td>\n<\/tr>\n
AB00002<\/strong><\/td>\nValor da transa\u00e7\u00e3o superior ao limite. [1]<\/td>\n<\/tr>\n
AB00003<\/strong><\/td>\nLimite di\u00e1rio ultrapassado. Valor disponivel: R$ 999.99 [1]<\/td>\n<\/tr>\n
AB00004<\/strong><\/td>\nLimite de movimentos iguais ultrapassado. [1]<\/td>\n<\/tr>\n
AB00005<\/strong><\/td>\nN\u00e3o s\u00e3o permitidos pagamentos para essa institui\u00e7\u00e3o. [1, 7, 8]<\/td>\n<\/tr>\n
AB00006<\/strong><\/td>\nTransfer\u00eancia interna de participante indireto deve ser realizada na origem. [1]<\/td>\n<\/tr>\n
AB00007<\/strong><\/td>\nPagamentos agendados s\u00f3 podem ser realizados at\u00e9 as 23:30 do dia anterior \u00e0 opera\u00e7\u00e3o. [1]<\/td>\n<\/tr>\n
AB00008<\/strong><\/td>\nMovimento n\u00e3o encontrado. [7, 8]<\/td>\n<\/tr>\n
AB00009<\/strong><\/td>\nMovimento fora do prazo de devolu\u00e7\u00e3o. [7, 8]<\/td>\n<\/tr>\n
AB00010<\/strong><\/td>\nOpera\u00e7\u00e3o inv\u00e1lida. N\u00e3o \u00e9 permitido devolver uma opera\u00e7\u00e3o de devolu\u00e7\u00e3o. [7, 8]<\/td>\n<\/tr>\n
AB00011<\/strong><\/td>\nSolicitante da devolu\u00e7\u00e3o n\u00e3o \u00e9 o mesmo do benefici\u00e1rio do movimento a ser devolvido. [7, 8]<\/td>\n<\/tr>\n
AB00012<\/strong><\/td>\nValor informado inv\u00e1lido. Valor disponivel para devolu\u00e7\u00e3o: R$ 999,99 [7, 8]<\/td>\n<\/tr>\n
AB00013<\/strong><\/td>\nInforma\u00e7\u00e3o adicional do motivo de devolu\u00e7\u00e3o deve ser informado para o tipo ‘Narrativa’. [7, 8]<\/td>\n<\/tr>\n
AB00014<\/strong><\/td>\nDados da conta pagadora n\u00e3o localizados. [1, 7, 8]<\/td>\n<\/tr>\n
AB00015<\/strong><\/td>\nDados da conta recebedora n\u00e3o localizados. [1, 7, 8]<\/td>\n<\/tr>\n
AB00016<\/strong><\/td>\nErro no processamento da pacs.008 na ICOM. \/ Erro no processamento da pacs.004 na ICOM. [1, 8, 9]<\/td>\n<\/tr>\n
AB00017<\/strong><\/td>\nTempo limite para aguardo de resposta expirado. [1, 8, 9]<\/td>\n<\/tr>\n
AB00018<\/strong><\/td>\nEnd To End duplicado. \/ Return ID duplicado. [1, 8, 9]<\/td>\n<\/tr>\n
AB00019<\/strong><\/td>\nEnd To End inv\u00e1lido. \/ Return ID inv\u00e1lido. [1, 9, 10]<\/td>\n<\/tr>\n
AB00020<\/strong><\/td>\nSistema Indispon\u00edvel para esta opera\u00e7\u00e3o. [1]<\/td>\n<\/tr>\n
AB00021<\/strong><\/td>\nValor informado inv\u00e1lido. [1, 9, 10]<\/td>\n<\/tr>\n
AB00022<\/strong><\/td>\nFalha ao integrar com o Kafka. \/ Motivo Devolu\u00e7\u00e3o inv\u00e1lido. [1, 9, 10]<\/td>\n<\/tr>\n
AB00023<\/strong><\/td>\nChave de Bloqueio n\u00e3o informada para devolu\u00e7\u00e3o de bloqueio cautelar. [9, 10]<\/td>\n<\/tr>\n
AB00031<\/strong><\/td>\nTamanho inv\u00e1lido do campo Ag\u00eancia Pagadora. Tamanho m\u00e1ximo 4 d\u00edgitos. [1, 2]<\/td>\n<\/tr>\n
AB00032<\/strong><\/td>\nTamanho inv\u00e1lido do campo Ag\u00eancia Benefici\u00e1ria. Tamanho m\u00e1ximo 4 d\u00edgitos. [2]<\/td>\n<\/tr>\n
AB00041<\/strong><\/td>\nCPF\/CNPJ da iniciadora de pagamentos n\u00e3o informado. [2]<\/td>\n<\/tr>\n
AB00042<\/strong><\/td>\nCPF\/CNPJ da iniciadora de pagamentos inv\u00e1lido. [2]<\/td>\n<\/tr>\n
AB00043<\/strong><\/td>\nTxId da iniciadora de pagamentos n\u00e3o informada. [2]<\/td>\n<\/tr>\n
AB00044<\/strong><\/td>\nTxId da iniciadora de pagamentos tamanho inv\u00e1lido. M\u00e1ximo de 25 caracteres. [2]<\/td>\n<\/tr>\n
AB00045<\/strong><\/td>\nTxId do qr code est\u00e1tico tamanho inv\u00e1lido. M\u00e1ximo de 25 caracteres. [2]<\/td>\n<\/tr>\n
AB00046<\/strong><\/td>\nTxId do qr code din\u00e2mico n\u00e3o informada. [2]<\/td>\n<\/tr>\n
AB00047<\/strong><\/td>\nTxId do qr code din\u00e2mico tamanho inv\u00e1lido. Tamanho deve ser de 26 a 35 caracteres. [2]<\/td>\n<\/tr>\n
AB00048<\/strong><\/td>\nTxId n\u00e3o pode ser informada para pagamento manual ou de consulta ao DICT. [2]<\/td>\n<\/tr>\n
AB00049<\/strong><\/td>\nC\u00f3digo ISPB do benefici\u00e1rio n\u00e3o informado!. Opera\u00e7\u00f5es pelo Open Banking precisam informar os dados do benefici\u00e1rio. [2]<\/td>\n<\/tr>\n
AB00050<\/strong><\/td>\nN\u00famero da conta do benefici\u00e1rio n\u00e3o informado!. Opera\u00e7\u00f5es pelo Open Banking precisam informar os dados do benefici\u00e1rio. [2]<\/td>\n<\/tr>\n
AB00051<\/strong><\/td>\nTipo da conta do benefici\u00e1rio n\u00e3o informado!. Opera\u00e7\u00f5es pelo Open Banking precisam informar os dados do benefici\u00e1rio. [2, 3]<\/td>\n<\/tr>\n
AB00052<\/strong><\/td>\nCPF\/CNPJ do benefici\u00e1rio n\u00e3o informado!. Opera\u00e7\u00f5es pelo Open Banking precisam informar os dados do benefici\u00e1rio. [3]<\/td>\n<\/tr>\n
AB00053<\/strong><\/td>\nNome do benefici\u00e1rio n\u00e3o informado!. Opera\u00e7\u00f5es pelo Open Banking precisam informar os dados do benefici\u00e1rio. [3]<\/td>\n<\/tr>\n
AB00054<\/strong><\/td>\nEnd To End n\u00e3o informado. [3]<\/td>\n<\/tr>\n
AB00055<\/strong><\/td>\nForma de inicia\u00e7\u00e3o n\u00e3o informada. [3]<\/td>\n<\/tr>\n
AB00056<\/strong><\/td>\nChave de endere\u00e7amento n\u00e3o informada. Obrigat\u00f3rio para forma de inicia\u00e7\u00e3o DICT. [3]<\/td>\n<\/tr>\n
AB00057<\/strong><\/td>\nTxId de refer\u00eancia interna valor inv\u00e1lido. [3]<\/td>\n<\/tr>\n
AB00058<\/strong><\/td>\nPix Troco e Pix Saque n\u00e3o permitidos para Open Banking. [3]<\/td>\n<\/tr>\n
AB00059<\/strong><\/td>\nPix Troco e Pix Saque n\u00e3o permitidos para pagamento agendado. [3]<\/td>\n<\/tr>\n
AB00060<\/strong><\/td>\nDinheiro em esp\u00e9cie n\u00e3o deve ser informado para finalidade IPAY. [3]<\/td>\n<\/tr>\n
AB00061<\/strong><\/td>\nDinheiro em esp\u00e9cie deve ser informado para finalidade GSCB. [3]<\/td>\n<\/tr>\n
AB00063<\/strong><\/td>\nValor de opera\u00e7\u00e3o deve ser informado para finalidade GSCB. [3]<\/td>\n<\/tr>\n
AB00064<\/strong><\/td>\nValor de opera\u00e7\u00e3o n\u00e3o deve ser informado para finalidade OTHR. [3]<\/td>\n<\/tr>\n
AB00065<\/strong><\/td>\nPrestador do servi\u00e7o de saque deve ser informado para finalidade GSCB. [4]<\/td>\n<\/tr>\n
AB00066<\/strong><\/td>\nPrestador do servi\u00e7o de saque deve ser informado para finalidade OTHR. [4]<\/td>\n<\/tr>\n
AB00067<\/strong><\/td>\nModalidade do agente de saque n\u00e3o deve ser informada para finalidade IPAY. [4]<\/td>\n<\/tr>\n
AB00068<\/strong><\/td>\nPrestador do servi\u00e7o de saque n\u00e3o deve ser informado para finalidade IPAY. [4]<\/td>\n<\/tr>\n
AB00069<\/strong><\/td>\nDinheiro em esp\u00e9cie informado inv\u00e1lido. [4]<\/td>\n<\/tr>\n
AB00070<\/strong><\/td>\nModalidade do agente de saque deve ser informada para finalidade OTHR. [4]<\/td>\n<\/tr>\n
AB00071<\/strong><\/td>\nModalidade do agente de saque deve ser informada para finalidade GSCB. [4]<\/td>\n<\/tr>\n
AB00072<\/strong><\/td>\nPrestador do servi\u00e7o de saque deve respeitar o tamanho de 8 caracteres. [4]<\/td>\n<\/tr>\n
AB00080<\/strong><\/td>\nFalha ao verificar ordem de pagamento para o IdIdempotente informado. [4]<\/td>\n<\/tr>\n
AB00098<\/strong><\/td>\nSaldo insuficiente na conta de pagamento instant\u00e2neo para o participante 99999999. [4]<\/td>\n<\/tr>\n
AB00099<\/strong><\/td>\nValor R$ 999.99 informado no movimento diferente do valor do QR Code. [4]<\/td>\n<\/tr>\n
AB00100<\/strong><\/td>\nPagamento agendado n\u00e3o encontrado. [4]<\/td>\n<\/tr>\n
AB00101<\/strong><\/td>\nSolicitante do cancelamento deve ser o mesmo que o solicitante do agendamento. [4]<\/td>\n<\/tr>\n
AB00102<\/strong><\/td>\nCancelamentos devem ser realizados at\u00e9 as 23:30 do dia anterior ao da data agendada da opera\u00e7\u00e3o. [5]<\/td>\n<\/tr>\n
AB00103<\/strong><\/td>\nPrecisa informar o endToEnd ou o Id do pagamento para cancelar o mesmo. [5]<\/td>\n<\/tr>\n
AB00110<\/strong><\/td>\nDuplicidade. Encontrado um pagamento ou agendamento para o mesmo TxId (campo referenciaInterna) do qr code din\u00e2mico. [5]<\/td>\n<\/tr>\n
AB99999<\/strong><\/td>\nErro desconhecido. [5, 9, 10]<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

<\/p>\n

2. \u2699\ufe0f Erros de Infraestrutura e Integra\u00e7\u00e3o (S\u00e9ries BL, CT e TI)<\/h3>\n

Esses retornos indicam falhas de comunica\u00e7\u00e3o com servi\u00e7os internos ou problemas diretos de processamento de componentes de infraestrutura.<\/p>\n\n\n\n\n\n\n\n\n
C\u00f3digo<\/th>\nDescri\u00e7\u00e3o da Mensagem<\/th>\n<\/tr>\n<\/thead>\n
BL00001<\/strong><\/td>\nMensagem retornada pelo api-pagamento-instantaneo-ebank [5, 9, 10]<\/td>\n<\/tr>\n
BL00002<\/strong><\/td>\nChave de bloqueio n\u00e3o gerada.MV00001 [5]<\/td>\n<\/tr>\n
CT00001<\/strong><\/td>\nMensagem retornada pelo api-pagamento-instantaneo-ebank [5]<\/td>\n<\/tr>\n
TI00001<\/strong><\/td>\nMensagem retornada pelo api-pagamento-instantaneo-ebank [5, 9, 10]<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

<\/p>\n

3. \ud83c\udfe6 Erros do Sistema de Pagamentos Instant\u00e2neos (S\u00e9rie PIX)<\/h3>\n

Lista de recusas e valida\u00e7\u00f5es retornadas diretamente pelo Sistema de Pagamentos Instant\u00e2neos (SPI) ou pelo Provedor de Servi\u00e7os de Pagamento (PSP) recebedor.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
C\u00f3digo<\/th>\nDescri\u00e7\u00e3o da Mensagem<\/th>\n<\/tr>\n<\/thead>\n
PIXAB03<\/strong><\/td>\nControle de timeout no SPI \/ Extrapola\u00e7\u00e3o do limite de tempo de timeout no PSP do Recebedor. [5, 9, 10]<\/td>\n<\/tr>\n
PIXAB09<\/strong><\/td>\nTransa\u00e7\u00e3o interrompida devido a erro no PSP do Recebedor. [5, 9, 10]<\/td>\n<\/tr>\n
PIXAC03<\/strong><\/td>\nN\u00famero da conta transacional do PSP do Recebedor inexistente ou inv\u00e1lido. [5, 9, 10]<\/td>\n<\/tr>\n
PIXAC06<\/strong><\/td>\nA conta especificada encontra-se bloqueada. [5, 9, 10]<\/td>\n<\/tr>\n
PIXAC07<\/strong><\/td>\nN\u00famero da conta transacional do PSP do Recebedor encerrada. [5, 9, 10]<\/td>\n<\/tr>\n
PIXAC14<\/strong><\/td>\nTipo de conta transacional do PSP do Recebedor inexistente ou inv\u00e1lido. [6, 9, 10]<\/td>\n<\/tr>\n
PIXAG03<\/strong><\/td>\nTipo de transa\u00e7\u00e3o n\u00e3o \u00e9 suportada\/autorizada nessa conta. [6, 9, 10]<\/td>\n<\/tr>\n
PIXAM01<\/strong><\/td>\nSPI n\u00e3o processar\u00e1 ordens com valor zero. [6, 10, 11]<\/td>\n<\/tr>\n
PIXAM04<\/strong><\/td>\nSaldo insuficiente na conta PI do PSP do pagador. [6, 10, 11]<\/td>\n<\/tr>\n
PIXAM05<\/strong><\/td>\nIdentificador EndtoEnd em duplicidade. [6, 11, 12]<\/td>\n<\/tr>\n
PIXAM18<\/strong><\/td>\nN\u00famero da transa\u00e7\u00f5es inv\u00e1lida. [6, 11, 12]<\/td>\n<\/tr>\n
PIXBE01<\/strong><\/td>\nCPF\/CNPJ do usu\u00e1rio recebedor n\u00e3o \u00e9 consistente com o titular da conta creditada. [6, 11, 12]<\/td>\n<\/tr>\n
PIXCH11<\/strong><\/td>\nCPF\/CNPJ do usu\u00e1rio recebedor incorreto. [6, 11, 12]<\/td>\n<\/tr>\n
PIXCH16<\/strong><\/td>\nElemento da mensagem incorreto. [6, 11, 12]<\/td>\n<\/tr>\n
PIXDS04<\/strong><\/td>\nOrdem rejeitada pelo PSP do Recebedor. [6, 11, 12]<\/td>\n<\/tr>\n
PIXDS0G<\/strong><\/td>\nParticipante que assinou a mensagem n\u00e3o \u00e9 autorizado a operar a conta PI debitada. No caso em que o participante que assinou a mensagem n\u00e3o \u00e9 o titular da conta PI debitada no SPI nem \u00e9 o liquidante da conta PI debitada. [6, 11, 12]<\/td>\n<\/tr>\n
PIXDT02<\/strong><\/td>\nData e Hora do envio da mensagem inv\u00e1lida. [6, 11, 12]<\/td>\n<\/tr>\n
PIXDU04<\/strong><\/td>\nIdentificador EndtoEnd n\u00e3o \u00e9 \u00fanico (duplicidade). [6, 11, 12]<\/td>\n<\/tr>\n
PIXED05<\/strong><\/td>\nErro no processamento do pagamento (erro gen\u00e9rico). [6, 11, 12]<\/td>\n<\/tr>\n
PIXFF08<\/strong><\/td>\nIdentificador EndtoEnd inv\u00e1lido ou inexistente. [7, 11, 12]<\/td>\n<\/tr>\n
PIXRC09<\/strong><\/td>\nIdentificador Debtor ClearingSystemMember inv\u00e1lido ou inexistente. [7, 11, 12]<\/td>\n<\/tr>\n
PIXRC10<\/strong><\/td>\nIdentificador Creditor ClearingSystemMember inv\u00e1lido ou inexistente. [7, 8, 12]<\/td>\n<\/tr>\n
PIXRR01<\/strong><\/td>\nNos casos de pagamento que n\u00e3o sejam da Secretaria do Tesouro Nacional (STN), o preenchimento das informa\u00e7\u00f5es da conta do usu\u00e1rio pagador s\u00e3o obrigat\u00f3rias. [7, 8, 13]<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

\ud83d\udcd6 Guia de Refer\u00eancia: C\u00f3digos de Retorno e Erros da API Este documento serve como refer\u00eancia oficial para todos os c\u00f3digos de erro e mensagens descritivas que podem ser retornados pelas nossas APIs durante o processamento de transa\u00e7\u00f5es, pagamentos e integra\u00e7\u00f5es. Para facilitar a navega\u00e7\u00e3o e o tratamento sist\u00eamico, os c\u00f3digos foram categorizados em tr\u00eas …<\/p>\n

Guia de Refer\u00eancia: C\u00f3digos de Retorno e Erros da API<\/span> Leia mais »<\/a><\/p>\n","protected":false},"author":14,"featured_media":0,"parent":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"default","ast-global-header-display":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","footnotes":""},"doc_category":[5],"doc_tag":[],"class_list":["post-1995","docs","type-docs","status-publish","hentry","doc_category-apis-pagamento-pix"],"_links":{"self":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/1995","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/users\/14"}],"replies":[{"embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1995"}],"version-history":[{"count":3,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/1995\/revisions"}],"predecessor-version":[{"id":1998,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/1995\/revisions\/1998"}],"wp:attachment":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1995"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_category&post=1995"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_tag&post=1995"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}