Añade métodos de pago externos

Añade métodos de pago externos al Mobile Payment Element.

Nota

Hemos creado una función de métodos de pago personalizados que te permite ampliar tu integración de pagos con métodos de pago procesados fuera de Stripe. Te recomendamos que lo uses para tu integración en lugar de utilizar métodos de pago externos.

El Mobile Payment Element puede mostrar métodos de pago externos que aceptas además de los métodos de pago que se procesan a través de Stripe. La integración de métodos de pago externos requiere trabajo de integración adicional, ya que las transacciones de métodos de pago externos se procesan y finalizan fuera de Stripe.

Responsabilidad por los métodos de pago externos

Cuando los clientes eligen un método de pago externo, tu aplicación gestiona el pago en lugar de que lo procese Stripe. Para obtener más información sobre tus responsabilidades y la disponibilidad continua de métodos de pago externos, consulta el descargo de responsabilidad de los métodos de pago externos.

Esta guía añade un método de pago externo, Fawry, mediante la guía Aceptar pagos desde la aplicación de Payment Sheet. Consulta la lista de todos los métodos de pago externos disponibles.

Cosas a tener en cuenta

Crea una cuenta de Stripe o inicia sesión.
Sigue el ejemplo de Payment Sheet para completar una integración de pagos.
Para cada método de pago externo que quieras añadir, completa su integración y confirma que funciona en la región en la que quieres habilitarlo.

Añade tipos de métodos de pago externos

Cuando crees tu objeto PaymentSheet.Configuration e inicialices PaymentSheet, especifica los métodos de pago externos que quieres añadir al Payment Element y un controlador para completar el pago. En este ejemplo se añade 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
  }
}

Completa el pago

Cuando el cliente pulsa el botón Compra en PaymentSheet mediante un método de pago externo, llama al controlador con el tipo (por ejemplo, «external_fawry»), los datos de facturación que se han recopilado y un controlador de finalización.

Tu implementación completa el pago (por ejemplo, mediante el SDK de tu proveedor de métodos de pago externos) y llama al controlador de finalización con el siguiente resultado del pago: completed, canceled o failure(error:).

Si pasas .failure(error:), PaymentSheet muestra el error utilizando errorDescription para los errores de Swift y localizedDescription para 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))
    }
}

OpcionalPosiciona los métodos de pago externos

Prueba tu integración

Revisa el flujo del proceso de compra y verifica que el Payment Element muestre Fawry. En este ejemplo se configura Fawry en la segunda posición después de las tarjetas.
Elige el método de pago Fawry.
Haz clic en Paga ahora para probar la integración existente de Fawry. Verifica que tu integración completa la transacción y que cualquier acción posterior al pago (por ejemplo, mostrar una página de confirmación, un mensaje de confirmación o un mensaje de error) sigue funcionando con tu integración de Fawry.

Consideraciones sobre el Dashboard

Los PaymentIntents de las transacciones procesadas con un proveedor de métodos de pago externo tienen el estado incomplete en el Stripe Dashboard. Stripe no participa en transacciones de métodos de pago externos y no puede determinar el estado de estas transacciones.

Si recopilas datos de pago antes de crear un Intent, no verás ninguna transacción incomplete en el Dashboard de Stripe para las transacciones que se procesaron con un proveedor de métodos de pago externo.

Descargo de responsabilidad por los métodos de pago externos

Puedes usar el Mobile Payment Element de Stripe para mostrar algunos métodos de pago externos que no son compatibles con Stripe, pero con los que te integras directamente. Cuando los clientes eligen un método de pago externo, tu aplicación completa la transacción en lugar del Mobile Payment Element de Stripe. Reconoces lo siguiente:

Stripe no ofrece ni acepta métodos de pago externos. El proveedor de métodos de pago externos proporciona el funcionamiento y el soporte de los métodos de pago externos.
Eres responsable de mantener una integración directa con el proveedor de métodos de pago externo.
Tienes que mantener un acuerdo con el proveedor externo de métodos de pago y eres responsable de cumplir con tus acuerdos con cada proveedor de métodos de pago externo.
Eres responsable de obtener todos los derechos necesarios para utilizar las marcas y los logotipos del proveedor de métodos de pago externo en tu proceso de compra, tal y como se describe en esta documentación.
Stripe no es responsable del procesamiento de ninguna transacción con ningún proveedor de métodos de pago externo, lo que incluye, por ejemplo, cargos, reembolsos, disputas, liquidaciones o flujos de fondos.
Tú o el proveedor de métodos de pago externo son responsables de la finalización del flujo de compra después de que un cliente haya elegido un método de pago externo, incluidos, por ejemplo, la confirmación del pedido y la conciliación de pedidos.
Eres responsable de configurar correctamente la URL de redireccionamiento para el método de pago externo.
Debes eliminar inmediatamente los métodos de pago externos en caso de que se rescindan tus acuerdos con cualquier proveedor de métodos de pago externo o Stripe elimine la disponibilidad de un método de pago externo.
Solo se te permite integrar y presentar en el Payment Element los métodos de pago externos enumerados en esta guía.
Eres la única persona responsable de asegurarte de que se redirija correctamente a los compradores al método de pago externo elegido.

Disponibilidad continua de métodos de pago externos

Stripe podría decidir en cualquier momento eliminar la disponibilidad de cualquier método de pago como método de pago externo. Stripe te notificará si elimina alguno de los métodos de pago externos que usas, y deberás eliminar inmediatamente el método de pago externo de tu código. Si no lo haces, el método de pago externo no se mostrará a tus clientes.

Métodos de pago externos disponibles

Puedes mostrar los siguientes métodos de pago externos. Debes usar el tipo de método de pago externo correspondiente en tu código.

Región	Método de pago	Tipo de método de pago externo

AMER	Interac	`external_interac`
APAC	au PAY	`external_au_pay`
APAC	atone	`external_atone`
APAC	Touch’n Go	`external_tng_ewallet`
APAC	ソフトバンクまとめて支払い (Pagos del operador 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`
En todo el mundo	LINE Pay	`external_line_pay`
En todo el mundo	paysafecard	`external_paysafecard`
En todo el mundo	Samsung Pay	`external_samsung_pay`
En todo el mundo	Sezzle	`external_sezzle`
LATAM	Dapp	`external_dapp`
LATAM	PicPay	`external_picpay`
MEA	Tabby	`external_tabby`
MEA	Benefit	`external_benefit`
MEA	Fawry	`external_fawry`