Pular para o conteúdo principal

Status e Códigos de Erro

Disponível apenas em Sandbox

O Pix Agendado está disponível somente no ambiente Sandbox. Não há suporte em produção no momento.

O Pix Agendado não está disponível para todas as contas e depende de habilitação prévia pela Marlim. Para verificar a elegibilidade da sua conta, entre em contato com o nosso time comercial.

O link e cada pagamento têm status próprios, retornados no campo current_status das consultas e dos webhooks.

StatusSignificado
createdLink criado, ainda não acessado pelo cliente.
processingO cliente acessou o link e a aprovação está em andamento.
payment_pendingO cliente aprovou o agendamento e há pagamentos a liquidar.
completedTodas as datas do agendamento foram processadas. Consulte cada pagamento para saber o resultado.
canceledLink cancelado por você antes da aprovação.
expiredO link expirou antes de o cliente concluir a aprovação.
errorA jornada terminou sem aprovação ou houve falha no processamento. Veja o objeto error.

Status do pagamento​

StatusSignificado
pendingPagamento recebido e em validação.
awaiting_authorizationAguardando a aprovação do cliente no banco.
authorizedAprovado pelo cliente. Aguardando o agendamento no banco.
scheduledAgendado no banco do cliente para a data informada.
processingEnviado para liquidação.
paidValor creditado na conta recebedora. Status final de sucesso.
rejectedPagamento recusado. Veja o error.code.
canceledCancelado antes da liquidação, pelo cliente no banco dele ou por você.
expiredO cliente não aprovou antes da expiração do link.

Códigos de rejeição​

Rejeições da aprovação​

Retornadas no campo error.code do link.

CódigoSignificado
rejected_by_customerO cliente recusou o agendamento no banco.
authorization_time_expiredO cliente não aprovou dentro do prazo.
journey_time_expiredO cliente não finalizou a jornada a tempo.
account_not_allowedO tipo de conta escolhido não permite Pix Agendado (ex.: conta salário).
same_source_and_destination_accountA conta do cliente é igual à conta recebedora.
authorization_attempts_exceededExcedido o número de tentativas de aprovação.
invalid_payment_methodForma de recebimento inválida.
invalid_payment_dateData de pagamento inválida.
missing_parameterParâmetro obrigatório ausente.
invalid_parameterParâmetro inválido.
infrastructure_failureFalha de infraestrutura durante a jornada.

Rejeições de pagamento​

Retornadas no campo error.code de cada pagamento.

CódigoSignificado
insufficient_balanceConta do cliente sem saldo suficiente, mesmo após a nova tentativa do banco no dia.
amount_above_limitValor acima do limite de Pix definido pelo cliente no banco.
invalid_amountValor enviado não é válido.
reason_not_informedO banco do cliente não informou o motivo (pode ter sido bloqueio do antifraude do banco).
refused_by_bankRecusado pelo banco do cliente. O motivo vem em error.detail.
refused_by_spiRecusado pelo Sistema de Pagamentos Instantâneos (SPI).
account_holder_mismatchA conta não pertence mais ao CPF ou CNPJ do pagador.
invalid_payment_detailsAlgum parâmetro não respeita as regras do arranjo.
same_source_and_destination_accountA conta de origem é igual à de destino.
scheduling_failureNão foi possível agendar o pagamento no banco do cliente.
infrastructure_failureFalha de infraestrutura não especificada.
spi_failureFalha no SPI.
dict_failureFalha no DICT (diretório de chaves Pix).
icp_failureFalha na Infraestrutura de Chaves Públicas.
receiving_institution_failureFalha na instituição recebedora.
bank_failureFalha no banco do cliente.

Ação recomendada​

SituaçãoO que fazer
insufficient_balance e amount_above_limitAvise o cliente e ofereça outra forma de pagamento para a data que falhou. Os demais pagamentos do agendamento continuam valendo.
rejected_by_customer, authorization_time_expired e journey_time_expiredPergunte ao cliente se ele quer tentar de novo e crie um novo link.
account_holder_mismatchO cliente trocou de conta. Cancele os pagamentos restantes e crie um novo link.
Falhas de infraestrutura (infrastructure_failure e demais códigos terminados em _failure)Ofereça outra forma de pagamento para a data que falhou. Se o problema se repetir, fale com o nosso suporte.