Externe Zahlungsmethoden hinzufügen

Fügen Sie dem Mobile Payment Element externe Zahlungsmethoden hinzu.

Notiz

Wir haben eine nutzerdefinierte Zahlungsmethode-Funktion entwickelt, mit der Sie Ihre Zahlungsintegration um Zahlungsmethoden erweitern können, die außerhalb von Stripe verarbeitet werden. Wir empfehlen die Verwendung dieser Methode für Ihre Integration anstelle von externen Zahlungsmethoden.

In-App Payments kann externe Zahlungsmethoden anzeigen, die Sie zusätzlich zu den über Stripe abgewickelten Zahlungsmethoden unterstützen. Die Integration von externen Zahlungsmethoden erfordert zusätzliche Integrationsschritte, da Transaktionen mit externen Zahlungsmethoden außerhalb von Stripe abgewickelt und abgeschlossen werden.

Zuständigkeit für externe Zahlungsmethoden

Wenn Kundinnen und Kunden eine externe Zahlungsmethode wählen, wickelt nicht Stripe die Zahlung ab, sondern Ihre App. Weitere Informationen zu Ihren Verantwortlichkeiten und der ständigen Verfügbarkeit externer Zahlungsmethoden finden Sie im Haftungsausschluss für externe Zahlungsmethoden.

In diesem Leitfaden wird die externe Zahlungsmethode Fawry mithilfe des Leitfadens In-App-Zahlungen im Zahlungsformular akzeptieren hinzugefügt. Weitere Informationen finden Sie in der Liste aller verfügbaren externen Zahlungsmethoden.

Bevor Sie loslegen

Erstellen Sie ein Stripe-Konto oder melden Sie sich an.
Folgen Sie dem Payment Sheet-Beispiel, um eine Zahlungsintegration abzuschließen.
Schließen Sie für jede externe Zahlungsmethode, die Sie hinzufügen möchten, die Integration ab und vergewissern Sie sich, dass sie in der Region funktioniert, in der Sie sie aktivieren möchten.

Externe Zahlungsmethoden hinzufügen

Wenn Sie Ihr PaymentSheet.Configuration-Objekt erstellen und PaymentSheet initialisieren, geben Sie die externen Zahlungsmethoden an, die Sie dem Payment Element hinzufügen möchten, und einen Handler zum Abschließen der Zahlung an. In dem Beispiel wird Fawry hinzugefügt:

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

Zahlung abschließen

Wenn die Kundinnen und Kunden mit einer externen Zahlungsmethode auf die Schaltfläche Kaufen in PaymentSheet klicken, wird der Handler mit dem Typ (zum Beispiel „external_fawry“), alle erfassten Abrechnungsdetails und einem Abschluss-Handler aufgerufen.

Ihre Implementierung schließt die Zahlung ab (beispielsweise mithilfe des SDK Ihres externen Zahlungsmethodenanbieters) und ruft den Abschluss-Handler mit dem Ergebnis der Zahlung auf: completed , canceled oder failure(error:).

Wenn Sie .failure(error:) übergeben, zeigt das PaymentSheet den Fehler mithilfe von errorDescription für Swift-Fehler und localizedDescription für NSErrors an.

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

OptionalExterne Zahlungsmethoden positionieren

Externe Zahlungsmethoden werden von der intelligenten Anordnungslogik von Stripe nicht intelligent eingestuft, da Stripe keinen Kontext zu diesen Zahlungsmethoden hat. Sie werden standardmäßig nach von Stripe unterstützten Zahlungsmethoden angezeigt. Legen Sie PaymentSheet.Configuration.paymentMethodOrder fest, um die externe Zahlungsmethode explizit im Payment Element festzulegen. Die von Stripe unterstützten Zahlungsmethoden, die auf die externe Zahlungsmethode folgen, werden weiterhin intelligent eingestuft.

var configuration = PaymentSheet.Configuration()
// Show cards first, followed by external_fawry, followed by all other payment methods
configuration.paymentMethodOrder = ["card", "external_fawry"]

Ihre Integration testen

Durchlaufen Sie Ihren eigenen Bezahlvorgang und vergewissern Sie sich, dass Fawry im Payment Element angezeigt wird. In diesem Beispiel wird Fawry an zweiter Stelle, nach der Kartenzahlung, konfiguriert.
Wählen Sie die Zahlungsmethode Fawry aus.
Klicken Sie auf Jetzt bezahlen, um Ihre bestehende Fawry-Integration zu testen. Vergewissern Sie sich, dass Ihre Integration die Transaktion abschließt, und dass alle Aktionen nach der Zahlung (zum Beispiel das Anzeigen einer Bestätigungsseite, Erfolgsmeldung oder Fehlermeldung) mit Ihrer Fawry-Integration weiterhin funktionieren.

Überlegungen zum Dashboard

PaymentIntents für Transaktionen, die mit einem externen Anbieter von Zahlungsmethoden verarbeitet werden, weisen im Dashboard den Status incomplete auf. Stripe ist nicht an Transaktionen mit externen Zahlungsmethoden beteiligt und kann den Status dieser Transaktionen nicht ermitteln.

Wenn Sie Zahlungsdetails erfassen, bevor Sie einen Intent erstellen, werden im Stripe-Dashboard keine incomplete Transaktionen für Transaktionen angezeigt, die mit einem externen Zahlungsmethodenanbieter verarbeitet wurden.

Haftungsausschluss für externe Zahlungsmethoden

Sie können das Stripe Mobile Payment Element verwenden, um einige externe Zahlungsmethoden anzuzeigen, die derzeit von Stripe nicht unterstützt werden, mit denen Sie jedoch direkt vernetzt sind. Wenn Kundinnen und Kunden eine externe Zahlungsmethode wählen, schließt Ihre App die Transaktion ab und nicht das Stripe Mobile Payment Element. Sie bestätigen, dass:

Externe Zahlungsmethoden werden von Stripe weder angeboten noch unterstützt. Der Betrieb und die Unterstützung externer Zahlungsmethoden wird durch den externen Anbieter von Zahlungsmethoden bereitgestellt.
Sie sind für die Bereitstellung einer direkten Integration mit dem externen Zahlungsmethodenanbieter verantwortlich.
Sie müssen eine Vereinbarung mit dem externen Zahlungsmethodenanbieter abschließen und sind für die Einhaltung Ihrer Vereinbarung(en) mit jedem externen Zahlungsmethodenanbieter verantwortlich.
Sie sind dafür verantwortlich, alle erforderlichen Rechte zu erwerben, um die Marken und Logos der externen Zahlungsmethodenanbieter in Ihrem Bezahlvorgang, wie in diesen Dokumenten beschrieben, zu verwenden.
Stripe ist nicht verantwortlich für die Verarbeitung von Transaktionen mit einem externen Zahlungsmethodenanbieter, einschließlich beispielsweise Zahlungen, Rückerstattungen, Anfechtungen, Zahlungsabwicklungen oder Geldbewegungen.
Sie oder der externe Zahlungsmethodenanbieter sind für den Abschluss des Kaufvorgangs verantwortlich, nachdem ein Kunde/eine Kundin eine externe Zahlungsmethode ausgewählt hat, einschließlich beispielsweise der Bestellbestätigung und des Bestellabgleichs.
Sie sind dafür verantwortlich, dass die Weiterleitungs-URL für die externe Zahlungsmethode korrekt konfiguriert wird.
Sie müssen alle externen Zahlungsmethoden sofort entfernen, falls Ihre Vereinbarung(en) mit einem externen Zahlungsmethodenanbieter beendet werden oder Stripe die Verfügbarkeit einer externen Zahlungsmethode aufhebt.
Sie dürfen nur die in diesem Leitfaden aufgeführten externen Zahlungsmethoden im Payment Element integrieren und dort darstellen.
Sie alleine sind dafür verantwortlich, sicherzustellen, ass Käufer/innen korrekt an die von ihnen ausgewählte externe Zahlungsmethode weitergeleitet werden.

Ständige Verfügbarkeit externer Zahlungsmethoden

Stripe kann jederzeit beschließen, die Verfügbarkeit einer Zahlungsmethode als externe Zahlungsmethode aufzuheben. Stripe benachrichtigt Sie über die Aufheben einer externen Zahlungsmethode, die Sie verwenden, und Sie müssen die externe Zahlungsmethode sofort aus Ihrem Code entfernen. Andernfalls wird die externe Zahlungsmethode für Ihre Kundinnen/Kunden nicht gerendert.

Verfügbare externe Zahlungsmethoden

Sie können die folgenden externen Zahlungsmethoden anzeigen. Sie müssen den entsprechenden externen Zahlungsmethodentyp in Ihrem Code verwenden.

Region	Zahlungsmethode	Typ der externen Zahlungsmethode

AMER	Interac	`external_interac`
APAC	au PAY	`external_au_pay`
APAC	atone	`external_atone`
APAC	Touch’n Go	`external_tng_ewallet`
APAC	ソフトバンクまとめて支払い (Softbank-Zahlungen)	`external_softbank_carrier_payment`
APAC	Toss Pay	`external_toss_pay`
APAC	Laybuy	`external_laybuy`
APAC	Bank Pay	`external_bank_pay`
APAC	auかんたん決済 (au easy-Zahlungen)	`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`
Asien-Pazifik, 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`
Global	LINE Pay	`external_line_pay`
Global	paysafecard	`external_paysafecard`
Global	Samsung Pay	`external_samsung_pay`
Global	Sezzle	`external_sezzle`
LATAM	Dapp	`external_dapp`
LATAM	PicPay	`external_picpay`
MEA	Tabby	`external_tabby`
MEA	Benefit	`external_benefit`
MEA	Fawry	`external_fawry`