Pagamenti rifiutati

I motivi per cui i pagamenti possono non andare a buon fine sono diversi, tra cui alcuni che aiutano a prevenire le transazioni fraudolente. Stripe si impegna per ridurre i tassi di rifiuto per tutte le modalità di pagamento supportate. Collaboriamo con società emittenti e circuiti per migliorare i tassi di accettazione, spesso senza influire sulla tua integrazione.

I motivi per cui i pagamenti possono non andare a buon fine sono tre:

• Rifiuti della società emittente
• Pagamenti bloccati
• Chiamate API non valide

Devi gestire ogni tipo di errore di pagamento in modo diverso. Per ogni errore, puoi utilizzare la Dashboard o l’API per esaminare i dettagli di un pagamento. Quando utilizzi l’API, osserva il risultato dell’oggetto Charge. Questo attributo riguarda il tipo di mancato pagamento e fornisce informazioni sulla sua causa.

Stripe gestisce i rifiuti delle modalità di pagamento senza carta più o meno nello stesso modo in cui gestisce i pagamenti con carta rifiutati. Ti invia un codice di risposta che include informazioni sul rifiuto, per esempio indicando se il rifiuto è dovuto a fondi insufficienti, a una carta smarrita o rubata o a qualche altro motivo.

Rifiuti da parte della società emittente

Quando la società emittente della carta del cliente riceve un addebito, i suoi sistemi e modelli automatizzati stabiliscono se autorizzarlo. Questi strumenti analizzano segnali quali abitudini di spesa, saldo del conto e dati della carta (data di scadenza, i dati relativi all’indirizzo e CVC).

Se la società emittente della carta rifiuta un pagamento, Stripe condivide con te tutte le informazioni sul rifiuto di cui dispone. Queste informazioni sono disponibili nella Dashboard e tramite API. Quando le società emittenti forniscono spiegazioni specifiche, come un numero di carta errato o fondi insufficienti, queste spiegazioni vengono restituite a Stripe tramite codici di rifiuto.

Pagamenti bloccati

Stripe Radar blocca i pagamenti ad alto rischio, come quelli con CVC o codici postali non corrispondenti. Questo strumento automatico di Stripe per la prevenzione delle frodi valuta ogni pagamento, senza richiedere alcuna azione da parte tua.

Un pagamento che Radar ha rifiutato

Quando Stripe blocca un pagamento, ottiene l’autorizzazione iniziale dalla società emittente della carta, ma evita di eseguire l’addebito sulla carta. Questa precauzione aiuta a prevenire potenziali pagamenti fraudolenti che potrebbero generare contestazioni.

Per alcuni tipi di carta, i clienti potrebbero vedere l’autorizzazione della società emittente per l’importo del pagamento sul proprio estratto conto. Tuttavia, Stripe non addebita tale importo e non preleva alcun fondo. La società emittente della carta di solito rimuove l’autorizzazione dall’estratto conto del cliente entro pochi giorni.

Se una regola che hai configurato blocca un pagamento che riconosci come legittimo, puoi rimuovere il blocco individuando il pagamento nella Dashboard e facendo clic su Aggiungi all’elenco di consenso. Questa azione non avvia un nuovo tentativo di pagamento. Al contrario, annulla tutte le altre regole che bloccano i futuri tentativi di pagamento che corrispondono all’attributo dell’elenco.

Se usi l’API, la proprietà outcome di un pagamento bloccato riporta la tipologia di pagamento non riuscito e le relative motivazioni, oltre che il livello di rischio stimato.

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

Chiamate API non valide

Nell’API, potresti visualizzare una chiamata API non valida come la seguente:

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"

La chiamata API non valida genera una risposta di errore che potrebbe essere simile a questa:

{
  "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"
  }
}

Il risultato di un pagamento rifiutato include la tipologia di pagamento non riuscito e il motivo, in base al codice di rifiuto della società emittente della carta. Il motivo può contenere informazioni diverse dal codice di risposta della società emittente, ad esempio se la valutazione di una regola Radar ha bloccato l’addebito.

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

Mentre sviluppi la tua integrazione Stripe, testala continuamente per identificare tutti i potenziali bug che comporterebbero chiamate API non valide. In genere, le chiamate API non valide fanno sì che un pagamento non sia visualizzato nella Dashboard. In alcuni casi, comunque, il pagamento potrebbe essere visualizzato.

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