Recusas

Saiba mais sobre pagamentos recusados e como reduzir sua taxa de recusa.

Os pagamentos podem falhar por diversos motivos, incluindo alguns que ajudam a evitar transações fraudulentas. A Stripe se esforça para reduzir as taxas de recusa em todas as formas de pagamento aceitas. Trabalhamos com emissores e redes para melhorar as taxas de aceitação, muitas vezes sem afetar sua integração.

Há três motivos para a falha de um pagamento:

Você precisa tratar cada tipo de falha de pagamento de forma diferente. Para cada falha, você pode usar o Dashboard ou a API para revisar os detalhes de um pagamento. Quando usar a API, observe o resultado do objeto Charge. Este atributo inclui o tipo de falha no pagamento e oferece informações sobre o motivo.

A Stripe trata recusas de formas de pagamento sem cartão de forma similar às recusas de cartão. A Stripe envia a você um código de resposta que inclui informações sobre a recusa (por exemplo, se a recusa foi causada por saldo insuficiente, cartão perdido ou roubado ou por algum outro motivo).

Recusa do emissor

Quando o emissor do cartão ou o provedor de pagamento do seu cliente recebe uma cobrança, seus sistemas e modelos automatizados decidem se devem autorizá-la. Essas ferramentas analisam sinais como hábitos de gastos, saldo da conta e dados do cartão (data de validade, informações de endereço e CVC).

Se o emissor do cartão ou o provedor de pagamento recusar um pagamento, a Stripe compartilha com você as informações sobre o pagamento recusado que recebemos através dos códigos de pagamento recusado da Stripe. Essas informações estão disponíveis no Dashboard e pela API. Quando os emissores fornecem explicações específicas, como um número de cartão incorreto ou fundos insuficientes, essas explicações retornam à Stripe como códigos de pagamento recusado da rede.

Pagamentos bloqueados

O Stripe Radar bloqueia pagamentos de alto risco, incluindo os que violam suas regras personalizadas ou têm pontuações de risco altas. Este produto automatizado de prevenção de fraudes avalia cada pagamento sem exigir nenhuma ação de sua parte.

Um pagamento recusado pelo Radar

Quando a Stripe bloqueia um pagamento, ela não obtém autorização do emissor do cartão. Essa precaução ajuda a prevenir possíveis pagamentos fraudulentos que podem gerar contestações.

Para alguns tipos de cartão, os clientes podem ver a autorização do emissor do cartão para o valor do pagamento no extrato. No entanto, a Stripe não cobrou esse valor nem retirou fundos. Normalmente, o emissor do cartão remove essa autorização do extrato do cliente em alguns dias.

Se uma regra configurada por você bloquear um pagamento que você reconhece como legítimo, retire o bloqueio localizando o pagamento no Dashboard e clicando em "Adicionar à lista de permissões. Esta ação não repete o pagamento. Em vez disso, ele sobrepõe todas as suas outras regras de bloqueio de futuras tentativas de pagamento que correspondam ao atributo da lista.

Observação

Você não vê o botão Adicionar à lista de permissões na página de dados do pagamento? Fale com a Stripe para adicionar esse recurso à sua conta Radar.

Quando você usa a API, o outcome de um pagamento bloqueado mostra o tipo e o motivo da falha de pagamento, além do nível de risco avaliado.

...
outcome: {
  network_decline_code: null,
  network_advice_code: null,
  network_status: "not_sent_to_network",
  reason: "highest_risk_level",
  advice_code: "do_not_try_again",
  risk_level: "highest",
  seller_message: "Stripe blocked this charge as too risky.",
  type: "blocked"
},
...

Para usuários com planos de preços IC+, o Adaptive Acceptance bloqueia certos pagamentos para ajudar a evitar custos de rede desnecessários. Por exemplo, o Adaptive Acceptance ajuda a evitar penalidades excessivas por novas tentativas. O Adaptive Acceptance também pode ajudar a evitar custos de rede, bloqueando pagamentos com baixa probabilidade de autorização.

...
outcome: {
  network_decline_code: null,
  network_advice_code: null,
  network_status: "not_sent_to_network",
  reason: "low_probability_of_authorization",
  advice_code: "do_not_try_again",
  risk_level: "normal",
  seller_message: "Stripe blocked this payment as it is unlikely to be authorized.",
  type: "blocked"
},
...

Chamadas de API inválidas

Na API, você pode ver uma chamada de API inválida como a seguinte:

A chamada de API inválida gera uma resposta de erro que pode ser assim:

{
  "error": {
    "code": "invalid_number",
    "doc_url": "https://docs.stripe.com/error-codes#invalid-number",
    "message": "Your card number is incorrect.",
    "param": "card[number]",
    "type": "card_error"
  }
}

O resultado de um pagamento recusado inclui o tipo e o motivo de falha do pagamento, com base no código de recusa do emissor do cartão. O motivo pode conter informações diferentes do código de resposta do emissor (por exemplo, se uma avaliação de regra do Radar bloqueou a cobrança).

...
outcome: {
  network_decline_code: "54",
  network_advice_code: "01",
  network_status: "declined_by_network",
  reason: "expired_card",
  advice_code: "do_not_try_again",
  risk_level: "normal",
  seller_message: "The bank returned the decline code `expired_card`.",
  type: "issuer_declined"
},
...

Conforme você desenvolve sua integração da Stripe, teste-a continuamente para identificar possíveis erros que possam causar chamadas de API inválidas. Normalmente, pagamentos com chamadas de API inválidas não aparecem no Dashboard. No entanto, o pagamento pode aparecer em alguns casos.

...
outcome: {
  network_decline_code: null,
  network_advice_code: null,
  network_status: "not_sent_to_network",
  type: "invalid"
},
...