Agrega métodos de pago externos

Agrega métodos de pago externos al Mobile Payment Element.

Nota

Creamos una funcionalidad 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 la integración en lugar de los métodos de pago externos.

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

Responsabilidad de 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 Stripe lo procese. Para conocer tus responsabilidades y la disponibilidad actual de métodos de pago externos, consulta la exención de responsabilidad sobre métodos de pago externos.

Mediante esta guía se agrega un método de pago externo, Fawry, con el ejemplo de la guía Acepta pagos dentro de la aplicación de Payment Sheet. Consulta la lista de todos los métodos de pago externos disponibles.

Antes de comenzar

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

Agrega tipos de métodos de pago externos

Al crear el objeto PaymentSheet.Configuration e inicializar PaymentSheet, especifica los métodos de pago externos que deseas agregar al Payment Element y un controlador para completar el pago. En este ejemplo se agrega 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
  }
}

Completar el pago

Cuando el cliente pulsa el botón Comprar en PaymentSheet mediante un método de pago externo, llama al controlador con el tipo (por ejemplo, “external_fawry”), los detalles de facturación que se recopilaron y un controlador de finalización.

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

Si pasas .failure(error:), PaymentSheet muestra el error usando 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))
    }
}

OpcionalPosicionar métodos de pago externos

Prueba tu integración

Revisa tu flujo 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 de Fawry.
Haz clic en Pagar ahora para probar tu integración existente de Fawry. Verifica que tu integración complete la transacción y que todas las acciones posteriores al pago (por ejemplo, mostrar una página de confirmación, un mensaje de éxito o un mensaje de error) sigan funcionando con tu integración de Fawry.

Consideraciones sobre el Dashboard

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

Si recopilas los 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 sobre los métodos de pago externos

Puedes usar el Payment Element móvil 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 Payment Element móvil de Stripe. Reconoces lo siguiente:

Stripe no ofrece ni acepta métodos de pago externos. El funcionamiento y el soporte de los métodos de pago externos son proporcionados por el proveedor de métodos de pago externo.
Eres responsable de mantener una integración directa con el proveedor de métodos de pago externo.
Debes mantener un acuerdo con el proveedor de métodos de pago externo y eres responsable de cumplir tus acuerdos con cada proveedor de métodos de pago externo.
Eres responsable de obtener todos los derechos necesarios para usar las marcas y los logotipos del proveedor de métodos de pago externo dentro de tu proceso de compra, 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, incluidos, por ejemplo, cargos, reembolsos, disputas, liquidaciones o flujos de fondos.
Tú o el proveedor de métodos de pago externo son responsables de completar el flujo de compra después de que un cliente haya seleccionado un método de pago externo, incluida, por ejemplo, la confirmación del pedido y la conciliación de los pedidos.
Eres responsable de configurar correctamente la URL de redireccionamiento para el método de pago externo.
Debes eliminar de inmediato los métodos de pago externos si se rescinden tus acuerdos con cualquier proveedor de métodos de pago externo o si Stripe elimina 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 el único responsable de asegurar que los compradores sean redirigidos correctamente al método de pago externo elegido.

Disponibilidad continua de métodos de pago externos

Stripe puede decidir en cualquier momento eliminar la disponibilidad de cualquier método de pago como método de pago externo. Stripe te notificará cualquier eliminación de un método de pago externo que estés usando, y deberás eliminar inmediatamente el método de pago externo en tu código. Si no lo haces, el método de pago externo no se entregará 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	ソフトバンクまとめて支払い (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, 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`
Internacional	LINE Pay	`external_line_pay`
Internacional	paysafecard	`external_paysafecard`
Internacional	Samsung Pay	`external_samsung_pay`
Internacional	Sezzle	`external_sezzle`
LATAM	Dapp	`external_dapp`
LATAM	PicPay	`external_picpay`
MEA	Tabby	`external_tabby`
MEA	Benefit	`external_benefit`
MEA	Fawry	`external_fawry`