Recusas

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:

• Recusas do emissor
• Pagamentos bloqueados
• Chamadas de API inválidas

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 do cliente recebe uma cobrança, seus sistemas e modelos automatizados decidem se deseja autorizá-la. Essas ferramentas analisam sinais como hábitos de consumo, saldo da conta e dados do cartão (data de validade, informações de endereço e CVC).

Se o emissor do cartão recusar um pagamento, a Stripe compartilhará com você todas as informações sobre a recusa que recebermos. Essas informações estão disponíveis no Dashboard e por meio da 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 por meio de códigos de recusa.

Pagamentos bloqueados

O Stripe Radar bloqueia pagamentos de alto risco, como aqueles com CVC ou código postal incorretos divergentes. Esse produto de prevenção automática de fraudes avalia todos os pagamentos sem que você precise fazer nada.

Um pagamento recusado pelo Radar

Quando a Stripe bloqueia um pagamento, obtém a autorização inicial do emissor do cartão, mas não cobra o cartão. Essa precaução ajuda a evitar possíveis pagamentos fraudulentos que podem levar a 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.

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"
},
...

Chamadas de API inválidas

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

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=2000 \
  -d currency=usd \
  -d source=tok_invalid \
  --data-urlencode description="Charge for jenny.rosen@example.com"

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"
},
...