Aggiungere metodi di pagamento esterni

Aggiungere metodi di pagamento esterni a Payment Element per dispositivi mobili

Nota

Abbiamo creato metodi di pagamento personalizzati, una funzione che ti consente di estendere la tua integrazione con metodi di pagamento elaborati al di fuori di Stripe. Ti consigliamo di utilizzarla per la tua integrazione anziché usare metodi di pagamento esterni.

Payment Element per dispositivi mobili può mostrare i metodi di pagamento esterni supportati in aggiunta ai metodi di pagamento elaborati tramite Stripe. L’integrazione di metodi di pagamento esterni richiede ulteriori interventi di integrazione, perché le transazioni tramite metodi di pagamento esterni vengono elaborate e finalizzate al di fuori di Stripe.

Responsabilità dei metodi di pagamento esterni

Se un cliente sceglie un metodo di pagamento esterno, l’app gestirà direttamente la transazione anziché affidarsi a Stripe. Per conoscere le tue responsabilità e la disponibilità continua di metodi di pagamento esterni, consulta l’esclusione di responsabilità per i metodi di pagamento esterni.

Questa guida aggiunge un metodo di pagamento esterno, Fawry, utilizzando le istruzioni in Accettare pagamenti in-app di Payment Sheet. Consulta l’elenco di tutti i metodi di pagamento esterni disponibili.

Prima di iniziare

Crea un account Stripe o accedi.
Segui l’esempio di Payment Sheet per completare un’integrazione di pagamento.
Per ogni metodo di pagamento esterno che vuoi aggiungere, completa la relativa integrazione e verifica che funzioni nell’area geografica in cui vuoi abilitarlo.

Aggiungere tipi di metodi di pagamento esterni

Quando crei l’oggetto PaymentSheet.Configuration e inizializzi PaymentSheet, specifica i metodi di pagamento esterno che vuoi aggiungere a Payment Element e un gestore per completare il pagamento. In questo esempio viene aggiunto Fawry:

import StripePaymentSheet

class MyCheckoutVC: UIViewController {
  func setUpPaymentSheet() {
      // ...
      var configuration = PaymentSheet.Configuration()
      configuration.externalPaymentMethodConfiguration = .init(
          externalPaymentMethods: ["external_fawry"]
      ) { externalPaymentMethodType, billingDetails, completion in
          self.handleExternalPaymentMethod(type: externalPaymentMethodType, billingDetails: billingDetails, completion: completion)
      }
      // ...
  }

  func handleExternalPaymentMethod(type: String, billingDetails: STPPaymentMethodBillingDetails, completion: @escaping (PaymentSheetResult) -> Void) {
      // ...explained in the next step
  }
}

Completare il pagamento

Quando il cliente tocca il pulsante Acquista in PaymentSheet utilizzando un metodo di pagamento esterno, chiama il gestore con il tipo (ad es. “external_fawry”), tutti i dati di fatturazione raccolti e un gestore di completamento.

L’implementazione completa il pagamento (ad esempio utilizzando l’SDK del fornitore del metodo di pagamento esterno) e chiama il gestore di completamento con il risultato del pagamento: completed, canceled o failure(error:).

Se specifichi .failure(error:), PaymentSheet visualizza l’errore utilizzando errorDescription per gli errori Swift e localizedDescription per NSErrors.

import StripePaymentSheet

class MyCheckoutVC: UIViewController {
    func setUpPaymentSheet() {
        // ...
        var configuration = PaymentSheet.Configuration()
        configuration.externalPaymentMethods = .init(
            externalPaymentMethods: ["external_fawry"]
        ) { [weak self] externalPaymentMethodType, billingDetails, completion in
            self?.handleExternalPaymentMethod(type: externalPaymentMethodType, billingDetails: billingDetails, completion: completion)
        }
        // ...
    }

    func handleExternalPaymentMethod(type: String, billingDetails: STPPaymentMethodBillingDetails, completion: @escaping (PaymentSheetResult) -> Void) {
        // Your implementation should complete the payment with the payment method provider
        // When the payment completes, cancels, or fails, call the `completion` handler
        // Note you can present on top of PaymentSheet by using the `self.presentedViewController`.
        // This example code just immediately fails:
        let exampleError = NSError(domain: "MyErrorDomain", code: 0, userInfo: [NSLocalizedDescriptionKey: "Failed to complete payment!"])
        completion(.failed(error: exampleError))
    }
}

FacoltativoPosizionare i metodi di pagamento esterni

Testare l'integrazione

Segui il flusso di pagamento e verifica che Payment Element mostri Fawry. Questo esempio configura Fawry nella seconda posizione dopo le carte.
Scegli il metodo di pagamento Fawry.
Fai clic su Paga ora per testare l’integrazione Fawry esistente. Verifica che la tua integrazione completi la transazione e che tutte le azioni successive al pagamento (come la visualizzazione di una pagina di conferma, di un messaggio di operazione riuscita o di errore) funzionino ancora con la tua integrazione Fawry.

Considerazioni sulla Dashboard

I PaymentIntent per le transazioni elaborate con un fornitore di metodi di pagamento esterno hanno lo stato incomplete nella Dashboard Stripe. Stripe non è coinvolta in transazioni con metodi di pagamento esterni e non è in grado di determinare lo stato di tali transazioni.

Se raccogli i dati di pagamento prima di creare un Intent, nella Dashboard Stripe non vedrai transazioni incomplete per le transazioni elaborate con un fornitore di metodi di pagamento esterno.

Limitazione di responsabilità per i metodi di pagamento esterni

Puoi utilizzare Stripe Mobile Payment Element per visualizzare alcuni metodi di pagamento esterni non supportati da Stripe ma con cui ti integri direttamente. Quando i clienti scelgono un metodo di pagamento esterno, la transazione viene completata dalla tua app anziché da Stripe Mobile Payment Element. Accetti quanto segue:

I metodi di pagamento esterni non sono offerti né supportati da Stripe. Il funzionamento e il supporto dei metodi di pagamento esterni sono garantiti dal fornitore del metodo di pagamento esterno.
È tua responsabilità mantenere un’integrazione diretta con il fornitore del metodo di pagamento esterno.
Devi stipulare un contratto con il fornitore del metodo di pagamento esterno e sei responsabile del rispetto dei contratti con ciascun fornitore del metodo di pagamento esterno.
È tua responsabilità acquisire tutti i diritti necessari per utilizzare i marchi e i loghi del fornitore del metodo di pagamento esterno all’interno della procedura di pagamento, come descritto in questa documentazione.
Stripe non è responsabile dell’elaborazione di transazioni con un fornitore di metodi di pagamento esterno, tra cui, a titolo esemplificativo, addebiti, rimborsi, contestazioni, liquidazioni o flussi di fondi.
L’utente o il fornitore del metodo di pagamento esterno sono responsabili del completamento del flusso di acquisto dopo che un cliente ha selezionato un metodo di pagamento esterno, tra cui, a titolo esemplificativo, la conferma dell’ordine e la riconciliazione degli ordini.
È tua responsabilità configurare correttamente l’URL di reindirizzamento per il metodo di pagamento esterno.
Devi rimuovere immediatamente qualsiasi metodo di pagamento esterno nel caso in cui i tuoi contratti con qualsiasi fornitore di metodi di pagamento esterni si risolvano o Stripe revochi la disponibilità di un metodo di pagamento esterno.
Puoi integrare e presentare in Payment Element solo i metodi di pagamento esterni elencati in questa guida.
Hai la responsabilità esclusiva di assicurarti che gli acquirenti siano reindirizzati correttamente al metodo di pagamento esterno scelto.

Disponibilità continua di metodi di pagamento esterni

Stripe può decidere in qualsiasi momento di revocare la disponibilità qualsiasi metodo di pagamento come metodo di pagamento esterno. Stripe ti informerà dell’eventuale revoca della disponibilità di un metodo di pagamento esterno che stai utilizzando e dovrai rimuoverlo immediatamente dal tuo codice. Se non procedi in tal senso, il metodo di pagamento esterno non verrà mostrato ai clienti.

Metodi di pagamento esterni disponibili

Puoi visualizzare i seguenti metodi di pagamento esterni. Devi utilizzare il tipo di metodo di pagamento esterno corrispondente nel tuo codice.

Area geografica	Modalità di pagamento	Tipo di metodo di pagamento esterno

AMER	Interac	`external_interac`
APAC	au PAY	`external_au_pay`
APAC	atone	`external_atone`
APAC	Touch’n Go	`external_tng_ewallet`
APAC	ソフトバンクまとめて支払い (pagamenti tramite operatore Softbank)	`external_softbank_carrier_payment`
APAC	Toss Pay	`external_toss_pay`
APAC	Laybuy	`external_laybuy`
APAC	Bank Pay	`external_bank_pay`
APAC	auかんたん決済 (au easy payments)	`external_au_easy_payment`
APAC	BitCash	`external_bitcash`
APAC	Azupay	`external_azupay`
APAC	d払い (d-barai)	`external_dbarai`
APAC	FamiPay	`external_famipay`
APAC	GCash	`external_gcash`
APAC	GrabPay Later	`external_grabpay_later`
APAC	MoMo	`external_momo`
APAC	NET CASH	`external_net_cash`
APAC	Octopus	`external_octopus`
APAC	Paidy	`external_paidy`
APAC	PayPay	`external_paypay`
APAC	PlanPay	`external_planpay`
APAC	ペイジー (Pay-easy)	`external_pay_easy`
APAC	楽天ペイ (Rakuten Pay)	`external_rakuten_pay`
APAC	メルペイ (Merpay)	`external_merpay`
APAC	WebMoney	`external_webmoney`
APAC, Europa	Shopback Pay	`external_shopback_pay`
Europa	Aplazame	`external_aplazame`
Europa	Bizum	`external_bizum`
Europa	Divido	`external_divido`
Europa	Fonix	`external_fonix`
Europa	Iwocapay	`external_iwocapay`
Europa	KBC	`external_kbc`
Europa	Nexi Pay	`external_nexi_pay`
Europa	Oney	`external_oney`
Europa	Payconiq	`external_payconiq`
Europa	PayPo	`external_paypo`
Europa	Sofinco	`external_sofinco`
Europa	Postepay	`external_postepay`
Europa	PostFinance	`external_postfinance`
Europa	Scalapay	`external_scalapay`
Europa	TrueLayer	`external_truelayer`
Europa	Walley	`external_walley`
Europa	YounitedPay	`external_younited_pay`
In tutto il mondo	LINE Pay	`external_line_pay`
In tutto il mondo	paysafecard	`external_paysafecard`
In tutto il mondo	Samsung Pay	`external_samsung_pay`
In tutto il mondo	Sezzle	`external_sezzle`
LATAM	Dapp	`external_dapp`
LATAM	PicPay	`external_picpay`
MEA	Tabby	`external_tabby`
MEA	Benefit	`external_benefit`
MEA	Fawry	`external_fawry`