# Recusas

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

> #### Acompanhar as taxas de recusa
> 
> Acompanhe sua taxa de recusa ao longo do tempo para identificar possíveis problemas de fraude ou integração. Para obter uma visão geral mais clara das taxas de autorização, analise as recusas únicas e exclua da análise as novas tentativas com falha.

Você precisa tratar cada tipo de falha de pagamento de forma diferente. Para cada falha, você pode usar o [Dashboard](https://dashboard.stripe.com/payments) ou a API para revisar os detalhes de um pagamento. Quando usar a API, observe o [resultado](https://docs.stripe.com/api/charges/object.md#charge_object-outcome) do objeto `Charge`. Este atributo inclui o tipo de falha no pagamento e oferece informações sobre o motivo.

Os pagamentos podem falhar por diversos motivos, incluindo alguns que ajudam a evitar transações fraudulentas. A Stripe se esforça para reduzir a taxa de transações negadas em todas as formas de pagamento aceitas, trabalhando 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 pelo emissor](https://docs.stripe.com/declines.md#issuer-declines)
- [Pagamentos bloqueados](https://docs.stripe.com/declines.md#blocked-payments)
- [Chamadas da API inválidas](https://docs.stripe.com/declines.md#invalid-api-calls)

## 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).

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).

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 recebe por meio dos [códigos de pagamento recusado da Stripe](https://docs.stripe.com/declines/codes.md). Essas informações estão disponíveis no Dashboard e pela API.

Quando os emissores fornecem explicações específicas, como número de cartão incorreto ou fundos insuficientes, essas explicações são retornadas à Stripe [como códigos de recusa da rede](https://docs.stripe.com/declines/network-codes.md).

## Pagamentos bloqueados

O *Stripe Radar* (Stripe Radar helps detect and block fraud for any type of business using machine learning that trains on data across millions of global companies. It’s built into Stripe and requires no additional setup to get started) 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.

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, é possível retirar 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 em futuras tentativas de pagamento que correspondam ao atributo da lista.

> Você não vê o botão **Adicionar à lista de permissões** na página de dados do pagamento? [Fale com a Stripe](https://support.stripe.com/email) 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.

```json
...
"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 [preços IC+](https://support.stripe.com/questions/understanding-blended-interchange-pricing), o Adaptive Acceptance bloqueia determinados 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.

```json
...
"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:

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=2000 \
  -d currency=usd \
  -d payment_method=pm_card_chargeDeclinedIncorrectCvc \
  -d confirm=true
```

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

```json
{
  "error": {
    "code": "incorrect_cvc",
    "doc_url": "https://docs.stripe.com/error-codes#incorrect-cvc",
    "message": "Your card's security code is incorrect.",
    "param": "cvc",
    "type": "card_error"
  }
}
```

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

```json
...
"outcome": {
  "network_decline_code": "54",
  "network_advice_code": "03",
  "network_status": "declined_by_network",
  "reason": "expired_card",
  "advice_code": "confirm_card_data",
  "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](https://docs.stripe.com/testing.md) 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.

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

## See also

- [Recusas de cartão](https://docs.stripe.com/declines/card.md)
- [Testar pagamentos recusados](https://docs.stripe.com/testing.md#declined-payments)
- [Reembolsar e cancelar pagamentos](https://docs.stripe.com/refunds.md)