Tambahkan metode pembayaran eksternal

Tambahkan metode pembayaran eksternal ke Mobile Payment Element.

Catatan

Kami membuat fitur metode pembayaran custom yang memungkinkan Anda memperluas integrasi pembayaran dengan metode pembayaran yang diproses di luar Stripe. Kami merekomendasikan penggunaannya untuk integrasi Anda, bukan metode pembayaran eksternal.

Mobile Payment Element dapat menampilkan metode pembayaran eksternal yang Anda dukung selain metode pembayaran yang diproses melalui Stripe. Pengintegrasian metode pembayaran eksternal memerlukan pekerjaan integrasi tambahan, karena transaksi metode pembayaran eksternal diproses dan difinalisasi di luar Stripe.

Tanggung jawab metode pembayaran eksternal

Bila pelanggan memilih metode pembayaran eksternal, aplikasi Anda akan menangani pembayaran, bukan Stripe memprosesnya. Untuk mempelajari tentang tanggung jawab Anda dan ketersediaan berkelanjutan metode pembayaran eksternal, lihat penafian metode pembayaran eksternal.

Panduan ini menambahkan metode pembayaran eksternal, Fawry, menggunakan panduan Terima pembayaran dalam aplikasi Payment Sheet. Lihat daftar semua metode pembayaran eksternal yang tersedia.

Sebelum Anda memulai

Buat akun Stripe atau masuk.
Ikuti contoh Payment Sheet untuk menyelesaikan integrasi pembayaran.
Untuk setiap metode pembayaran eksternal yang ingin Anda tambahkan, selesaikan integrasinya dan konfirmasikan bahwa metode ini berfungsi di wilayah tempat Anda ingin mengaktifkannya.

Tambahkan tipe metode pembayaran eksternal

Saat membuat objek PaymentSheet.Configuration Anda serta menginisialisasi PaymentSheet, tentukan metode pembayaran eksternal yang ingin Anda tambahkan ke Payment Element dan handler untuk menyelesaikan pembayaran. Contoh ini menambahkan 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
  }
}

Selesaikan pembayaran

Bila pelanggan mengetuk tombol Beli di PaymentSheet menggunakan metode pembayaran eksternal, itu akan memanggil handler dengan tipe (misalnya, “external_fawry”), detail tagihan yang dikumpulkan, dan handler penyelesaian.

Implementasi Anda menyelesaikan pembayaran (misalnya, dengan menggunakan SDK penyedia metode pembayaran eksternal) dan memanggil handler penyelesaian dengan hasil pembayaran: completed, canceled, atau failure(error:).

Jika Anda meneruskan .failure(error:), PaymentSheet menampilkan kesalahan menggunakan errorDescription untuk kesalahan Swift dan localizedDescription untuk 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))
    }
}

OpsionalPosisikan metode pembayaran eksternal

Uji integrasi Anda

Periksa alur checkout Anda dan verifikasikan bahwa Payment Element menampilkan Fawry. Contoh ini mengonfigurasikan Fawry di posisi kedua setelah kartu.
Pilih metode pembayaran Fawry.
Klik Bayar sekarang untuk mencoba integrasi Fawry yang ada. Verifikasikan bahwa integrasi Anda menyelesaikan transaksi dan bahwa setiap tindakan pasca-pembayaran (misalnya, menampilkan halaman konfirmasi, pesan keberhasilan, atau pesan kegagalan) tetap berfungsi dengan integrasi Fawry Anda.

Pertimbangan Dashboard

PaymentIntents untuk transaksi yang diproses dengan penyedia metode pembayaran eksternal memiliki status incomplete di Dashboard Stripe. Stripe tidak terlibat dalam transaksi metode pembayaran eksternal dan tidak dapat menentukan status transaksi ini.

Jika mengumpulkan detail pembayaran sebelum membuat Intent, Anda tidak akan melihat transaksi incomplete di Dashboard Stripe untuk transaksi yang diproses dengan penyedia metode pembayaran eksternal.

Sanggahan metode pembayaran eksternal

Anda dapat menggunakan Stripe Mobile Payment Element untuk menampilkan beberapa metode pembayaran eksternal yang tidak didukung oleh Stripe tetapi secara langsung terintegrasi dengan Anda. Bila pelanggan memilih metode pembayaran eksternal, aplikasi Anda akan menyelesaikan transaksi, bukan Stripe Mobile Payment Element. Anda mengakui bahwa:

Metode pembayaran eksternal tidak ditawarkan atau tidak didukung oleh Stripe. Operasi dan dukungan metode pembayaran eksternal disediakan oleh penyedia metode pembayaran eksternal.
Anda bertanggung jawab untuk memelihara integrasi langsung dengan penyedia metode pembayaran eksternal.
Anda perlu menjaga perjanjian dengan penyedia metode pembayaran eksternal dan bertanggung jawab untuk mematuhi perjanjian Anda dengan setiap penyedia metode pembayaran eksternal.
Anda bertanggung jawab untuk mendapatkan semua hak yang diperlukan untuk menggunakan tanda dan logo penyedia metode pembayaran eksternal dalam checkout Anda, seperti yang dijelaskan dalam dokumen ini.
Stripe tidak bertanggung jawab atas pemrosesan transaksi dengan penyedia metode pembayaran eksternal, termasuk, misalnya, charge, pengembalian dana, sengketa, penyelesaian, atau aliran dana.
Anda atau penyedia metode pembayaran eksternal bertanggung jawab atas penyelesaian alur pembelian setelah pelanggan memilih metode pembayaran eksternal, termasuk, misalnya, konfirmasi pesanan dan rekonsiliasi pesanan.
Anda bertanggung jawab untuk mengonfigurasi URL pengalihan untuk metode pembayaran eksternal dengan benar.
Anda harus segera menghapus metode pembayaran eksternal jika perjanjian Anda dengan penyedia metode pembayaran eksternal berakhir atau Stripe menghilangkan ketersediaan metode pembayaran eksternal.
Anda hanya diizinkan untuk mengintegrasikan dengan dan menyajikan metode pembayaran eksternal yang tercantum dalam panduan ini kepada Payment Element.
Anda sepenuhnya bertanggung jawab untuk memastikan bahwa pembeli dialihkan dengan benar ke metode pembayaran eksternal yang dipilih.

Ketersediaan metode pembayaran eksternal yang sedang berlangsung

Stripe mungkin sewaktu-waktu memutuskan untuk menghapus ketersediaan metode pembayaran sebagai metode pembayaran eksternal. Stripe akan memberi tahu Anda tentang penghapusan metode pembayaran eksternal yang Anda gunakan, dan Anda harus segera menghapus metode pembayaran eksternal dalam kode Anda. Kegagalan melakukannya akan mengakibatkan metode pembayaran eksternal tidak ditampilkan kepada pelanggan Anda.

Metode pembayaran eksternal yang tersedia

Anda dapat menampilkan metode pembayaran eksternal berikut ini. Anda harus menggunakan tipe metode pembayaran eksternal yang sesuai dalam kode Anda.

Wilayah	Metode pembayaran	Tipe metode pembayaran eksternal

AMER	Interac	`external_interac`
APAC	au PAY	`external_au_pay`
APAC	atone	`external_atone`
APAC	Touch’n Go	`external_tng_ewallet`
APAC	ソフトバンクまとめて支払い (Softbank carrier payments)	`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, Europe	Shopback Pay	`external_shopback_pay`
Eropa	Aplazame	`external_aplazame`
Eropa	Bizum	`external_bizum`
Eropa	Divido	`external_divido`
Eropa	Fonix	`external_fonix`
Eropa	Iwocapay	`external_iwocapay`
Eropa	KBC	`external_kbc`
Eropa	Nexi Pay	`external_nexi_pay`
Eropa	Oney	`external_oney`
Eropa	Payconiq	`external_payconiq`
Eropa	PayPo	`external_paypo`
Eropa	Sofinco	`external_sofinco`
Eropa	Postepay	`external_postepay`
Eropa	PostFinance	`external_postfinance`
Eropa	Scalapay	`external_scalapay`
Eropa	TrueLayer	`external_truelayer`
Eropa	Walley	`external_walley`
Eropa	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	Manfaat	`external_benefit`
MEA	Fawry	`external_fawry`