Pagamenti con carta nell'API ChargesEredità

Le API Charges e Tokens sono API precedenti, utilizzate nelle vecchie integrazioni Stripe per accettare i pagamenti con carte di credito e di debito. Per le nuove integrazioni, utilizza PaymentIntents.

L’API Charges limita la possibilità da parte tua di usufruire delle funzionalità di Stripe. Per sfruttare le funzionalità più recenti utilizza Stripe Checkout o esegui la migrazione all’API Payment Intents.

Flusso di pagamento

Nella maggior parte dei casi, l’API PaymentIntents offre maggiore flessibilità e più opzioni per l’integrazione.

Rimborsi

To refund a payment through the API, create a Refund and provide the ID of the charge to be refunded.

curl https://api.stripe.com/v1/refunds \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d charge={{CHARGE_ID}}

Per effettuare un rimborso parziale di un pagamento, specifica un parametro amount, che deve essere un numero intero espresso in centesimi (o nell’unità più piccola della valuta di addebito).

curl https://api.stripe.com/v1/refunds \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d charge={{CHARGE_ID}} \
  -d amount=1000

Apple Pay

Quando il cliente approva il pagamento, la tua app implementa i metodi PKPaymentAuthorizationViewControllerDelegate per ricevere un’istanza di PKPayment contenente i dati crittografati della sua carta.

1. Usa il metodo SDK createTokenWithPayment per trasformare il PKPayment in un Token Stripe.
2. Utilizza questo Token per creare un addebito.

extension CheckoutViewController: PKPaymentAuthorizationViewControllerDelegate {

    func paymentAuthorizationViewController(_ controller: PKPaymentAuthorizationViewController, didAuthorizePayment payment: PKPayment, handler: @escaping (PKPaymentAuthorizationResult) -> Void) {
        // Convert the PKPayment into a Token
        STPAPIClient.shared.createToken(withPayment: payment) { token, error in
              guard let token = token else {
                  // Handle the error
                  return
              }
            let tokenID = token.tokenId
            // Send the token identifier to your server to create a Charge...
            // If the server responds successfully, set self.paymentSucceeded to YES
        }
    }

    func paymentAuthorizationViewControllerDidFinish(_ controller: PKPaymentAuthorizationViewController) {

Voce di estratto conto dinamica

Per impostazione predefinita, la voce per gli estratti conto del tuo account Stripe appare sugli estratti conto del cliente ogni volta che addebiti un importo sulla sua carta. Inoltre, puoi impostare la voce per gli estratti conto in modo dinamico per ogni richiesta di addebito con l’argomento statement_descriptor nell’oggetto Charge.

curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=999 \
  -d "currency"="usd" \
  -d "description"="Example charge" \
  -d "source"="tok_visa" \
  -d "statement_descriptor"="Custom descriptor"

Le voci di estratto conto non possono contenere più di 22 caratteri, utilizzare i caratteri speciali <, >, ', " o *ed essere costituite solo da numeri.

Quando imposti la voce di estratto conto in modo dinamico su pagamenti tramite carta di credito o di debito, la parte dinamica viene aggiunta alla fine della voce di estratto conto dell’esercente nominale del pagamento (separata da un asterisco * e da uno spazio). Ad esempio, una voce di estratto conto di un’azienda denominata FreeCookies che include il tipo di biscotto acquistato potrebbe essere FREECOOKIES* SUGAR.

L’asterisco (*) e lo spazio sono inclusi nel limite di 22 caratteri. Inoltre, Stripe destina automaticamente 10 caratteri alla voce di estratto conto dinamica. Ciò significa che, se la voce dell’esercente nominale del pagamento e la voce di estratto conto dinamica superano i 10 caratteri, la voce dell’esercente del saldo potrebbe essere troncata. Se anche la voce di estratto conto dinamica supera questo limite, entrambe le voci vengono troncate a 10 caratteri.

Se hai problemi con i limiti di caratteri, puoi impostare una voce di estratto conto abbreviata nella Dashboard Stripe per abbreviare la voce dell’esercente nominale del pagamento. Avrai così più spazio per la voce di estratto conto dinamica. La voce abbreviata:

• Sostituisce la voce di estratto conto dell’esercente nominale del pagamento quando si utilizzano voci dinamiche.
• Può contenere da 2 a 10 caratteri.

Se non sai che aspetto hanno le voci di estratto conto quando sono combinate, puoi controllarle nella Dashboard Stripe.

Archiviare informazioni nei metadati

Stripe supporta l’aggiunta dei metadati alle richieste più comuni effettuate, ad esempio l’elaborazione degli addebiti. I metadati non vengono mostrati ai clienti né considerati per determinare se un addebito deve essere o meno rifiutato o bloccato dal nostro sistema di prevenzione delle frodi.

Attraverso i metadati, puoi associare altre informazioni per te significative all’attività Stripe. Tutti i metadati che includi sono visibili nella Dashboard (ad esempio, nella pagina di un singolo addebito) e sono inoltre disponibili nei report e nelle esportazioni comuni. Ad esempio, l’ID ordine del tuo negozio può essere associato all’addebito utilizzato per pagare tale ordine. Questo consente a te, al tuo commercialista e al tuo team finanziario di riconciliare facilmente i pagamenti in Stripe con gli ordini nel tuo sistema.

Se utilizzi Radar, puoi specificare come metadati qualsiasi informazione aggiuntiva sui clienti e sugli ordini. In tal modo, puoi scrivere regole Radar utilizzando gli attributi dei metadati e disporre nella Dashboard di maggiori informazioni sui pagamenti, accelerando così la procedura di revisione.

curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=999 \
  -d "currency"="usd" \
  -d "description"="Example charge" \
  -d "source"="tok_visa" \
  -d "metadata[order_id]"=6735

Pagamenti rifiutati

Se desideri che la tua integrazione risponda ai pagamenti non andati a buon fine in modo automatico, puoi accedere alla proprietà outcome di un addebito in due modi.

• Gestisci l’errore API restituito con l’esito negativo di un pagamento. Per i pagamenti bloccati o rifiutati dall’emittente della carta, l’errore include l’ID di addebito, che puoi usare per recuperare l’addebito.
• Utilizza i webhook per monitorare gli aggiornamenti di stato. Ad esempio, quando un pagamento non va a buon fine si attiva l’evento charge.failed.