Pular para o conteúdo principal

Status e Códigos de Erro

Disponível apenas em Sandbox

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

O Pix por Biometria 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 o 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 o vínculo ou a confirmação está em andamento.
payment_pendingO cliente confirmou e o pagamento aguarda a liquidação.
completedJornada finalizada. Consulte o pagamento para saber o resultado.
canceledLink cancelado por você antes do pagamento.
expiredO link expirou antes de o cliente concluir o pagamento.
errorA jornada terminou sem confirmação ou houve falha no processamento. Veja o objeto error.

Status do pagamento​

StatusSignificado
pendingPagamento recebido e em validação.
awaiting_authorizationAguardando a confirmação do cliente, com biometria ou no banco.
authorizedConfirmado pelo cliente. Aguardando o envio para liquidação.
processingEnviado para liquidação.
paidValor creditado na conta recebedora. Status final de sucesso.
rejectedPagamento recusado. Veja o error.code.
canceledCancelado por você antes da liquidação.
expiredO cliente não confirmou antes da expiração do link.
errorFalha no processamento do pagamento. Veja o error.code.

Códigos de rejeição​

Rejeições da jornada​

Retornadas no campo error.code do link.

CódigoSignificado
rejected_by_customerO cliente recusou o vínculo ou o pagamento no banco.
authorization_time_expiredO cliente não confirmou dentro do prazo.
journey_time_expiredO cliente não finalizou a jornada a tempo.
account_not_allowedO tipo de conta escolhido não permite o pagamento (ex.: conta salário).
same_source_and_destination_accountA conta do cliente é igual à conta recebedora.
authorization_attempts_exceededExcedido o número de tentativas de confirmação.
invalid_payment_methodForma de recebimento 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 do pagamento.

CódigoSignificado
insufficient_balanceConta do cliente sem saldo suficiente.
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).
invalid_payment_detailsAlgum parâmetro não respeita as regras do arranjo.
same_source_and_destination_accountA conta de origem é igual à de destino.
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 ou um novo link com outro valor.
rejected_by_customer, authorization_time_expired e journey_time_expiredPergunte ao cliente se ele quer tentar de novo e crie um novo link.
refused_by_bank e reason_not_informedOfereça outra forma de pagamento. O banco do cliente não aceitou o pagamento.
Falhas de infraestrutura (infrastructure_failure e demais códigos terminados em _failure)Crie um novo link para o cliente tentar de novo. Se o problema se repetir, fale com o nosso suporte.