NewNo plan feeNo plan fee. Just 2.9% + $0.30 per card sale, and signing up is free.Try now →

Braintree · Códigos de recusa

O que significa Braintree 2026 “Invalid Merchant ID”?

Verificado em

Braintree 2026 “Invalid Merchant ID” geralmente significa que o banco do comprador recusou porque o cartão não suporta este tipo de transação. A Braintree o classifica como "soft" e o mapeia para a Visa category 2, então são permitidas até 15 tentativas em 30 dias. Se muitos clientes diferentes encontrarem esse erro, a Braintree diz que pode ser um problema de conectividade ou configuração na sua conta.

Tipo
Recusa suave
Quem recusou
O banco do comprador ou sua configuração
Tentar novamente
Sim, mais tarde. Visa category 2: no máximo 15 tentativas em 30 dias
Ação do comprador
Tentar outro cartão
Ação do lojista
Entrar em contato com a Braintree se isso acontecer com muitos clientes

O que a PlatformDTC faz

A PlatformDTC não se conecta à Braintree. A resposta da rede para um lojista inválido é Visa 03, que a Visa classifica na category 2. No sistema Stripe da PlatformDTC, uma falha do lado da conta, e não do cartão (uma chave revogada, perda de acesso à conta da loja, uma interrupção), não é registrada como recusa do cliente: a renovação permanece devida, é cobrada novamente por uma varredura de 15 minutos assim que corrigida, e o assinante não recebe e-mail de “pagamento falhou”.

Por que acontece

Ou o cartão não pode ser usado para o seu tipo de transação, ou, quando se repete para todos, o ID do lojista não está configurado corretamente no processador.

O que a loja pode fazer

Verifique se é um cartão ou muitos. Um cartão: peça outro. Muitos: entre em contato com a Braintree.

Para desenvolvedores

A Braintree retorna processor_response_code 2026 com processor_response_text “Invalid Merchant ID” e processor_response_type “soft_declined” no objeto Transaction. A Braintree o mapeia para a Visa category 2 (o emissor não pode aprovar neste momento): no máximo 15 tentativas em 30 dias.

Perguntas frequentes

Braintree 2026 é minha culpa ou do comprador?
Um cartão falhando geralmente é o cartão. Muitos cartões falhando apontam para a configuração da sua conta.
Posso tentar novamente o Braintree 2026?
Sim, dentro dos limites da Visa category 2 de 15 tentativas em 30 dias.

Fontes

Relacionado

Biblioteca de pagamentos