Códigos de recusa

Saiba mais sobre códigos de recusa e como resolvê-los quando uma cobrança falha.

Normalmente, o código de recusa é um código de erro alfanumérico de dois dígitos que indica o motivo da recusa. Embora o código possa se originar de vários locais, ele geralmente vem do banco emissor, processador de pagamentos ou rede de crédito.

Códigos de recusa da Stripe

A Stripe usa seus próprios códigos de recusa, que abrangem muitos dos possíveis motivos dos códigos de recusa tradicionais, mas definem o problema com mais clareza. Use a tabela a seguir para ajudar a resolver problemas relacionados a códigos de recusa:

Observação

A Stripe fornece as orientações anteriormente comunicadas em códigos de recusa obsoletos em códigos de aconselhamento.

Código de recusa	Descrição	Próximas etapas

`authentication_required`	O cartão foi recusado porque a transação exige autenticação, como 3D Secure.	Ao usar os front-ends da Stripe, na maioria dos casos uma recusa temporária de um emissor aciona um fluxo de autenticação, permitindo que o cliente tente novamente e autentique o cartão. Em alguns casos, como em pagamentos fora de sessão, pode ser necessário pedir ao cliente para tentar novamente. Se o emissor do cartão retornar este código de recusa, mesmo quando a transação estiver autenticada, o cliente precisará entrar em contato com o emissor do cartão para obter mais informações.
`approve_with_id`	Não é possível autorizar o pagamento.	Tente pagar novamente. Se você ainda não conseguir processá-lo, o cliente precisará falar com o emissor do cartão.
`call_issuer`	O cartão foi recusado por um motivo desconhecido.	O cliente precisa entrar em contato com o emissor do cartão para obter mais informações.
`card_not_supported`	O cartão não aceita este tipo de compra.	O cliente precisa entrar em contato com o emissor do cartão para verificar se o cartão pode ser usado nesse tipo de compra.
`card_velocity_exceeded`	O cliente excedeu o saldo, o limite de crédito ou o limite de valor da transação disponível no cartão.	O cliente precisa entrar em contato com o emissor do cartão para obter mais informações.
`currency_not_supported`	O cartão não aceita a moeda especificada.	O cliente precisa verificar com o emissor se o cartão pode ser usado para o tipo de moeda especificado.
`do_not_honor`	O cartão foi recusado por um motivo desconhecido.	O cliente precisa entrar em contato com o emissor do cartão para obter mais informações.
deprecated`do_not_try_again`	O cartão foi recusado por um motivo desconhecido.	O cliente precisa entrar em contato com o emissor do cartão para obter mais informações.
`duplicate_transaction`	Uma transação com valor e dados de cartão de crédito idênticos foi executada recentemente.	Verifique se já existe um pagamento recente.
`expired_card`	O cartão expirou.	O cliente precisa usar outro cartão.
`fraudulent`	O pagamento foi recusado porque a Stripe suspeita que é fraudulento.	Não informe mais detalhes para o cliente. Apresente o motivo como um `generic_decline`.
`generic_decline`	O cartão foi recusado por um motivo desconhecido ou o Stripe Radar bloqueou o pagamento.	O cliente precisa entrar em contato com o emissor do cartão para obter mais informações.
`incorrect_number`	O número do cartão está incorreto.	O cliente precisa tentar novamente usando o número do cartão correto.
`incorrect_cvc`	O número CVC está incorreto.	O cliente precisa tentar novamente usando o CVC correto.
`incorrect_pin`	O PIN inserido está incorreto. O código de recusa de pagamento somente se aplica a pagamentos feitos com máquina de cartão.	O cliente precisa tentar novamente usando o PIN correto.
`incorrect_zip`	O código postal está incorreto.	O cliente precisa tentar novamente usando o código postal de faturamento correto.
`insufficient_funds`	O cartão não tem saldo suficiente para concluir a compra.	O cliente precisa usar outra forma de pagamento.
`invalid_account`	O cartão, ou a conta à qual o cartão está vinculado, é inválido.	O cliente precisa entrar em contato com o emissor do cartão para verificar se o cartão está funcionando corretamente.
`invalid_amount`	O valor do pagamento é inválido ou excede o valor permitido.	Se o valor parece estar correto, o cliente precisa verificar com o emissor do cartão se pode fazer compras nesse valor.
`invalid_cvc`	O número CVC está incorreto.	O cliente precisa tentar novamente usando o CVC correto.
`invalid_expiry_month`	O mês de validade é inválido.	O cliente precisa tentar novamente usando a data de validade correta.
`invalid_expiry_year`	O ano de validade é inválido.	O cliente precisa tentar novamente usando a data de validade correta.
`invalid_number`	O número do cartão está incorreto.	O cliente precisa tentar novamente usando o número do cartão correto.
`invalid_pin`	O PIN inserido está incorreto.	O cliente precisa tentar novamente usando o PIN correto.
`issuer_not_available`	Não foi possível entrar em contato com o emissor do cartão para autorizar o pagamento.	Tente pagar novamente. Se você ainda não conseguir processá-lo, o cliente precisará falar com o emissor do cartão.
`lost_card`	O pagamento foi recusado porque o cartão foi declarado como perdido.	O motivo específico da recusa não deve ser comunicado ao cliente. Apresente o motivo como um `generic_decline`.
`merchant_blacklist`	O pagamento foi recusado porque está incluído na lista de bloqueios do usuário da Stripe.	Não informe mais detalhes para o cliente. Apresente o motivo como um `generic_decline`.
`new_account_information_available`	O cartão, ou a conta à qual o cartão está vinculado, é inválido.	O cliente precisa entrar em contato com o emissor do cartão para obter mais informações.
`no_action_taken`	O cartão foi recusado por um motivo desconhecido.	O cliente precisa entrar em contato com o emissor do cartão para obter mais informações.
`not_permitted`	O pagamento não é permitido.	O cliente precisa entrar em contato com o emissor do cartão para obter mais informações.
`offline_pin_required`	O cartão foi recusado, pois exige um PIN.	O cliente precisa tentar novamente inserindo o cartão e informando um PIN.
`online_or_offline_pin_required`	O cartão foi recusado, pois exige um PIN.	Para máquinas de cartão compatíveis com o PIN online, solicite ao cliente um PIN sem criar uma transação. Para as outras máquinas de cartão, o cliente precisa tentar novamente inserindo o cartão e informando um PIN.
`pickup_card`	O cliente não pode usar esse cartão para fazer o pagamento (é possível que tenha sido declarado como perdido ou roubado).	É necessário entrar em contato com o emissor do cartão para obter mais informações.
`pin_try_exceeded`	O limite de tentativas de informar o PIN foi ultrapassado.	O cliente precisa usar outro cartão ou forma de pagamento.
`processing_error`	Ocorreu um erro ao processar o cartão.	Tente pagar novamente. Se o erro persistir, tente outra vez mais tarde.
`reenter_transaction`	O emissor não conseguiu processar o pagamento por um motivo desconhecido.	Tente pagar novamente. Se o pagamento falhar, o cliente precisa entrar em contato com o emissor do cartão.
`restricted_card`	O cliente não pode usar esse cartão para fazer o pagamento (é possível que tenha sido declarado como perdido ou roubado).	O cliente precisa entrar em contato com o emissor do cartão para obter mais informações.
`revocation_of_all_authorizations`	O cartão foi recusado por um motivo desconhecido.	O cliente precisa entrar em contato com o emissor do cartão para obter mais informações.
`revocation_of_authorization`	O cartão foi recusado por um motivo desconhecido.	O cliente precisa entrar em contato com o emissor do cartão para obter mais informações.
`security_violation`	O cartão foi recusado por um motivo desconhecido.	O cliente precisa entrar em contato com o emissor do cartão para obter mais informações.
`service_not_allowed`	O cartão foi recusado por um motivo desconhecido.	O cliente precisa entrar em contato com o emissor do cartão para obter mais informações.
`stolen_card`	O pagamento foi recusado porque o cartão foi declarado como roubado.	Não informe mais detalhes para o cliente. Apresente o motivo como um `generic_decline`.
`stop_payment_order`	O cartão foi recusado por um motivo desconhecido.	O cliente precisa entrar em contato com o emissor do cartão para obter mais informações.
`testmode_decline`	Foi usado um número de cartão de teste da Stripe.	Use um cartão real para fazer um pagamento.
`transaction_not_allowed`	O cartão foi recusado por um motivo desconhecido.	O cliente precisa entrar em contato com o emissor do cartão para obter mais informações.
deprecated`try_again_later`	O cartão foi recusado por um motivo desconhecido.	Solicite ao cliente que tente pagar novamente. Se as novas tentativas forem recusadas, ele precisará entrar em contato com o emissor do cartão para obter mais informações.
`withdrawal_count_limit_exceeded`	O cliente excedeu o saldo ou o limite de crédito disponível no cartão.	O cliente precisa usar outra forma de pagamento.